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 <name> - Create a new CTF map
• /ctf delete <name> - Delete a map
• /ctf list - List all maps and rotation
• /ctf info <name> - View detailed map configuration
• /ctf setmap <name> - Set the current active map
• /ctf setspawn <map> <blue|red> - Set team spawn points
• /ctf setflag <map> <blue|red> - Set flag locations
• /ctf setintermission <map> - Set intermission lobby spawn
• /ctf showborder [map] - Display gold block boundary markers
• /ctf addrotation <map> - Add map to automatic rotation
• /ctf removerotation <map> - Remove map from rotation
• /ctf addpoint <blue|red> <amount> - 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

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 <map> to verify map configuration
• Admin? Use /ctf showborder to visualize boundaries