CollapsePlugin

# ⚔️ CollapsePlugin - Advanced Battle Royale Plugin **The ultimate GUI-based Battle Royale plugin with team support, custom phases, and zero commands needed!** Quick Royale delivers a complete Battle Royale experience for Minecraft servers with an innovative GUI-first approach. Everything from game management to recipe crafting is controlled through intuitive menus - no chat commands required for players! ## ✨ Core Features ### 🎮 **100% GUI Management** - **Compass-based navigation** - Right-click your compass to access everything - **Zero commands for players** - All interactions through beautiful menus - **Admin panel** - Complete server control via GUI - **Game browser** - Visual list of all active games with live status ### 🎯 **Dynamic Phase System** **5 Customizable Game Phases:** - **LOBBY** - Players gather and select teams - **PREPARATION** - Pre-game setup and scenario selection - **PVP** - Main combat phase begins - **DEATHMATCH** - Final showdown in shrinking arena - **END** - Victory celebration and statistics **Per-Phase Rule Control:** - Enable/disable PVP - Allow/block player movement - Block breaking and placing permissions - Crafting access - Potion brewing permissions - Custom phase duration (in seconds) ### 👥 **Team System** - **Configurable team count** - Set max teams in config - **Team selection GUI** - Players choose teams before game starts - **Custom team spawns** - Set spawn points per team (`/collapseadmin setspawn <teamId>`) - **Team coordination** - Perfect for squad-based gameplay - **Color-coded teams** - Easy visual identification ### 🎲 **Built-in Game Scenarios** **UHCCore Mode:** - Random spawn distribution - Border shrinks from game start - Configurable PVP delay timer (in minutes) - Classic UHC-style gameplay **Disable Nether Scenario:** - Blocks Nether portal teleportation - Keep players in the Overworld - Perfect for focused PvP matches **Expandable scenario system** - Easy to add more through `scenarios.yml` ### 🌍 **World Border Management** - **Automatic shrinking** - Border closes in over time - **Phase-based control** - Different border sizes per phase - **UHCCore integration** - Starts shrinking immediately - **Configurable speed** - Set how fast the border contracts - **Damage zones** - Players take damage outside the border ### 🏠 **Lobby System** - **Dedicated lobby spawn** - Set with `/collapseadmin setlobby` - **Auto-teleport** - Players spawn in lobby on join - **Game selection** - Browse and join available games - **Status indicators** - See game states (waiting/active/ended) by color - **Player counts** - Live display of players in each game ### 📜 **Custom Recipe System** **Recipe Book Feature:** - Every player receives a recipe book - Right-click to view all custom crafts - **Visual 3×3 crafting grid** - See exact recipe layouts - **Admin controls** - Shift-click to enable/disable recipes **GUI Recipe Editor:** - "Add Recipe" button opens visual editor - **Drag-and-drop crafting** - Place items in 3×3 grid - Set result item and amount - Save button creates and registers recipe instantly - **Delete recipes** - Admins can remove recipes from preview menu - No file editing required - all through GUI! ### 💀 **Golden Head Mechanic** **Player Head Drops:** - Player heads drop on death - Craft into "Golden Heads" - Customizable recipe via GUI **Golden Head Effects (when eaten):** - Speed I (10 seconds) - Regeneration II (15 seconds) - Absorption (golden hearts) - Strategic healing item for intense battles ### 🎛️ **Game Management** **Compass Menu (Players):** - View game list - See active scenarios - Join available games - Check game status **Compass Menu (Admins):** - Create new game - Start/stop games - Manage games list - Configure scenarios - View statistics - Access settings panel **Game Browser:** - Color-coded status (waiting/preparation/active/ended) - Live player counts - Click to join games in waiting phase - Real-time updates ### ⚙️ **Advanced Configuration** **Config.yml settings:** - Border configuration - Team settings (max teams) - Phase durations - UHCCore parameters - Game rules **Scenarios.yml:** - Scenario descriptions - Enable/disable scenarios - Custom scenario parameters **Crafts.yml:** - Stores custom recipes - Auto-managed through GUI - Backup of all recipes ### 🛠️ **Admin Commands** ``` /collapseadmin compass - Get admin compass /collapseadmin setspawn <teamId> - Set team spawn point /collapseadmin setlobby - Set lobby spawn location ``` ### 📊 **Statistics & Tracking** - Player statistics (coming soon - currently placeholder) - Game history - Per-scenario tracking - Team performance metrics ## 🎯 **Perfect For** - Team-based Battle Royale servers - UHC-style competitive gameplay - Mini-game networks with multiple arenas - Event hosting with custom rules - Tournament organization ## 🔧 **Technical Details** - **Server Software:** Purpur 1.21 - 1.21.5 - **Java Version:** 21+ - **Lightweight:**