⚔️ 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: Optimized performance
• No dependencies required
• Localization ready: Easy translation support

📦 Quick Start

1. Download and place in plugins folder
2. Restart server
3. Set lobby: /collapseadmin setlobby
4. Set team spawns: /collapseadmin setspawn 1, /collapseadmin setspawn 2, etc.
5. Players use compass to join games
6. Admins use compass to create and manage games
7. Customize scenarios and recipes through GUI!

🌟 Why Choose Quick Royale?

✅ No command memorization - Everything in GUI
✅ Team support - Not just FFA
✅ Custom phases - Design your perfect game flow
✅ Recipe editor - Add custom items without coding
✅ Multiple games - Run several matches simultaneously
✅ UHC mode - Classic hardcore gameplay included
✅ Active development - Regular updates and improvements

Transform your server into a professional Battle Royale arena!