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

Configuration

All settings can be customized in config.yml.

Key Settings

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.