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 * **🌎 Automated World Generation:** Every time the server starts, a fresh world (`arena_world`) is generated with a random seed. No two games are the same! * **⚔️ Solo & Duo Teams:** The plugin automatically shuffles players and assigns them to teams upon game start. * **⭕ The Danger Zone:** A shrinking WorldBorder forces combatants closer together. Includes custom logic to damage players caught outside the safe zone. * **💰 Economy System:** Built-in coin tracking. Players earn currency for kills and winning the match. * **📊 Immersive UI:** Features a dynamic Scoreboard, Action Bar messages, and Titles to keep players informed of the countdown, border state, and team status. * **🌐 Multi-Language Support:** Comes out-of-the-box with support for **English**, **German**, and **Russian**. 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. **Lobby Phase:** Players join and are teleported to a glass waiting platform high in the sky. The game waits for the minimum player count. 2. **The Drop:** Players are scattered randomly across the map and their inventories are cleared. 3. **Preparation:** A "Freeze" timer allows players to orient themselves before PvP is enabled. 4. **Survival:** Players gather resources and fight. 5. **Sudden Death:** 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 **This plugin is designed for Dedicated Game Servers.** 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.