# \ud83c\udff3\ufe0f EasyCTF – Minecraft CTF Plugin<\/p>\n
\n
\n
\n<\/p>\n
**Strategic CTF Plugin for Minecraft Paper Servers**<\/p>\n<\/div>\n
## \ud83d\udcd6 Overview<\/p>\n
EasyCTF is a feature-rich Capture The Flag plugin for Minecraft Paper servers. Two teams (Red and Blue) compete to capture each other’s flags while defending their own.<\/p>\n
### \u2728 Key Features
\n– \ud83c\udfae **Multiple Concurrent Games** – Run multiple CTF games simultaneously on the same server
\n– \ud83d\udee1\ufe0f **Shield System** – Take damage in enemy territory, recover only in your own
\n– \ud83d\udc8e **Shop System** – Team-shared currency for strategic item purchases
\n– \ud83c\udfc6 **Match System** – Multiple rounds to determine overall winner
\n– \ud83c\udf0d **Multi-language** – Full support for Japanese and English
\n– \ud83c\udf81 **Event Chests** – Special rewards during combat phase<\/p>\n
## \ud83c\udfaf Game Phases<\/p>\n
### 1\ufe0f\u20e3 Build Phase (2 minutes)
\n– Place blocks for defense and offense
\n– No PvP (combat disabled)
\n– Shop available for purchases
\n– Cannot enter enemy territory
\n– Instant respawn (no delay)<\/p>\n
### 2\ufe0f\u20e3 Combat Phase (2 minutes)
\n– Main CTF gameplay
\n– PvP enabled
\n– Capture enemy flags
\n– Shop available anywhere (right-click emerald)
\n– Instant respawn (no delay)<\/p>\n
### 3\ufe0f\u20e3 Strategy Phase (15 seconds)
\n– View round results
\n– Prepare for next round
\n– Transitions immediately to next phase<\/p>\n
## \ud83d\udc8e Shop System<\/p>\n
Right-click emerald to open shop (**usable anywhere**)<\/p>\n
### Categories
\n– **Weapons** – Swords, axes, bows, etc.
\n– **Armor** – Various armor sets
\n– **Consumables** – Ender pearls, golden apples, arrows
\n– **Building Blocks** – Various blocks, TNT<\/p>\n
### Currency Earning
\n– Initial funds: 50G
\n– Kill reward: 15G (Flag carrier: 25G)
\n– Kill assist: 10G
\n– Capture: 50G
\n– Assist: 20G
\n– Phase end bonus: 100G
\n– Kill streak bonus: 5G-20G<\/p>\n
### Discount System
\nDiscounts for losing team based on score difference:
\n– 1 point behind: 10% off
\n– 2 points behind: 20% off
\n– 3 points behind: 30% off
\n– 4+ points behind: 40% off<\/p>\n
## \ud83d\udee1\ufe0f Special Systems<\/p>\n
### Shield System
\n– Maximum: 100
\n– Decreases by 2\/sec on enemy blocks\/beacon area
\n– 1.5 damage\/sec when shield is 0
\n– **Recovers 5\/sec only in own territory** (important tactical element)
\n– Warning: Below 40 warning, below 20 critical<\/p>\n
### Beacon Area Effects
\n– 3×3 area is special zone
\n– Enemy: Damage zone (shield decrease)
\n– Ally: Hunger & shield recovery<\/p>\n
### Team Block System
\n– **Red Team**: Red concrete only
\n– **Blue Team**: Blue concrete only
\n– Block connection required (neutralizes when disconnected)
\n– Unlimited usage<\/p>\n
### Event Chests
\n– Appear once during combat phase
\n– Obtain expensive shop items
\n– Notification to all players<\/p>\n
## \ud83d\uddfa\ufe0f Map Creation<\/p>\n
### Auto-Detection Method (Recommended)<\/p>\n
1. **Build Map**
\n – Red concrete: Red team spawn (multiple allowed)
\n – Blue concrete: Blue team spawn (multiple allowed)
\n – Beacon + Red glass: Red team flag
\n – Beacon + Blue glass: Blue team flag<\/p>\n
2. **Set Region**
\n “`bash
\n \/ctf setpos1 game1 # Set first corner
\n \/ctf setpos2 game1 # Set second corner
\n “`<\/p>\n
3. **Save**
\n “`bash
\n \/ctf savemap game1 # Auto-detect and save
\n “`<\/p>\n
### Temporary World System
\n– Dedicated world generated at game start
\n– Map automatically restored
\n– Chest contents automatically cleared
\n– World deleted at game end<\/p>\n
## \ud83d\udcca Admin Commands<\/p>\n
| Command | Description | ## \ud83c\udfae Player Commands<\/p>\n | Command | Description | ## \u2699\ufe0f Configuration<\/p>\n Main configuration file: `config.yml`<\/p>\n “`yaml # Phase durations # Respawn settings # Currency settings # Shield settings # Event chest ## \ud83d\udd27 Build Instructions<\/p>\n “`bash Generated JAR file: `build\/libs\/easy_ctf-x.x.x-all.jar`<\/p>\n ## \ud83d\udcdd Release Notes<\/p>\n ### Latest Changes ### Performance Optimizations ## \ud83e\udd1d Contributing<\/p>\n Pull requests are welcome! Report bugs and suggest features in Issues.<\/p>\n ## \ud83d\udcde Support<\/p>\n – \ud83d\udcda docs ## \ud83d\udcc4 License<\/p>\n This project is released under the MIT License.<\/p>\n —<\/p>\n Highly customizable Capture The Flag plugin for Paper servers with shop Extended Summary<\/p>\n EasyCTF – Advanced Capture The Flag Plugin for Minecraft<\/p>\n Transfor<\/p>\n","protected":false},"featured_media":60753,"template":"","meta":{"_minecraft_slug":"easy-ctf","_minecraft_project_id":"hHd2ppwp","_minecraft_author":"yokmama","_minecraft_license":"MIT","_minecraft_downloads":405,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"easy-ctf.zip","_minecraft_size_bytes":7926306,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-16T10:58:11.348513Z","_minecraft_date_created":"2025-08-01T04:00:47.553548Z","_minecraft_date_modified":"2025-11-04T08:09:34.210655Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/easy-ctf","_minecraft_icon_attachment_id":60753,"_minecraft_imported_at":"2026-06-03T12:57:11+00:00","_minecraft_import_hash":"64c55d91069f91201f506e03d6f4ff14","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,866,127],"mod_loader":[132],"minecraft_version":[845,846,847,848,849,59,36,60,93,94,101,102,62,37,73,74,38,78],"class_list":["post-60752","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-minigame","mod_category-paper","mod_loader-paper","minecraft_version-1-2-1","minecraft_version-1-2-2","minecraft_version-1-2-3","minecraft_version-1-2-4","minecraft_version-1-2-5","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5"],"yoast_head":"\n
\n|———|————-|
\n| `\/ctf create
\n| `\/ctf update
\n| `\/ctf delete
\n| `\/ctf list` | List all games |
\n| `\/ctf info
\n| `\/ctf start
\n| `\/ctf stop
\n| `\/ctf setflag
\n| `\/ctf setspawn
\n| `\/ctf addspawn
\n| `\/ctf removespawn
\n|———|————-|
\n| `\/ctf join
\n| `\/ctf leave` | Leave current game |
\n| `\/ctf team [red\/blue]` | Check\/change team |
\n| `\/ctf spectator
\n| `\/ctf status [game]` | Game status |<\/p>\n
\n# Language setting
\nlanguage: “en” # “en” or “ja”<\/p>\n
\ndefault-phases:
\n build-duration: 120 # Build phase (seconds)
\n combat-duration: 120 # Combat phase (seconds)
\n result-duration: 15 # Result display (seconds)
\n build-phase-gamemode: “SURVIVAL” # ADVENTURE\/SURVIVAL\/CREATIVE<\/p>\n
\ndefault-game:
\n respawn-delay-base: 0 # Instant respawn
\n respawn-delay-per-death: 0
\n respawn-delay-max: 0<\/p>\n
\ncurrency:
\n initial: 50 # Initial currency
\n kill-reward: 15 # Kill reward
\n kill-assist-reward: 10 # Kill assist reward
\n carrier-kill-reward: 25 # Flag carrier kill
\n carrier-kill-assist-reward: 10 # Flag carrier kill assist
\n capture-reward: 50 # Capture reward
\n capture-assist-reward: 20 # Capture assist reward
\n phase-end-bonus: 100 # Phase end bonus
\n kill-streak-bonus: # Kill streak bonus
\n 2-kills: 5
\n 3-kills: 10
\n 4-kills: 15
\n 5-plus-kills: 20<\/p>\n
\nshield:
\n enabled: true
\n max-shield: 100
\n decrease-rate: 2.0 # Decrease rate in enemy territory
\n recovery-rate: 5.0 # Recovery rate in own territory
\n damage-amount: 1.5 # Damage when shield is 0<\/p>\n
\nevent-chest:
\n enabled: true
\n spawn-count: 1 # Spawns during combat phase
\n“`<\/p>\n
\ngit clone https:\/\/github.com\/0x48lab\/easy_ctf.git
\ncd easy_ctf
\n.\/gradlew shadowJar
\n“`<\/p>\n
\n– \u2705 Removed intervals between phases (instant transition)
\n– \u2705 Set respawn delay to 0 (instant respawn)
\n– \u2705 Adjusted currency rewards (Kill 15G, Flag carrier kill 25G, Capture 50G, Phase bonus 100G)
\n– \u2705 Limited shield recovery to own territory only
\n– \u2705 Removed shop usage range restriction (usable anywhere)
\n– \u2705 Unified team blocks to concrete only
\n– \u2705 Beacon area becomes damage zone
\n– \u2705 Event chest contents limited to shop items
\n– \u2705 Distance-based flag detection algorithm<\/p>\n
\n– Batch teleport processing
\n– Asynchronous chat processing
\n– Efficient block connection checking
\n– GZIP compression for map storage<\/p>\n
\n– \ud83d\udcda wiki<\/p>\n
\n system, match mode, and multi-language support<\/p>\n