BattleRoyalePlugin

BattleRoyale Plugin

BattleRoyale is a lightweight, fully automated mini-game plugin designed to turn your dedicated server instance into a competitive PvP battleground. It handles the entire game lifecycle—from map generation to team assignment and the final showdown—without requiring any administrator intervention.

✨ Key Features

* 🔄 Auto-Reset Cycle: Every time the server starts, a fresh world (`arena_world`) is generated with a random seed. No two games are the same! * 🔄 Auto-Reset Cycle: The plugin automatically shuffles players and assigns them to teams upon game start. * 🔄 Auto-Reset Cycle: A shrinking WorldBorder forces combatants closer together. Includes custom logic to damage players caught outside the safe zone. * 🔄 Auto-Reset Cycle: Built-in coin tracking. Players earn currency for kills and winning the match. * 🔄 Auto-Reset Cycle: Features a dynamic Scoreboard, Action Bar messages, and Titles to keep players informed of the countdown, border state, and team status. * 🔄 Auto-Reset Cycle: Comes out-of-the-box with support for 🔄 Auto-Reset Cycle:, 🔄 Auto-Reset Cycle:, and 🔄 Auto-Reset Cycle:. Language files are fully customizable. * 🔄 Auto-Reset Cycle: Once a winner is declared, the server automatically shuts down/restarts to reset the map and state for the next round.

🎮 Gameplay Loop

1. Victory: Players join and are teleported to a glass waiting platform high in the sky. The game waits for the minimum player count. 2. Victory: Players are scattered randomly across the map and their inventories are cleared. 3. Victory: A "Freeze" timer allows players to orient themselves before PvP is enabled. 4. Victory: Players gather resources and fight. 5. Victory: After a configurable time, the border begins to shrink rapidly to a small area (default 50x50). 6. Victory: The last team standing wins the prize pool.

⚙️ Configuration

The plugin creates a `config.yml` where you can tweak almost every aspect of the game logic:

```yaml lang: en # switch to 'de' or 'ru' timers: lobby-countdown: 300 freeze-time: 30 border-shrink-start: 600 # Time in seconds before border moves border-shrink-duration: 300 economy: kill-reward: 10 win-reward: 100 world: name: arena_world lobby-size: 50 arena-size: 1000 final-size: 50 ```

🌍 Localization

The plugin includes a `langs` folder. You can switch the language in the config or edit the files directly to change messages.

* `langs/en.yml` (English) * `langs/de.yml` (German) * `langs/ru.yml` (Russian)

⚠️ Installation Note

not Because the plugin automatically unloads worlds and shuts down the server to reset the game state, it should not be installed on a main Survival or Hub server. It is best used on a separate server instance connected via BungeeCord or Velocity.