# Qroyale<\/p>\n
**Qroyale** is a Battle Royale\u2013style mini-game plugin for Minecraft servers running **Paper 1.21**.
\nIt manages a complete, automated game lifecycle \u2014 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.<\/p>\n
Designed for competitive servers, **Qroyale** focuses on fairness, pacing, and anti-camping mechanics to ensure every match ends with a decisive final duel.<\/p>\n
—<\/p>\n
## Features<\/p>\n
### \ud83c\udfae Game Cycle<\/p>\n
– **Waiting Phase**
\n – Players join in **Adventure mode**
\n – PvP and all damage are disabled
\n – Players are confined in a **glass box** at spawn
\n – Inventory is cleared on join<\/p>\n
– **Grind Phase** *(Default: 5 minutes)*
\n – Initiated using `\/q start`
\n – PvP is **disabled**
\n – Fall damage is **disabled**
\n – Glass box is removed
\n – Players receive a **Starter Kit**:
\n – Stone Pickaxe (Efficiency II)
\n – 10 Cooked Beef
\n – Players are switched to **Survival mode**
\n – Health and food are fully restored<\/p>\n
– **PvP Phase**
\n – Starts automatically after the Grind Phase
\n – PvP is **enabled**
\n – World Border begins shrinking toward the center
\n – Players outside the border take damage<\/p>\n
– **Endgame \/ Sudden Death**
\n – Triggered when the border reaches its final size *(default: 10\u00d710)*
\n – Players below a configurable Y-level *(default: Y=45)* take periodic damage
\n – Forces the final fight to occur on **high ground or surface level**<\/p>\n
—<\/p>\n
## \u2699\ufe0f Gameplay Mechanics<\/p>\n
– **Auto-Smelt**
\n – Iron Ore \u2192 Iron Ingots
\n – Gold Ore \u2192 Gold Ingots<\/p>\n
– **Custom Drops**
\n – Copper Ore:
\n – Drops Cooked Beef (100%)
\n – Small configurable chance to drop a Golden Apple
\n – Leaves (with Shears):
\n – Small configurable chance to drop an Apple<\/p>\n
– **Custom Crafting**
\n – **Cheaper Golden Apple Recipe**:
\n – 3 Gold Ingots (Top \/ Bottom \/ Sides)
\n – 1 Apple (Center)<\/p>\n
– **Death Handling**
\n – Lightning strike effect on death
\n – Player is banned and kicked with the message:
\n > *”The fight is over.”*<\/p>\n
—<\/p>\n
## \ud83d\udeab Restrictions<\/p>\n
– **Build Height Limit**: Players cannot place blocks above Y=150
\n– **No Nether**: Nether portals are disabled
\n– **No Mobs**: Natural mob spawning is disabled
\n– **Eternal Day**: Time is locked to noon
\n– **Clear Weather**: Rain and storms are disabled<\/p>\n
—<\/p>\n
## Commands<\/p>\n
All commands are prefixed with `\/q`
\nRequired permission: `qroyale.admin` *(default: OP)*<\/p>\n
### Game Management —<\/p>\n ## Configuration<\/p>\n All settings can be customized in `config.yml`.<\/p>\n ### Key Settings —<\/p>\n ## How to Run a Game<\/p>\n 1. **Setup Spawn** 2. **Wait for Players** 3. **Start the Game** 4. **Play** 5. **Finish** —<\/p>\n ## \u26a0\ufe0f Important Notes<\/p>\n – **Always delete** `bannedplayer.json` and the `world` folder **after each game** to reset the environment properly.<\/p>\n","protected":false},"excerpt":{"rendered":" Qroyale is a Minecraft Battle Royale plugin where players gather resources safely, then fight as PvP turns on and the world border shrinks until only one player remains.<\/p>\n","protected":false},"featured_media":127418,"template":"","meta":{"_minecraft_slug":"qroyale","_minecraft_project_id":"NCj01vEq","_minecraft_author":"Exenos-Studio","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":80,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"qroyale.zip","_minecraft_size_bytes":17692,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:11:51.249782Z","_minecraft_date_created":"2026-01-15T00:03:08.012036Z","_minecraft_date_modified":"2026-01-11T17:52:38.650332Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/qroyale","_minecraft_icon_attachment_id":127418,"_minecraft_imported_at":"2026-06-07T11:53:34+00:00","_minecraft_import_hash":"9a3da4ac09a40a595366011fca143be2","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[88,866,127,867,129],"mod_loader":[132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-127417","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-equipment","mod_category-minigame","mod_category-paper","mod_category-social","mod_category-spigot","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n| Command | Usage | Description |
\n| :— | :— | :— |
\n| `\/q spawn` | `\/q spawn` | Sets the global spawn point and builds the waiting glass box |
\n| `\/q start` | `\/q start` | Starts the game (begins the Grind Phase) |
\n| `\/q winner` | `\/q winner
\n| `\/q miny` | `\/q miny
\n| Setting | Default | Description |
\n| :— | :— | :— |
\n| `grind-time` | `300` | Duration of the Grind Phase (PvP off) in seconds |
\n| `border-shrink-time` | `600` | Time for the world border to shrink |
\n| `border-initial-size` | `1000.0` | Initial border side length |
\n| `border-final-size` | `10.0` | Final border side length |
\n| `damage-y-level` | `45.0` | Y-level threshold for Sudden Death damage |
\n| `damage-amount` | `2.0` | Damage dealt during Sudden Death (half-hearts) |
\n| `max-build-height` | `150` | Maximum build height |
\n| `copper-gapple-chance` | `5` | % chance for Copper Ore to drop a Golden Apple |
\n| `shears-apple-chance` | `0.6` | % chance for Shears on Leaves to drop an Apple |<\/p>\n
\n – Fly to the desired arena center
\n – Run `\/q spawn` to set the center and build the glass box<\/p>\n
\n – Players join and wait inside the glass box in Adventure mode<\/p>\n
\n – Run `\/q start`
\n – The glass box breaks and the Grind Phase begins<\/p>\n
\n – Game automatically progresses through Grind \u2192 PvP \u2192 Sudden Death<\/p>\n
\n – The last player standing wins
\n – Use `\/q winner