📜 Divine Hordes Changelog

🛡️ [2.6.0] - 2025-06-17

✨ The Quality of Life & Fairness Update

🌟 Major Features

💎 Rare Item Protection System

No more losing your most precious items!

• 🚫 100+ Protected Items: Dragon eggs, nether stars, netherite gear, and more
• 🎲 Smart Fallback System: Automatically switches to fair alternatives if needed
• ⚖️ Balanced Requirements: Maintains challenge without unfair losses
• 📦 Applies Everywhere: Offerings, bounty boxes, and rewards

🏔️ Underground Player Support

Cave dwellers rejoice! You can now participate from the depths!

• 🎯 Intelligent Chest Spawning: Three-tier system ensures everyone can participate
• 📏 Dynamic Distance Scaling: Automatically adjusts for underground players
• 😄 Snarky Divine Messages: 7 new humorous responses when spawning fails
• 🔄 Auto-Retry System: Failed spawns retry in 5 minutes automatically

🖥️ GUI Experience Improvements

Cleaner, clearer, more intuitive!

• 📚 Better Information Flow: "How to Play" → "Find Chest" → "Change Offering"
• 🎨 Reorganized Layout: Educational content first, actions second
• ✨ Cleaner Design: Removed misleading "Click to change!" text
• 🔄 Improved Button Positions: More logical left-to-right progression

🛠️ Technical Improvements

• New Utility Classes: RareItemFilter for comprehensive item management
• Enhanced Detection: Better underground player identification
• Configuration Options: Full control over underground spawning behavior
• Performance: Optimized item checking with HashSet lookups
• Compatibility: 100% backwards compatible, no migration needed
• Minecraft 1.21.6 Ready: Forward compatible with upcoming 1.21.6 release

🐛 Bug Fixes

• Fixed underground players unable to participate in events
• Fixed chest spawning failures in cave systems
• Fixed misleading GUI text suggesting non-clickable items were interactive
• Fixed rare items being requested as offerings
• Fixed chest spawning in bedrock layers

📊 By The Numbers

• 100+ rare items protected
• 3 tier fallback system for spawning
• 7 new Divine One messages
• 6 dynamic distance reductions (100→80→60→40→20→10)
• 0 backwards compatibility issues

🔥 Divine Hordes Plugin - Complete Evolution Changelog

📋 Quick Navigation

• 🚀 Version 2.5.0 - "Sleep Prevention & Polish"
• ⚡ Version 2.4.0 - "Combat & Optimization Revolution"
• 🏗️ Version 2.3.0 - "Complete System Overhaul"
• 🔄 Version 2.2.0 - "Foundation Enhancement"
• 📊 Complete Feature Evolution
• 🔧 Migration Guide

🚀 Version 2.5.0 - "Sleep Prevention & Polish"

Latest Release - Production Ready

🛏️ Sleep Prevention System - Strategic Night Mechanics

NEW FEATURE: Complete sleep prevention during active Divine Horde events

✨ Key Features:
- Players cannot sleep during active events (maintains strategic pressure)
- Spawn point setting still works with beds (practical base management)
- Automatic bed ejection with informative messages
- Configurable system with master toggle and notification controls

🎯 Strategic Benefits:
- Preserves event tension and cooperation requirements
- Prevents easy escape from Divine Horde challenges
- Maintains quality of life for respawn management

🛡️ Enhanced Block Protection System

CRITICAL FIX: Offering chest protection overhaul

🔧 Improvements:
- Fixed critical block breaking bug during events
- Enhanced protection system with better event detection
- Improved chest security with multi-layer validation
- Better error handling and fallback protection methods

🧹 Emergency Cleanup Improvements

SAFETY ENHANCEMENT: Better plugin removal procedures

⚡ Features:
- Enhanced emergency cleanup methods for safer plugin removal
- Improved entity cleanup with better detection systems
- More thorough memory cleanup and resource freeing
- Better error handling during cleanup operations

⚙️ Configuration & Compatibility

SYSTEM IMPROVEMENTS: Enhanced configuration and compatibility

📋 Updates:
- Comprehensive sleep prevention configuration options
- Enhanced debug system for chest protection and sleep prevention
- Improved spawn point setting with version compatibility fallbacks
- Better configuration validation and error reporting

📄 License Change:
- Updated from GPL-3.0-only to MIT License
- Broader compatibility and easier integration for developers
- More permissive licensing for community modifications

