Qroyale

Qroyale

Paper 1.21 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

- glass box - Players join in glass box - PvP and all damage are disabled - Players are confined in a glass box at spawn - Inventory is cleared on join

- Survival mode *(Default: 5 minutes)* - Initiated using `/q start` - PvP is Survival mode - Fall damage is Survival mode - Glass box is removed - Players receive a Survival mode: - Stone Pickaxe (Efficiency II) - 10 Cooked Beef - Players are switched to Survival mode - Health and food are fully restored

- enabled - Starts automatically after the Grind Phase - PvP is enabled - World Border begins shrinking toward the center - Players outside the border take damage

- high ground or surface level - 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

- Cheaper Golden Apple Recipe - 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

- Clear Weather: Players cannot place blocks above Y=150 - Clear Weather: Nether portals are disabled - Clear Weather: Natural mob spawning is disabled - Clear Weather: 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

- after each game `bannedplayer.json` and the `world` folder after each game to reset the environment properly.