Advanced Features - MisterWonderful/DivineHordes GitHub Wiki

🔧 Advanced Features for Server Administrators

📊 Comprehensive Management Tools

  • Modern zMenu GUI: Beautiful, responsive interface with real-time updates
  • Admin Panel: Complete event control, performance monitoring, and quick configuration
  • Emergency Override: 3-minute cooldown safety system for problematic events
  • PlaceholderAPI: 20+ placeholders for integration with other plugins

⚙️ Intelligent Performance Optimization

  • Async Operations: Maintains 19.8+ TPS even with 50+ mobs and 20 players
  • Smart Cleanup: Automatic mob management and memory optimization
  • Chunk Loading: Intelligent chunk management for smooth gameplay
  • TPS Monitoring: Adaptive scaling based on server performance

🔗 Seamless Integrations

  • zMenu: Modern GUI system with interactive menus and real-time data
  • PlaceholderAPI: Full integration with scoreboard plugins, chat formatting, and more
  • WorldGuard: Respects region protections and permissions (in progress)
  • Citizens: NPC representation of divine entities (in progress)

💎 What Players Experience

🎭 Immersive Events

  1. Divine Summons: Dramatic announcements with boss bars and particle effects
  2. Strategic Planning: Analyze difficulty, assess offerings, plan approach
  3. Epic Battles: Face waves of enhanced mobs with smart AI and equipment
  4. Meaningful Rewards: Earn rare items scaled to the challenge overcome

🧭 Player-Friendly Features

  • Real-time Navigation: Compass targeting and action bar distance indicators
  • Live Scoreboard: Dynamic updates showing event status, time, and difficulty
  • GUI Access: Beautiful menus for status checking and offering management
  • Teleport Commands: Quick access to offering locations during events

📋 Technical Excellence

🔧 Easy Installation & Setup

Requirements:
- Minecraft 1.21.1 (1.18.x coming very soon!) (Paper/Spigot/Bukkit)
- Java 21
- PlaceholderAPI (required)
- zMenu (recommended for GUI)

📝 Extensive Configuration

  • 100+ Config Options: Fine-tune every aspect of gameplay
  • Balanced Defaults: Works perfectly out-of-the-box
  • Live Reload: Change settings without restarting
  • Debug Tools: Comprehensive logging and performance metrics

🛡️ Rock-Solid Stability

  • Exception Handling: Graceful degradation when issues occur
  • Memory Management: Automatic cleanup prevents memory leaks
  • Thread Safety: Async operations don't block the main thread
  • Backup Systems: Fallbacks ensure events always function

📊 Proven Performance

Real Server Statistics:

  • 19.8 TPS with 50 mobs + 20 players
  • 🧠 1.2GB RAM usage during peak events
  • 🚀 Sub-second response times for all commands
  • ⏱️ 30-second difficulty recalculation intervals