📚 Documentation Overhaul

DOCUMENTATION: Complete refresh for v2.5.0

📖 Updates:
- Complete documentation refresh for all new features
- Enhanced troubleshooting guides with new scenarios
- Improved configuration examples and best practices
- Updated developer integration guides

⚡ Version 2.4.0 - "Combat & Optimization Revolution"

Major Feature Release

⚔️ Combat Enhancement Revolution

COMBAT OVERHAUL: Completely redesigned combat experience

🎯 Spawn Distance Optimization:
- Mobs now spawn 20-40 blocks from players (was 30-100 blocks)
- Better reaction time and strategic positioning
- Balanced engagement distance for all difficulty levels

💥 Real-Time Damage Feedback:
- Action bar display shows exact damage dealt to mobs
- Live mob health percentage remaining
- Instant feedback for combat effectiveness
- Enhanced combat satisfaction and tactical awareness

⚡ Progressive Speed Scaling:
- Early game: 60%/70% normal speed (strategic gameplay)
- Progressive increase through difficulty levels
- Normal speed reached at Nightmare difficulty
- Balanced progression for all skill levels

🧮 Player Data & Statistics Revolution

PLAYER TRACKING: Comprehensive statistics system

📊 Real-Time Player Stats:
- Events participated and completed with success rates
- Total offerings changed and XP spent tracking
- Teleports used and mob kills during events
- Deaths during events with detailed breakdown
- Top 5 most offered items with quantities
- Average XP expenditure per event
- Complete participation history with timestamps

💾 Data Persistence:
- Complete login/logout data preservation
- Settings, stats, and history saved across sessions
- Thread-safe data operations with auto-backup
- Configurable data retention and cleanup

🗡️ Mob Balance & Difficulty Redesign

DIFFICULTY SYSTEM: Complete rebalancing for better progression

🎮 New Difficulty Ranges:
- Easy (0.7x) to Nightmare (1.8x) as dynamic range
- Very Easy (0.4x), Peaceful (0.5x), Impossible (3.0x) as manual overrides
- Starting difficulty set to "Easy" for better new player experience

👥 Player Count Separation:
- Player count now affects MOB QUANTITY, not difficulty scaling
- +20% more mobs per additional player (capped at +100%)
- Difficulty scaling based purely on equipment/experience/time

🧟 Mob Count Ranges (NEW SYSTEM):
- Easy: 15-20 base mobs
- Normal: 15-30 base mobs  
- Hard: 30-40 base mobs
- Expert: 35-45 base mobs
- Master: 42-50 base mobs
- Nightmare: 45-50 base mobs

🛡️ Beginner Protection:
- Baby zombies automatically converted to adults until Hard difficulty
- Ravagers completely blocked until Nightmare difficulty
- Progressive mob type unlocking for safer learning curve

🏺 Offering System Improvements

VARIETY SYSTEM: Enhanced offering diversity and history

🔄 Offering History System:
- Tracks last 5 offerings to prevent immediate duplicates
- Ensures variety by filtering recently used materials
- Automatic history cleanup when all options exhausted
- Applies to both automatic generation and player changes

💰 Reward System Overhaul:
- Dramatically reduced reward quantities (better balance)
- All players receive identical rewards (fairness improvement)
- Reward history prevents consecutive duplicates (3-event memory)
- Increased reward value guarantee from 1.3x to 1.5x offering value

🔧 Technical Foundation Overhaul

INDEPENDENCE: Complete removal of external dependencies

🚫 ZMenu Removal:
- Complete removal of all zMenu dependencies and code
- Fully standalone operation with built-in GUI system
- Better compatibility across all server configurations
- Reduced plugin conflicts and installation complexity

☕ Java Compatibility:
- Forward compatibility with Java 17-21+
- API updates fixing deprecated method warnings
- Minecraft 1.18+ compatibility improvements
- Modern TextComponent usage replacing deprecated methods

📦 Bounty Box Fixes:
- Fixed critical duplication bug when breaking bounty boxes
- Enhanced protection and validation systems
- Better error handling and recovery procedures

🏗️ Version 2.3.0 - "Complete System Overhaul"

Foundational Rewrite

🖥️ Complete GUI System Redesign

GUI REVOLUTION: From basic menus to comprehensive dashboard

