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.