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

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.