🎛️ All-in-One Control Panel:
- Single `/dh` command opens comprehensive 54-slot dashboard
- 6x9 grid layout with organized functional sections
- Real-time updates with live statistics and event status
- Permission-based display (different interfaces for players vs admins)

📊 Dashboard Sections:
- Information Row: Status, Timer, Difficulty display
- Player Actions: Stats, Horde Info, Offering management
- Quick Actions: Change Offering, Teleport to Chest, Tutorial access
- Admin Tools: Event controls, difficulty override, system management
- Navigation: Refresh, Close, Help with visual feedback

👑 Advanced Admin Control System

ADMIN POWER: Comprehensive administrative control

🎯 Difficulty Override System:
- 9 Difficulty Levels: Peaceful → Easy → Normal → Hard → Expert → Master → Nightmare → Impossible → Dynamic
- Real-time switching with instant difficulty changes and immediate effect
- Visual admin controls with GUI-based difficulty management
- Override priority: Manual settings take precedence over auto-calculation

🔥 Play Mode Toggle System:
- Normal Mode: Standard Minecraft with balanced scaling
- Gun Mod Mode: Enhanced intensity (2x mob count, increased health/damage)
- Instant mode switching with immediate scaling changes
- Mode-specific balancing with different spawn rates per mode

🗡️ Mob Spawn Override System:
- Fixed Spawn Limits: 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60 mobs or Dynamic
- Admin GUI controls with easy spawn limit adjustment and visual feedback
- Override priority: Fixed limits bypass all other calculations
- Safety bounds: All limits respect global maximum (200 mobs)

🛡️ Advanced Memory Management System

MEMORY MASTERY: Production-grade memory monitoring and cleanup

💾 Comprehensive Memory Monitoring:
- Real-time RAM usage and collection size tracking
- Bounded collections with LRU eviction preventing unlimited growth
- Auto-cleanup every 30 seconds with configurable thresholds
- GUI memory stats with visual monitoring in admin panel
- One-click cleanup with GUI button for immediate memory optimization

🧹 Complete Cleanup System:
- Emergency cleanup: `/dh emergency` command for safe plugin removal
- GUI emergency button with admin panel emergency cleanup and confirmation
- Comprehensive removal: All mobs, entities, tasks, and data cleaned
- Thread safety: Proper shutdown of all background processes
- Memory liberation: Complete restoration to pre-plugin state

📊 Collection Limits (Bounded with LRU Eviction):
- Player Data: 1000 entries max
- History/Player: 100 entries max
- Active Mobs: 200 max (LRU eviction)
- Bounty Boxes: 50 max (auto-cleanup)
- Cache Objects: 1000 max (80% threshold)
- Thread-Safe: All collections properly synchronized

📈 Enhanced Difficulty System

PROGRESSION: 9-level difficulty with better scaling

🎯 Difficulty Levels:
- Peaceful (0.5x): Training mode with minimal threat
- Easy (0.8x): Beginner-friendly introduction  
- Normal (1.0x): Standard balanced gameplay
- Hard (1.3x): Increased challenge and mob strength
- Expert (1.6x): Skilled player territory
- Master (2.0x): Elite challenge - normal health scaling begins
- Nightmare (2.5x): Hardcore difficulty
- Impossible (3.0x): Ultimate test of skill
- Dynamic (Auto): Real-time calculation based on multiple factors

⚔️ Improved Combat Scaling:
- Easier Early Game: Health scaling 0.3x-0.8x for Peaceful-Expert
- Progressive Challenge: Health scaling 0.8x-1.2x for Master-Impossible
- Damage Rebalancing: 0.5x-1.1x (Normal), 0.75x-1.1x (Gun Mod)
- Mob Type Restrictions: Dangerous mobs blocked until appropriate difficulty

🔧 Production Stability Enhancements

RELIABILITY: Enterprise-grade stability and performance

🚀 Performance Optimization:
- Thread Safety: All operations properly synchronized
- Memory Leak Prevention: Automatic detection and cleanup
- TPS Optimization: Reduced server impact during events
- Async Operations: Non-blocking file and database operations

📊 Enhanced Monitoring:
- Real-Time Performance: TPS and resource usage tracking
- Entity Count Monitoring: Active mob and bounty box tracking  
- Memory Usage Alerts: Automatic cleanup when thresholds exceeded
- System Health Dashboard: Complete performance overview in GUI

