BKCTF

# BKCTF # BKCTF - Capture The Flag Plugin A feature-rich, team-based Capture the Flag minigame plugin for Minecraft servers inspired by old school Capture The Flag servers. ## Overview BKCTF brings classic CTF gameplay to your Minecraft server with polished mechanics, multiple map support, and extensive customization options. Players compete in intense 15-minute matches across custom-built arenas, choosing from specialized kits to help their team capture the enemy flag while defending their own. ## Key Features ### Core Gameplay - **Team-Based Combat**: Red vs Blue team competition with automatic team balancing - **15-Minute Matches**: Fast-paced games with intermission between rounds - **Flag Mechanics**: Capture enemy flags, defend your own, with automatic flag return system (30 seconds) - **Respawn System**: 5-second respawn timer to keep the action flowing - **Map Rotation**: Support for unlimited custom maps with automatic cycling ### Map System - **Multiple Maps**: Create and manage unlimited CTF arenas - **Map Rotation**: Automatic cycling between configured maps - **Boundary Protection**: Gold block borders mark arena boundaries - **Per-Map Configuration**: Each map stores its own spawns, flags, and boundaries - **BKMinigames Wand Integration**: Use `/mg wand` for easy boundary selection ### Three Unique Kits **Warrior Kit** - Diamond Sword for close combat - Iron armor with Protection I - 16 Cooked Beef **Archer Kit** - Infinity Bow with Power I - Long-range combat specialist - 16 Cooked Beef **Scout Kit** - Speed III permanent effect - Perfect for flag running - 16 Cooked Beef ### Statistics and Progression - **Player Stats**: Kills, deaths, K/D ratio, flag captures, wins/losses, win rate - **Leaderboards**: Track top players by kills, captures, K/D, or wins - **Persistent Storage**: All stats saved across server restarts - **Per-Game Tracking**: Individual match statistics ### Visual Features - **Team Identification**: Colored leather helmets (blue/red) - **Flag Carriers Glow**: Glowing effect on players carrying flags - **Custom Scoreboard**: Real-time game information display - **Title Notifications**: Flag captures, scores, and countdowns - **Sound Effects**: Immersive audio feedback for game events ### Economy Integration - **Vault Support**: Optional economy rewards for winners - **$250 Reward**: Automatic payment to winning team players - **Configurable**: Works with any Vault-compatible economy plugin ### Admin Tools - **Easy Setup**: Step-by-step map creation process - **Boundary Visualization**: Gold block borders for arena limits - **Live Map Management**: Create, delete, and switch maps without restart - **Debug Commands**: Admin point addition for testing - **Flexible Configuration**: YAML-based storage for all settings ## Commands ### Player Commands - `/ctf join` - Join the CTF game with kit selection GUI - `/ctf leave` - Leave the game and restore inventory - `/ctf kit` - Change your kit (respawns you) - `/ctf changeteam` - Switch to the opposite team - `/ctf stats [player]` - View your stats or another player's - `/ctf leaderboard [category]` - View leaderboards (kills/captures/kdr/wins) ### Admin Commands Requires `ctf.admin` permission: - `/ctf create ` - Create a new CTF map - `/ctf delete ` - Delete a map - `/ctf list` - List all maps and rotation - `/ctf info ` - View detailed map configuration - `/ctf setmap ` - Set the current active map - `/ctf setspawn ` - Set team spawn points - `/ctf setflag ` - Set flag locations - `/ctf setintermission ` - Set intermission lobby spawn - `/ctf showborder [map]` - Display gold block boundary markers - `/ctf addrotation ` - Add map to automatic rotation - `/ctf removerotation ` - Remove map from rotation - `/ctf addpoint ` - Manually add points (testing) ## Setup Guide ### Initial Configuration **1. Install the Plugin** - Place `BKCTF.jar` in your `plugins` folder - Restart the server - Optional: Install Vault + economy plugin for rewards **2. Create Your First Map** ``` /ctf create MyArena ``` **3. Set Map Boundaries** (Two Options) **Option A: Using BKMinigames Wand** (Recommended) ``` /mg wand (Left-click first corner, right-click second corner) /ctf create MyArena ``` **Option B: Manual Point Selection** ``` (Stand at first corner) /ctf setpoint MyArena 1 (Stand at opposite corner) /ctf setpoint MyArena 2 ``` **4. Configure Spawns and Flags** ``` /ctf setspawn MyArena blue /ctf setspawn MyArena red /ctf setflag MyArena blue /ctf setflag MyArena red /ctf setintermission MyArena ``` **5. Add to Rotation** ``` /ctf addrotation MyArena /ctf setmap MyArena ``` **6. Verify Setup** ``` /ctf info MyArena /ctf showborder MyArena ``` ### Creating Additional Maps Repeat steps 2-5 for each new map. Maps automatically cycle after each game based on rotation order. ## Permissions | Permission | Description | Default | |------------|-------------|---------| | `ctf.player` | All player commands | true | | `ctf.join` | Join games | true | | `ctf.leave` | Leave games | true | | `ctf.kit` | Change kits | true | | `ctf.changeteam` | Switch teams | true | | `ctf.admin` | All admin commands | op | | `ctf.bypass` | Bypass CTF restrictions | op | ## Integration ### BKMinigames Hub BKCTF automatically integrates with BKMinigames hub if present: - Appears in hub GUI - Uses hub wand for boundary selection - Registers as "Capture The Flag" minigame - Supports 4-20 players ### Vault Economy If Vault is installed with an economy provider: - Winners receive $250 per player - Automatic payment on game end - Works with any Vault-compatible economy ## Game Mechanics ### Team Balancing - Teams cannot differ by more than 2 players - Auto-balancing on join - Players notified if switched ### Flag System - Touch enemy flag to capture - Return to your base to score - Dropped flags return after 30 seconds - Flag carriers receive glowing effect - Cannot break/place blocks while carrying ### Respawn System - 5-second respawn delay after death - Countdown timer displayed - Spawn at team base - Kit automatically restored ### Boundary System - Gold blocks mark arena edges - Players pushed back if attempting to leave - Y-axis unlimited (full height) - Warning message on boundary contact ### Game Flow 1. **Intermission** (60 seconds) - Players join, intermission lobby 2. **Active Game** (15 minutes) - Flag capture gameplay 3. **Game End** - Winner announced, stats recorded 4. **Map Cycle** - Automatically load next map in rotation 5. **Return to Intermission** ## Configuration Files **maps.yml** Stores all map configurations, boundaries, spawns, flags, and rotation order. **stats.yml** Persistent player statistics storage. **config.yml** Plugin configuration (auto-generated). ## Requirements - **Minecraft Version**: 1.21+ - **Java**: 17+ - **Soft Dependencies**: - Vault (optional, for economy) - BKMinigames (optional, for hub integration) ## Support and Feedback For issues, suggestions, or questions: - Check `/ctf` in-game for command help - Use `/ctf info ` to verify map configuration - Admin? Use `/ctf showborder` to visualize boundaries