# Changelog All notable changes to this project will be documented in this file. ## [Released] - 2026-03-03 ### Fixed - Lobby spawn platform height is now dynamic based on highest terrain in the lobby area, preventing mountain intersections. - Lobby spawn teleport now uses the computed lobby spawn location instead of a hardcoded Y-level. - Safe-spawn validation now rejects all glass and glass pane blocks to prevent spawning on lobby glass. - `world.safe-spawn.enabled` is now respected in spawn selection logic. - `/br reload` now reloads language configuration through `ConfigManager.reload()`. ### Added - New config options under `world`: - `lobby-min-y` - `lobby-clearance` - `lobby-height` - New safe-spawn option: - `world.safe-spawn.avoid-glass`

# Battle Royale Plugin v2.3.1 - Hotfix ## 🐛 Bug Fixes **Critical fixes - please update immediately if you're using v2.3!** ### Fixed Server Crashes: - **Victory Animation Crash**: Server no longer crashes when a player disconnects during the victory dragon flight - **Kit Configuration Crash**: Server no longer crashes when kit config has wrong format (like typing letters instead of numbers) ### Fixed Gameplay Issues: - **Duplicate Items**: Players were getting items twice (2 swords, 2 bows). Now they get correct amount - **Missing Items**: Some items weren't given to players if enchantments weren't specified. Now all items are given properly - **Wrong Version**: Plugin now shows correct version "2.3" instead of "2.1" in server logs ## 📝 Summary Fixed 5 bugs total: - 2 critical bugs that crashed the server - 2 major bugs that broke gameplay - 1 minor cosmetic bug ## ⚠️ Who Should Update? **Update immediately if:** - Your server crashes during victory celebrations - Your server crashes when players get kits - Players are getting double items - Some kit items are missing ## ✅ What's Included All features from v2.3 are still here: - Victory dragon flight animation - Customizable kits - Safe spawn system - Statistics and achievements - Killstreak rewards - Multi-language support ## 🔄 How to Update 1. Stop your server 2. Replace the old plugin file with the new one 3. Start your server 4. Done! No config changes needed --- **This is a stability update - highly recommended for all v2.3 users!**

