Qroyale

# Qroyale **Qroyale** is a Battle Royale–style mini-game plugin for Minecraft servers running **Paper 1.21**. It manages a complete, automated game lifecycle — starting with a safe resource-gathering phase and progressing into an intense PvP endgame with a shrinking world border and a forced high-ground Sudden Death finale. Designed for competitive servers, **Qroyale** focuses on fairness, pacing, and anti-camping mechanics to ensure every match ends with a decisive final duel. --- ## Features ### 🎮 Game Cycle - **Waiting Phase** - Players join in **Adventure mode** - PvP and all damage are disabled - Players are confined in a **glass box** at spawn - Inventory is cleared on join - **Grind Phase** *(Default: 5 minutes)* - Initiated using `/q start` - PvP is **disabled** - Fall damage is **disabled** - Glass box is removed - Players receive a **Starter Kit**: - Stone Pickaxe (Efficiency II) - 10 Cooked Beef - Players are switched to **Survival mode** - Health and food are fully restored - **PvP Phase** - Starts automatically after the Grind Phase - PvP is **enabled** - World Border begins shrinking toward the center - Players outside the border take damage - **Endgame / Sudden Death** - Triggered when the border reaches its final size *(default: 10×10)* - Players below a configurable Y-level *(default: Y=45)* take periodic damage - Forces the final fight to occur on **high ground or surface level** --- ## ⚙️ Gameplay Mechanics - **Auto-Smelt** - Iron Ore → Iron Ingots - Gold Ore → Gold Ingots - **Custom Drops** - Copper Ore: - Drops Cooked Beef (100%) - Small configurable chance to drop a Golden Apple - Leaves (with Shears): - Small configurable chance to drop an Apple - **Custom Crafting** - **Cheaper Golden Apple Recipe**: - 3 Gold Ingots (Top / Bottom / Sides) - 1 Apple (Center) - **Death Handling** - Lightning strike effect on death - Player is banned and kicked with the message: > *"The fight is over."* --- ## 🚫 Restrictions - **Build Height Limit**: Players cannot place blocks above Y=150 - **No Nether**: Nether portals are disabled - **No Mobs**: Natural mob spawning is disabled - **Eternal Day**: Time is locked to noon - **Clear Weather**: Rain and storms are disabled --- ## Commands All commands are prefixed with `/q` Required permission: `qroyale.admin` *(default: OP)* ### Game Management | Command | Usage | Description | | :--- | :--- | :--- | | `/q spawn` | `/q spawn` | Sets the global spawn point and builds the waiting glass box | | `/q start` | `/q start` | Starts the game (begins the Grind Phase) | | `/q winner` | `/q winner <player>` | Manually declares a winner, triggers fireworks, and announces victory | | `/q miny` | `/q miny <y-level>` | Sets the Sudden Death Y-level threshold | --- ## Configuration All settings can be customized in `config.yml`. ### Key Settings | Setting | Default | Description | | :--- | :--- | :--- | | `grind-time` | `300` | Duration of the Grind Phase (PvP off) in seconds | | `border-shrink-time` | `600` | Time for the world border to shrink | | `border-initial-size` | `1000.0` | Initial border side length | | `border-final-size` | `10.0` | Final border side length | | `damage-y-level` | `45.0` | Y-level threshold for Sudden Death damage | | `damage-amount` | `2.0` | Damage dealt during Sudden Death (half-hearts) | | `max-build-height` | `150` | Maximum build height | | `copper-gapple-chance` | `5` | % chance for Copper Ore to drop a Golden Apple | | `shears-apple-chance` | `0.6` | % chance for Shears on Leaves to drop an Apple | --- ## How to Run a Game 1. **Setup Spawn** - Fly to the desired arena center - Run `/q spawn` to set the center and build the glass box 2. **Wait for Players** - Players join and wait inside the glass box in Adventure mode 3. **Start the Game** - Run `/q start` - The glass box breaks and the Grind Phase begins 4. **Play** - Game automatically progresses through Grind → PvP → Sudden Death 5. **Finish** - The last player standing wins - Use `/q winner <player>` for manual victory declaration if needed --- ## ⚠️ Important Notes - **Always delete** `bannedplayer.json` and the `world` folder **after each game** to reset the environment properly.