🐉 nmBosses - Changelog

📝 Version History

🔄 Version 1.1.1-Fix (March 2026)

🐛 Critical Bug Fixes

1. Fixed: Auto spawn max count not increasing/decreasing in GUI

   • Left-click now increases, right-click decreases
   • Minimum value protected at 1
   • Config values read dynamically for real-time updates

2. Fixed: Boss cloning issue when players leave the world

   • Entities no longer duplicate on chunk unload/reload
   • Boss health and bossbar now persist correctly
   • Added ChunkListener for proper entity management
   • Persistent entity detection prevents duplicate spawning

3. Fixed: Boss respawn delay not working in GUI

   • Clock item now allows adjustment of respawn delay
   • Left-click: +10 seconds, Right-click: -10 seconds
   • Shift+click: +60 seconds for faster adjustment

4. Fixed: Auto-spawn race condition

   • Boss respawn delay now properly enforced
   • Single spawn mechanism with 5-second interval
   • Max count and spawn location validation

5. Fixed: Spawn location lost on server restart

   • Boss loading delayed 1 tick to ensure worlds are loaded
   • World availability check prevents null pointer errors
   • Enhanced debug logging for spawn location issues

6. Fixed: Auto-spawn not working after server restart

   • Auto-spawn task now starts after boss loading completes
   • Persistent entities properly re-initialized
   • Boss state restored from config on startup

7. Fixed: Boss despawn after server restart

   • Boss state (location, health) saved to config on shutdown
   • Persistent entities re-initialized on startup
   • Health restoration from saved state

8. Fixed: Compilation errors

   • Removed duplicate method definitions
   • Added delegation methods to BossConfigHelper
   • All imports properly configured

9. Fixed: Boss saved but not loading on server restart

   • Two-phase loading system implemented:
     1. Persistent entities checked and initialized
     2. Config-saved bosses spawned if not already loaded
   • Invalid Y coordinates automatically corrected
   • Duplicate spawn prevention with entity tracking
   • Boss health restored from saved state

🔧 Technical Improvements

• Changed entity persistence to true for proper chunk saving
• Added chunk load/unload event handling with duplicate detection
• Improved entity tracking with scoreboard tags (nmBoss:bossId)
• Fixed method signature issues in GUIManager
• Fixed entity casting in ChunkListener
• BossManager refactored into specialized managers:
  • BossPersistenceManager - State saving/loading
  • BossConfigHelper - Config operations
  • BossLoader - Boss configuration loading
• Added Y coordinate validation for spawn locations
• Implemented debounce mechanism (10 ticks) for invalid entity cleanup
• Direct config reading for dynamic value updates

⚠️ Temporary Changes

• Plugin integrations temporarily disabled (MythicMobs, Oraxen, Nexo)
  • Will be re-enabled in future update with proper API handling
  • Core functionality unaffected

📊 Code Quality

• Reduced BossManager from 947 to 752 lines
• Single Responsibility Principle applied to all managers
• Comprehensive debug logging for troubleshooting
• Thread-safe collections (ConcurrentHashMap) used throughout

Developer: Noramu | noramu.com.tr