# Battle Royale Plugin v2.3 - Epic Victory Update! 🐉 ## 🎉 Major Features ### 🐉 Epic Victory Animation Winners now ride **Ender Dragons** in a spectacular victory flight! - Automatic dragon spawn for each winner - Players ride on dragons flying in circles - Beautiful particle effects (Dragon Breath, End Rod, Fireworks) - Epic sound effects (Dragon roar, wing flaps) - Fully configurable in `config.yml` ### 🎁 Fully Customizable Kits Complete control over player kits through configuration! - Enable/disable entire kit system - Enable/disable individual kits - Customize items for each kit - Customize enchantments and levels - Create your own custom kits - 5 default kits: Warrior, Archer, Tank, Assassin, Support ### 🛡️ Safe Spawn System Players will never spawn on dangerous blocks! - Avoids ice, water, lava - Avoids dangerous blocks (cactus, magma, fire, etc.) - Checks space above player head - Configurable filters - 100 attempts to find safe location ## ✨ New Features ### Victory Animation - **Dragon Flight**: Winners ride Ender Dragons - **Circular Motion**: Dragons fly in smooth circles - **Wave Movement**: Dynamic height changes - **Particle Effects**: Dragon Breath, End Rod, Fireworks - **Sound Effects**: Dragon roars, wing flaps, achievements - **Action Bar**: "✦ VICTORY FLIGHT ✦" message - **Duration**: Configurable (default 10 seconds) ### Kit System - **5 Default Kits**: Warrior, Archer, Tank, Assassin, Support - **Random Assignment**: Automatic random kit on game start - **Full Customization**: Edit items, enchantments, amounts - **Enable/Disable**: Control each kit individually - **Format**: `MATERIAL:AMOUNT` for items, `ENCHANTMENT:LEVEL` for enchants ### Safe Spawn - **15 Dangerous Blocks**: Ice, water, lava, cactus, fire, etc. - **Smart Detection**: Checks block safety - **Space Check**: Ensures 2 blocks above head are clear - **Fallback**: Spawns at center if no safe location found - **Performance**: Minimal impact on server ## 🎮 Game Features ### Core Gameplay - **Team System**: Automatic 2-player teams - **World Generation**: Pre-generated worlds for smooth gameplay - **Border Shrinking**: Dynamic safe zone - **Airdrops**: Random loot drops with epic items - **Freeze Phase**: 10-second preparation before combat ### Progression System - **Statistics**: Kills, deaths, wins, K/D ratio, best killstreak - **Killstreaks**: Rewards at 3, 5, 7, and 10 kills - 3 kills: Speed I (10s) - 5 kills: 3 Golden Apples + Regeneration II (5s) - 7 kills: Resistance I + Strength I (15s) - 10 kills: Enchanted Golden Apple + Absorption II (30s) - **Achievements**: 7 achievements with coin rewards - First Blood, Killer, Assassin, Winner, Champion, Rampage, Unstoppable - **Economy**: Coins for kills and wins ### Quality of Life - **Dynamic Scoreboard**: Real-time stats display - **Compass Tracking**: Find nearest enemy - **Multi-language**: English, Russian, German - **Admin Commands**: `/br start`, `/br stop`, `/br reload` - **Player Commands**: `/br stats`, `/br achievements`, `/br compass` ## ⚙️ Configuration ### Victory Animation ```yaml victory: animation-enabled: true animation-duration: 200 dragon-speed: 0.5 circle-radius: 30 flight-height: 100 particles-enabled: true sounds-enabled: true ``` ### Kit System ```yaml kits: enabled: true random: true warrior: enabled: true items: sword: IRON_SWORD sword-enchant: SHARPNESS:1 # ... more items ``` ### Safe Spawn ```yaml world: safe-spawn: enabled: true max-attempts: 100 check-above: true avoid-ice: true avoid-water: true avoid-lava: true avoid-dangerous: true ``` ## 🐛 Bug Fixes - Fixed NPE crashes in GameManager - Fixed memory leaks in EconomyManager and StatsManager - Fixed airdrop spawning in air - Fixed lobby size calculation (was 4x too large) - Fixed player movement in freeze phase - Fixed border damage calculation - Fixed team cleanup between games - Fixed enchantment compatibility for 1.21+ ## 🔧 Technical Improvements - Optimized world generation (4 chunks/tick) - Disabled mob spawning in game world - Disabled Minecraft achievements in game world - Added null checks everywhere - Improved error handling - Better memory management - Cleaner code structure ## 📋 Requirements - **Minecraft**: 1.21+ - **Server**: Paper or Spigot - **Java**: 17+ ## 📚 Documentation Full documentation included: - `README.md` - Complete plugin guide - `KITS_CONFIG.md` - Kit customization guide - `SAFE_SPAWN.md` - Safe spawn configuration - `VICTORY_ANIMATION.md` - Victory animation settings - `BUILD.md` - Build instructions ## 🌍 Languages - 🇬🇧 English - 🇷🇺 Russian - 🇩🇪 German ## 💡 Commands ### Admin Commands - `/br start` - Force start game - `/br stop` - Stop game - `/br reload` - Reload configuration ### Player Commands - `/br stats` - View your statistics - `/br achievements` - View your achievements - `/br compass` - Get enemy tracking compass ## 🎯 Permissions - `br.admin` - Admin commands (start, stop, reload) ## 📊 Statistics Tracked - Kills - Deaths - Wins - K/D Ratio - Current Killstreak - Best Killstreak ## 🏆 Achievements 1. **First Blood** - Get your first kill 2. **Killer** - Get 10 kills 3. **Assassin** - Get 50 kills 4. **Winner** - Win your first game 5. **Champion** - Win 10 games 6. **Rampage** - Get 5 killstreak 7. **Unstoppable** - Get 10 killstreak ## 🎨 Features Showcase ### Victory Animation When you win, you'll experience: 1. Ender Dragon spawns above you 2. You automatically mount the dragon 3. Dragon flies in epic circles 4. Particle effects surround you 5. Epic sounds play 6. "✦ VICTORY FLIGHT ✦" appears on screen 7. All players see and hear your victory! ### Kit System Choose from 5 balanced kits: - **Warrior**: Iron armor + enchanted sword - **Archer**: Bow + 64 arrows + light armor - **Tank**: Diamond helmet/chest + shield - **Assassin**: Strong sword + golden apples - **Support**: Lots of food + building blocks ### Safe Spawn Never spawn on: - Ice (slippery) - Water (drowning) - Lava (instant death) - Cactus (damage) - Fire, Magma, Powder Snow, etc. ## 🔄 Update Path From v1.0 → v2.3: - All features are new additions - No breaking changes - Config auto-migrates - Just drop in and reload! ## 🙏 Credits **Author**: Flonxi **Version**: 2.3 **Release Date**: January 6, 2026 ## 📝 Changelog Summary **Added:** - Epic victory animation with Ender Dragons - Fully customizable kit system - Safe spawn system - Statistics tracking - Killstreak rewards - Achievement system - Compass tracking - Multi-language support - Admin commands **Fixed:** - 16+ bug fixes - Memory leaks - NPE crashes - Spawn issues **Improved:** - Performance optimizations - Code quality - Error handling - Documentation --- **Download now and give your players an epic Battle Royale experience!** 🎮🐉✨

