CookieCTF

About

CookieCTF is a powerful yet easy-to-use capture the flag plugin for Minecraft servers. It supports multiple teams (up to 9), fully customizable team colors, and dynamic flag management. The game features protected flag areas, automatic flag recovery, and match-specific announcements. CookieCTF is designed to be simple to set up while offering extensive customization options for server administrators.

Key features include:
- Support for up to 9 customizable teams
- Ability to enable/disable teams as needed
- Flexible flag placement and management
- Team captain system with bonus health
- Customizable game timers and settings
- Death drop customization
- Broadcast controls for game alerts
- Optional PlaceholderAPI integration

PlaceholderAPI Support

If PlaceholderAPI is installed on your server, CookieCTF provides the following placeholders:

| Placeholder | Description | Example |
|------------|-------------|---------|
| `%cookiectf_leading_team%` | Shows the team with the highest score | "Red" |
| `%cookiectf_losing_team%` | Shows the team with the lowest score | "Blue" |
| `%cookiectf_team%` | Shows the player's team color code | "§9" |
| `%cookiectf_team_kills%` | Shows the player's team kills | "5" |
| `%cookiectf_team_deaths%` | Shows the player's team deaths | "3" |
| `%cookiectf_status%` | Shows the game status | "running" or "offline" |
| `%cookiectf_time_remaining%` | Shows minutes until game end | "10" |
| `%cookiectf_player_team%` | Shows the player's team name | "Red" |
| `%cookiectf_player_captain%` | Shows if the player is a team captain | "true" or "false" |
| `%cookiectf_player_team_score%` | Shows the score of the player's team | "5" |
| `%cookiectf_[color]_score%` | Shows the score for a specific team color | "5" |

Note: For the color-based score placeholder, replace `[color]` with the team color (e.g., `%cookiectf_red_score%` or `%cookiectf_blue_score%`).

Usage

| Command | Description |
| /ccpanel | Main game setup. Only op or users with the permission `CookieCTF.admin` can use this command |

| /ccteam | Shows team menu for players to join teams |
| /ccmatch | Opens the match control panel. Only op or users with the permission `CookieCTF.match` can use this command |

GUI Screenshots

Main Setup Panel

Team Selection Menu


Match Control Panel


Flag and Team Panel


Settings Configuration

Settings Documentation

Game Settings
- Pregame Timer: Customizable time for resource collection before game start
- Game Timer: Duration of the main game
- Clear Inventory: Toggle inventory clearing on game state changes
- Death Timer: Customizable respawn delay
- Death Drops: Configure which items are dropped on player death
- Team Chestplates: Enable/disable colored team chestplates
- Broadcast Alerts: Control whether game alerts (flag captures, steals, etc.) are broadcast to all players or only match participants

Team Settings
- Multi-Team Support: Create and manage up to 9 teams with unique colors
- Enable/Disable Teams: Easily enable or disable teams as needed for different game scenarios
- Team Captains: Enable/disable team captains
- Captain Extra Health: Configure bonus health for team captains
- Team Colors: Customize the colors for all teams

Flag Management
- **Flag Protection Area**: 3x3 unbreakable area around flag
- **Flag Carrier Effects**: potion effects applied to flag carriers

Team & Flag Management

The Flag & Team Management panel allows server administrators to:
- Enable or disable teams (right-click on team slots)
- Set flag locations (left-click on team slots)
- Change team colors (shift + left-click on team slots)
- Reset flag locations (shift + right-click on team slots)

Teams must be enabled and have a flag location set to be active in the game. Disabled teams will not appear in the scoreboard and players cannot join them.

Match Control Panel

The match control panel (`/ccmatch`) provides a simplified interface for starting games and managing teams. It includes:

- Start Game Button: Starts the game if all requirements are met
- Team Selection Button: Opens the team selection menu and allows starting team selection
- Leave Team Button: Allows players to leave their current team
- Refresh Button: Updates the panel with current game information

The panel shows:
- Current team counts
- Current team selection status

Players with the `CookieCTF.team` permission can start team selection from this panel.

Installation

1. Download the latest release from the SpigotMC site
2. Place the plugin JAR in your server's `plugins` folder
3. Restart your server
4. Use `/ccpanel` to begin setup

Permissions

| Permission | Description |
| :-------- | :------------------------- |
| `CookieCTF.admin` | Access to the admin panel (`/ccpanel`) |
| `CookieCTF.team` | Ability to start team selection |
| `CookieCTF.match` | Access to the match control panel (`/ccmatch`) |

Contributing

Feel free to contribute by: (Discord server link: https://discord.gg/492Epwam4T)
1. Reporting bugs in our discord
2. Suggesting new features in our discord

Support

If you need help with setup or encounter any issues, please: (Discord server link: https://discord.gg/492Epwam4T)
1. Join our Discord server
2. Create a new bug report with detailed information