🔄 Version 2.2.0 - "Foundation Enhancement"

Intermediate Stability Release

🏗️ Core System Improvements

FOUNDATION: Enhanced stability and performance

🔧 System Enhancements:
- Enhanced mob spawning algorithms with better distribution
- Improved difficulty calculation stability and consistency
- Better world compatibility checking with error handling
- Optimized entity management system with performance gains

🐛 Bug Fixes & Stability:
- Fixed memory leaks in long-running events
- Resolved GUI compatibility issues across versions
- Improved error handling and logging systems
- Enhanced plugin shutdown procedures for clean exits

⚙️ Configuration Enhancements:
- More granular difficulty settings with fine-tuning options
- Improved offering tier balancing for better gameplay
- Enhanced mob type weight system with restrictions
- Better performance configuration options for various server sizes

📊 Complete Feature Evolution

🔧 Migration Guide

📋 Pre-Migration Checklist

🚀 Migration Process: v2.1.0 → v2.5.0

1. Complete any active Divine Horde events
2. Stop the server gracefully
3. Create backups as described above
4. Remove zMenu dependency (no longer needed)

1. Remove old divine-hordes-2.1.0.jar from plugins/
2. Remove zMenu plugin (no longer required)  
3. Place new divine-hordes-2.5.0.jar in plugins/
4. Keep PlaceholderAPI if desired (now optional)

1. Start server to generate new config.yml structure
2. Stop server and merge your custom settings
3. Update configuration format if needed:
   
   OLD FORMAT (v2.1.0):
   integrations:
     zmenu:
       enabled: true
   
   NEW FORMAT (v2.5.0):
   # zMenu sections completely removed
   # All GUI functionality now built-in

1. Start server and check console for errors
2. Test new GUI system: /dh
3. Verify admin controls work (if admin/OP)
4. Test event triggering: /dh trigger (admin)
5. Confirm player stats tracking

✅ Post-Migration Verification

🆘 Troubleshooting Migration Issues

Problem: /dh command doesn't open new GUI
Solution: 
- Verify permissions: divinehordes.use
- Restart server completely
- Check console for material/version errors
- Try /dh reload to refresh system

Problem: Plugin won't load due to config issues
Solution:
- Delete config.yml and let it regenerate
- Compare old settings with new format
- Check YAML syntax with online validator
- Review console error messages for specifics

Problem: Player statistics not showing
Solution:
- Player data rebuilds automatically over time
- Use /dh reload to refresh data systems
- Check plugins/DivineHordes/data/ folder exists
- Verify file permissions for data directory

Problem: Server lag after upgrade
Solution:
- Use GUI admin panel to adjust performance settings
- Check memory usage: /dh memory stats
- Run emergency cleanup if needed: /dh emergency
- Adjust mob spawn limits via admin GUI

Problem: Sleep prevention not working properly
Solution:
- Check sleep-prevention.enabled in config
- Verify events are actually active
- Test spawn point setting separately
- Review debug logs for sleep events

🎯 Breaking Changes Summary

⚠️ Critical Changes Requiring Attention

REMOVED: zMenu dependency (was required in v2.1.0)
CHANGED: PlaceholderAPI now optional (was required)
RESULT: Plugin now completely standalone
ACTION: Remove zMenu plugin, PlaceholderAPI optional

REMOVED: integrations.zmenu section
REMOVED: integrations.deluxemenus section
ADDED: horde.sleep-prevention section  
ADDED: difficulty.mob-count-ranges section
CHANGED: difficulty level ranges and scaling
ACTION: Allow config regeneration, then merge custom settings

ENHANCED: /dh command now opens comprehensive GUI
ADDED: Multiple new admin commands and GUI options
CHANGED: Admin GUI completely redesigned
ACTION: Retrain administrators on new GUI system

CHANGED: Difficulty scaling completely rebalanced
CHANGED: Mob spawn distances optimized (20-40 blocks)
CHANGED: Player count affects mob quantity, not difficulty
ADDED: Sleep prevention during events
ACTION: Monitor gameplay balance, adjust as needed

📊 Compatibility Matrix

🌟 Community Impact

📈 Player Experience Evolution

👑 Administrator Evolution

🏆 The Complete Evolution

First release, 1.21.1 specific, 1.18.X coming soon (being tested).

REQUIRES PLACEHOLDERAPI