# BattleRoyale Plugin Changelog ## Version 2.0.0 - 'Airdrop & WorldGen Update' **Release Date:** 05.12.2025 This major update focuses on adding dynamic content to the game, improving performance and stability, and resolving critical errors related to resource and world management. --- ### 🚀 New Features * **Airdrop System:** * Added a new class **`LootManager`** to manage loot generation and chest contents. * Implemented a new class **`AirdropTask`** that periodically drops valuable loot at a random location on the arena during the **PLAYING** phase. * New timer parameters (`airdrop-interval`) have been added to the configuration. * Added new messages to language files to notify players about the approaching and spawning airdrop. * **World Pre-Generation:** * The world pre-generation function (`startWorldPreGeneration`) has been added to `GameManager`. * World generation now occurs during the transition from `LOBBY` to `PLAYING` to prevent lag. * Players receive notifications about the progress of world generation (`world-gen-start`, `world-gen-progress`, `world-gen-complete`). --- ### 🛠️ Improvements and Fixes #### Core (BattleRoyalePlugin) * **Critical Error Fixes:** Fixed the `cannot find symbol method getLootManager()` error by adding the initialization of `LootManager` and the corresponding getter in `BattleRoyalePlugin`. * **Version Management:** Updated the internal version number to `2.0.0`. #### GameManager * **Improved World Management:** Completely redesigned the logic for creating and deleting game worlds: * The `createNewGameWorld` method now safely unloads and deletes old worlds before creating a new one. * Added termination of all active tasks (`startingTask`, `airdropTask`, `borderDamageTask`, `generatorTask`) when creating a new world to prevent duplication. * **Safe Game Start:** Game start is now divided into two stages: world generation (`startGame`) and teleportation/unfreeze (`continueGameStart`), ensuring a smoother transition. * **Constant Restart:** The `endGame` method has been changed—instead of stopping the server, it now automatically restarts a new game cycle (`createNewGameWorld(true)`). * **Zone Damage:** A new `borderDamageTask` has been added to deal damage to players outside the shrinking border. #### Game Listener * **PvP Protection in FROZEN:** An `onMove` handler has been added that cancels player movement (except for changing the camera angle) during the `FROZEN` phase, ensuring a fair start. #### TeamManager * **Team Damage:** The friendly fire check logic (`friendly-fire`) has been moved from `GameListener` to a more appropriate place using `TeamManager`. #### Language Files (`ru.yml`, `en.yml`, `de.yml`) * All new language keys have been added to support the Airdrop and World Pre-Generation systems.

# v1.0.0 - Initial Release This is the first public release of the **BattleRoyale** plugin. ### 🚀 Features * **Automated Game Loop:** Complete management of the game cycle from Lobby -> Freeze -> Fighting -> Border Shrink -> Victory -> Server Restart. * **Dynamic World System:** Automatically generates a unique seed for the arena world on every server start and cleans up old worlds. * **Team Manager:** Randomly assigns players to teams (Solos/Duos) at the start of the match. * **Economy Integration:** Simple economy system tracking coins for kills and wins. ### ⚙️ Configuration & Customization * **Configurable Timers:** You can now customize: * Lobby Countdown * Freeze Time * Border Shrink Start Time & Duration * Server Restart Delay * **Configurable Rewards:** Set custom coin amounts for kills and victories. ### 🌍 Localization * **Multi-Language Support:** Added a flexible language system using YAML files. * **Included Languages:** * 🇺🇸 English (`en.yml`) * 🇩🇪 German (`de.yml`) * 🇷🇺 Russian (`ru.yml`) * All messages (chat, titles, action bars, scoreboards) are fully translatable.