# TrajCakeWars **A fully standalone Cake Wars 1v1 minigame engine for Spigot, Paper, Purpur, and all Spigot-based forks.** Two players fight to eat the opponent's cake; seven bites to destroy it, one second cooldown between each. As long as your cake stands, you respawn. Once it's gone, your next death is final. Every match runs in its own isolated temporary world, cloned from a template and automatically deleted after the game. No leftover files, no manual cleanup. --- ## Why TrajCakeWars? - **Zero dependencies** -> drop the JAR and go. No libraries, no APIs, no setup headaches. - **Works on any server** -> SMP, minigame network, or dedicated. Inventory save/restore means your survival players keep their stuff. - **Compatible with everything** -> Citizens, ZNPCs, FancyNpcs, Vault, LuckPerms, TAB, or just a renamed villager. The plugin doesn't care. - **Fully configurable** -> every shop item, every price, every reward, every message. One config.yml controls it all. - **Production-ready** -> battle-tested with custom death system (no vanilla death screen), command blocking during games, unbreakable items, and map protection. --- ## Features **Gameplay** - 1v1 Cake Wars with eat-to-destroy cake mechanic (right-click, 7 slices, 1s cooldown) - Config-driven Items & Blocks shops with auto-equip swords and armor tiering - Iron and Diamond resource generators with configurable intervals and ground caps - TNT and explosions only destroy player-placed blocks -> original map terrain is protected - All game items are unbreakable -> no durability loss mid-fight - Pre-game freeze countdown with title display - Custom death system -> spectator mode respawn, no vanilla death screen ever **Matchmaking** - Three queue types: quick play (random map), map-specific, and private sessions - Private sessions with 6-character invite codes - Cross-queue matching for faster games - Clean GUI menu for all player actions **Server Integration** - Full inventory save and restore — armor, offhand, XP, health, food, gamemode - Command blocking during games with configurable whitelist - Precise lobby return point (no more void falls) - Per-game world cloning and automatic cleanup **Admin Tools** - In-game GUI admin panel - `/cw tp ` to teleport into templates for setup - Full command suite with tab-completion - Arena creation, deletion (with confirmation), and configuration - Template management with `/cw savetemplate` --- ## Quick Start **1. Install** Drop `TrajCakeWars.jar` into `plugins/` and start the server. **2. Prepare your map** Build a CakeWars map with two islands, cakes, and bridges. Place villagers named "Items Shop" and "Blocks Shop" on each island. Copy the world folder to `cw_templates/` at the server root, or use `/cw savetemplate ` in-game. **3. Configure the arena** ``` /cw create myarena /cw tp myarena /cw set myarena spawn1 — player 1 spawn /cw set myarena spawn2 — player 2 spawn /cw set myarena cake1 — player 1 cake block /cw set myarena cake2 — player 2 cake block /cw set myarena gen1 — iron generator island 1 /cw set myarena gen2 — iron generator island 2 /cw set myarena diamond — diamond generator (repeat for each) /cw set myarena lobby — spectator/waiting point /cw settemplate myarena myarena /cw back /cw setlobby — stand where players return after games /cw enable myarena /cw save ``` **4. Play** Players use `/cw` to open the menu, or click a lobby NPC. Two players in the queue → match starts → temporary world cloned → game plays → winner gets rewards → both return to lobby → world deleted. --- ## Commands | Command | Description | |---|---| | `/cw` | Open main menu | | `/cw join` | Join matchmaking queue | | `/cw join

` | Join private session |
| `/cw private ` | Create private session |
| `/cw leave` | Leave queue or game |
| `/cw tp ` | Teleport into template (admin) |
| `/cw back` | Return to lobby (admin) |
| `/cw setlobby` | Set lobby return point (admin) |
| `/cw create/delete ` | Create or delete arena (admin) |
| `/cw set  ` | Set arena config point (admin) |
| `/cw enable ` | Enable arena (admin) |
| `/cw save` | Save config (admin) |
| `/cw admin` | Open admin GUI (admin) |

---

## Permissions

| Permission | Default | Description |
|---|---|---|
| `cakewars.play` | true | Use /cw, join queues, play games |
| `cakewars.admin` | op | Arena management, admin GUI, bypass command blocking |

---

## Compatibility

**Server:** Spigot, Paper, Purpur, Pufferfish, and all Spigot-based forks (1.21+)
**Not compatible:** Folia, Fabric, Forge, Sponge

**NPC plugins:** Citizens, ZNPCs, FancyNpcs, ZNPCsPlus, or vanilla villagers
**Economy:** Vault, EssentialsX (for reward commands)
**Other:** LuckPerms, TAB, and any plugin that doesn't conflict with world management

---

## Configuration

Everything is in one `config.yml`:
- Shop items (material, price, currency, amount, lore, type)
- Generator intervals and ground caps
- Victory/defeat rewards with console commands (`%winner%`, `%loser%`, `%arena%`)
- NPC detection keywords
- Command whitelist during games
- Inventory save toggle
- Game parameters (countdown, respawn time, max duration)

Full documentation: https://hashk014.github.io/Trajcakewars-doc/

---

## Support

Found a bug? Have a feature request? Open an issue on the GitHub repository or reach out on Discord : hash_014

---

*Built by TrajStudio — ~2400 lines of code, 17 source files, zero dependencies.*
*© 2026 TrajStudio. All rights reserved.*

hashkv12