BattleRoyalePlugin

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

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

kits:
  enabled: true
  random: true
  warrior:
    enabled: true
    items:
      sword: IRON_SWORD
      sword-enchant: SHARPNESS:1
      # ... more items

Safe Spawn

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.