Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
Licensed MIT
Published 10 months ago
๐ณ๏ธ EasyCTF - Minecraft CTF Plugin
Strategic CTF Plugin for Minecraft Paper Servers
๐ Overview
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.
โจ Key Features
- ๐ฎ Multiple Concurrent Games - Run multiple CTF games simultaneously on the same server
- ๐ก๏ธ Shield System - Take damage in enemy territory, recover only in your own
- ๐ Shop System - Team-shared currency for strategic item purchases
- ๐ Match System - Multiple rounds to determine overall winner
- ๐ Multi-language - Full support for Japanese and English
- ๐ Event Chests - Special rewards during combat phase
๐ฏ Game Phases
1๏ธโฃ Build Phase (2 minutes)
- Place blocks for defense and offense
- No PvP (combat disabled)
- Shop available for purchases
- Cannot enter enemy territory
- Instant respawn (no delay)
2๏ธโฃ Combat Phase (2 minutes)
- Main CTF gameplay
- PvP enabled
- Capture enemy flags
- Shop available anywhere (right-click emerald)
- Instant respawn (no delay)
3๏ธโฃ Strategy Phase (15 seconds)
- View round results
- Prepare for next round
- Transitions immediately to next phase
๐ Shop System
Right-click emerald to open shop (usable anywhere)
Categories
- Weapons - Swords, axes, bows, etc.
- Armor - Various armor sets
- Consumables - Ender pearls, golden apples, arrows
- Building Blocks - Various blocks, TNT
Currency Earning
- Initial funds: 50G
- Kill reward: 15G (Flag carrier: 25G)
- Kill assist: 10G
- Capture: 50G
- Assist: 20G
- Phase end bonus: 100G
- Kill streak bonus: 5G-20G
Discount System
Discounts for losing team based on score difference:
- 1 point behind: 10% off
- 2 points behind: 20% off
- 3 points behind: 30% off
- 4+ points behind: 40% off
๐ก๏ธ Special Systems
Shield System
- Maximum: 100
- Decreases by 2/sec on enemy blocks/beacon area
- 1.5 damage/sec when shield is 0
- Recovers 5/sec only in own territory (important tactical element)
- Warning: Below 40 warning, below 20 critical
Beacon Area Effects
- 3x3 area is special zone
- Enemy: Damage zone (shield decrease)
- Ally: Hunger & shield recovery
Team Block System
- Red Team: Red concrete only
- Blue Team: Blue concrete only
- Block connection required (neutralizes when disconnected)
- Unlimited usage
Event Chests
- Appear once during combat phase
- Obtain expensive shop items
- Notification to all players
๐บ๏ธ Map Creation
Auto-Detection Method (Recommended)
-
Build Map
- Red concrete: Red team spawn (multiple allowed)
- Blue concrete: Blue team spawn (multiple allowed)
- Beacon + Red glass: Red team flag
- Beacon + Blue glass: Blue team flag
-
Set Region
/ctf setpos1 game1 # Set first corner /ctf setpos2 game1 # Set second corner -
Save
/ctf savemap game1 # Auto-detect and save
Temporary World System
- Dedicated world generated at game start
- Map automatically restored
- Chest contents automatically cleared
- World deleted at game end
๐ Admin Commands
| Command | Description |
|---|---|
/ctf create <game> |
Create new game (interactive) |
/ctf update <game> |
Update game settings |
/ctf delete <game> |
Delete game |
/ctf list |
List all games |
/ctf info <game> |
Game details |
/ctf start <game> [match] [count] |
Start game/match |
/ctf stop <game> |
Force stop |
/ctf setflag <game> <team> |
Set flag position |
/ctf setspawn <game> <team> |
Set spawn |
/ctf addspawn <game> <team> |
Add spawn |
/ctf removespawn <game> <team> <number> |
Remove spawn |
๐ฎ Player Commands
| Command | Description |
|---|---|
/ctf join <game> |
Join game |
/ctf leave |
Leave current game |
/ctf team [red/blue] |
Check/change team |
/ctf spectator <game> |
Join as spectator |
/ctf status [game] |
Game status |
โ๏ธ Configuration
Main configuration file: config.yml
# Language setting
language: "en" # "en" or "ja"
# Phase durations
default-phases:
build-duration: 120 # Build phase (seconds)
combat-duration: 120 # Combat phase (seconds)
result-duration: 15 # Result display (seconds)
build-phase-gamemode: "SURVIVAL" # ADVENTURE/SURVIVAL/CREATIVE
# Respawn settings
default-game:
respawn-delay-base: 0 # Instant respawn
respawn-delay-per-death: 0
respawn-delay-max: 0
# Currency settings
currency:
initial: 50 # Initial currency
kill-reward: 15 # Kill reward
kill-assist-reward: 10 # Kill assist reward
carrier-kill-reward: 25 # Flag carrier kill
carrier-kill-assist-reward: 10 # Flag carrier kill assist
capture-reward: 50 # Capture reward
capture-assist-reward: 20 # Capture assist reward
phase-end-bonus: 100 # Phase end bonus
kill-streak-bonus: # Kill streak bonus
2-kills: 5
3-kills: 10
4-kills: 15
5-plus-kills: 20
# Shield settings
shield:
enabled: true
max-shield: 100
decrease-rate: 2.0 # Decrease rate in enemy territory
recovery-rate: 5.0 # Recovery rate in own territory
damage-amount: 1.5 # Damage when shield is 0
# Event chest
event-chest:
enabled: true
spawn-count: 1 # Spawns during combat phase
๐ง Build Instructions
git clone https://github.com/0x48lab/easy_ctf.git
cd easy_ctf
./gradlew shadowJar
Generated JAR file: build/libs/easy_ctf-x.x.x-all.jar
๐ Release Notes
Latest Changes
- โ Removed intervals between phases (instant transition)
- โ Set respawn delay to 0 (instant respawn)
- โ Adjusted currency rewards (Kill 15G, Flag carrier kill 25G, Capture 50G, Phase bonus 100G)
- โ Limited shield recovery to own territory only
- โ Removed shop usage range restriction (usable anywhere)
- โ Unified team blocks to concrete only
- โ Beacon area becomes damage zone
- โ Event chest contents limited to shop items
- โ Distance-based flag detection algorithm
Performance Optimizations
- Batch teleport processing
- Asynchronous chat processing
- Efficient block connection checking
- GZIP compression for map storage
๐ค Contributing
Pull requests are welcome! Report bugs and suggest features in Issues.
๐ Support
๐ License
This project is released under the MIT License.
Made with โค๏ธ for Minecraft Community