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! 🎮🐉✨