# CactusFFA A free-for-all (FFA) plugin built for practice servers ## Features - **Kit System** -- Create kits from your inventory, set icons, rename, assign breakable block whitelists - **Per-Kit Rules** -- Toggle saturation regen, hunger drain, item drops on death, block placement/breaking, and lobby-on-death per kit - **Arena System** -- Define arena boundaries and spawn points, enable/disable per arena, bind arenas to kits - **Auto Cleanup** -- Track every block placed or broken in arenas and restore them on a configurable timer (default: 30 min) - **FFA GUI** -- Players browse and join kits through a customizable GUI - **Fully Configurable** -- All messages, GUI layout, cleanup interval, and leave commands are configurable in YAML ## Commands ### Player Commands | Command | Permission | Description | |---------|-----------|-------------| | `/ffa` | `cactusffa.use` | Open the FFA GUI to join a kit-based arena | | `/leaveffa` | `cactusffa.use` | Leave the current FFA and return to lobby | | `/lobby` | `cactusffa.use` | Teleport to the lobby | ### Admin Commands (`cactusffa.admin`) All admin commands use `/cactusffa` or `/cffa`. #### Kit Management | Command | Description | |---------|-------------| | `/cffa kit create ` | Create a kit from your current inventory | | `/cffa kit setinv ` | Update a kit's inventory | | `/cffa kit load ` | Preview a kit's inventory | | `/cffa kit icon ` | Set the kit's GUI icon | | `/cffa kit rename ` | Rename a kit's display name | | `/cffa kit editor ` | Open the kit editor GUI (toggle rules, icon, enable) | | `/cffa kit breakableblocks add\|remove\|list [material]` | Manage whitelisted breakable blocks | | `/cffa kit arena ` | Assign an arena to a kit (or `none` to clear) | #### Arena Management | Command | Description | |---------|-------------| | `/cffa arena create ` | Create a new arena | | `/cffa arena enable ` | Enable or disable an arena | | `/cffa arena corner1 ` | Set corner 1 of the arena boundary | | `/cffa arena corner2 ` | Set corner 2 of the arena boundary | | `/cffa arena spawn ` | Set the arena spawn point | | `/cffa arena rename ` | Rename an arena | | `/cffa arena tp ` | Teleport to the arena's spawn | #### Other | Command | Description | |---------|-------------| | `/cffa setlobby` | Set the lobby to your current position | ## Kit Rules Each kit has configurable rules toggled via the kit editor GUI or `kits.yml`: | Rule | Effect When Enabled | |------|-------------------| | `saturation` | Disables natural saturation-based health regen | | `hunger` | Disables hunger drain | | `drop-items` | Allows items to drop on death | | `death-lobby` | Sends player to lobby on death instead of respawning | | `break-blocks` | Allows players to break blocks | | `place-blocks` | Allows players to place blocks | ## Permissions | Permission | Default | Description | |-----------|---------|-------------| | `cactusffa.admin` | `op` | Full admin access to all `/cffa` commands | | `cactusffa.use` | `true` | Access to `/ffa`, `/leaveffa`, `/lobby` | ## Configuration ### `config.yml` ```yaml lobby: null # Lobby location (set via /cffa setlobby) lobby-command: true # Enable /lobby command ffa-leave-commands: [] # Commands to run when players leave FFA ({player} placeholder) cleanup-duration: 30 # Arena block cleanup interval in minutes (0 = disable) ``` ### `messages.yml` All user-facing messages are customizable with color codes (`&`) and placeholders (`{kit}`, `{arena}`, `{block}`, `{name}`, `{player}`). ### `guis/ffa.yml` Configure the FFA selection GUI: title, rows, filler item, kit display name/lore, and kit slot mapping.

CuteeCactus