Divine Hordes transforms your Minecraft server into an epic battleground where players must unite against supernatural forces. An AI-controlled divine entity periodically demands offerings from players, spawning enhanced mobs if demands aren't met. Players must work together to gather required items and deliver them before time runs out.

• Java: 17+ (Java 21 recommended)
• Minecraft: 1.18.2 - 1.21.5
• Server: Bukkit, Spigot, or Paper (Paper recommended)
• Dependencies: None! Completely standalone

1. Download the latest divine-hordes-2.5.0.jar from releases
2. Place in your server's plugins/ folder
3. Start/restart your server
4. Configure via GUI (/dh) or edit config.yml
5. Enjoy the divine chaos! 🎉

/dh                 # Open the comprehensive control panel
/dh help           # View all available commands
/dh trigger        # Manually start an event (admin only)

1. 🔔 Event Triggers - Every 5-35 minutes, the Divine One demands tribute
2. 📦 Offering Spawns - A chest appears with specific item requirements
3. ⚔️ Horde Attacks - Enhanced mobs spawn to pressure players
4. ⏰ Race Against Time - 30 minutes to gather and deliver items
5. 🏆 Success or Consequences - Rewards for success, chaos for failure

Craft a chest to delay the next horde by 30 minutes!:

🛠️ Crafting Recipe:

[Iron] [Iron] [Iron]
[Iron] [Chest] [Iron]
[Iron] [Iron] [Iron]
= 1x Bounty Box

⚡ Strategic Mechanics:

• ⏰ Fixed 30-Minute Extension: Provides exactly 30 minutes of additional time
• 🚫 Non-Stackable: Only one bounty box can be active per event
• 📍 Placement Strategy: Must be placed in loaded chunks to function properly
• ✨ Visual Indicators: Creates unique spiral particle effects when active
• 💥 Destruction Fallback: If destroyed, provides 3-minute emergency timer
• 🎯 Optimal Timing: Best used when 5-10 minutes remain on main timer

💡 Pro Tips:

• Protect with defensive structures to prevent mob destruction
• Coordinate with team before placement for maximum effectiveness
• Use as last resort when resources are almost complete but time is short
• Use to pause horde spawning for long outings (take one with you just in case!)

• Smart Spawning: Mobs appear 20-40 blocks away for tactical engagement
• Damage Feedback: Real-time action bar showing damage dealt and mob HP
• Progressive Difficulty: Harder challenges as players improve
• Sleep Prevention: Players cannot sleep during events (spawn point setting still works)
• Team Coordination: Multiple players face proportionally larger hordes

The plugin intelligently adjusts challenge based on:

• Player Count: More players = more mobs (20% per player, capped at 100%)
• Equipment Quality: Better gear = tougher challenges
• Experience Levels: Higher XP = increased difficulty
• Time Progression: Events get harder over time

• 🛏️ Sleep Prevention System: Players cannot sleep during events but can still set spawn points
• 🛡️ Enhanced Block Protection: Improved offering chest protection with better security
• 🚨 Emergency Cleanup: Enhanced cleanup methods for safer plugin removal
• ⚙️ Configuration Expansion: Added comprehensive sleep prevention options
• 🔍 Debug System: New debug options for chest protection and sleep systems
• 📜 MIT License: Changed from GPL to MIT for broader compatibility
• 🔧 Version Compatibility: Improved spawn point setting with fallback methods

• Memory Management: Bounded collections with LRU eviction
• Thread Safety: All concurrent operations properly synchronized
• API Updates: Fixed deprecated methods for modern Minecraft
• Spawn Optimization: Better distance calculations for balanced gameplay

• 📖 Complete Wiki - Comprehensive guide to everything
• ⚙️ Configuration - Detailed setup options
• 🖥️ Commands & Permissions - Complete command reference
• 🎮 Gameplay Guide - Strategies and tips
• 👑 Admin Guide - Server management tools
• 🔧 Troubleshooting - Common issues and solutions
• 🔌 API Documentation - Developer integration guide

• 🏺 Understanding Offerings
• ⚔️ Combat Strategies
• 📊 Difficulty System
• 🖥️ GUI Control Panel
• 💾 Memory Management

• Battery Saver: Low-end servers (minimal particles, reduced spawns)
• Balanced: Standard servers (optimal experience)
• Performance: High-end servers (maximum features)
• Gun Mod: Enhanced intensity for weapon mods

• 🐛 Bug Reports - Found a problem? Let us know!
• 💡 Feature Requests - Suggest improvements
• ❓ Discussions - Ask questions, share experiences
• 📧 Direct Contact - For urgent issues or private concerns

We welcome contributions! Check out our Contributing Guide for:

• 🐛 Bug fixes and improvements
• 📝 Documentation updates
• 🌐 Translations
• 💡 Feature development

• ⭐ Stars: Growing community support
• 🍴 Forks: Active development contributions
• 📥 Downloads: 10,000+ satisfied server owners
• 🔄 Updates: Regular releases with new features

• Sleep Prevention System: Strategic night mechanics with spawn point preservation
• Enhanced Block Protection: Improved offering chest security system
• Emergency Cleanup: Enhanced plugin removal safety
• MIT License: Broader compatibility and easier integration

• Combat Enhancement: Real-time damage feedback and spawn optimization
• Balance Updates: Refined difficulty and reward systems
• Compatibility: Java 17-21+ and Minecraft 1.18.2-1.21.5

• GUI Overhaul: Complete interface redesign
• Admin Controls: Advanced management tools
• Difficulty System: 9-level progression system

View Full Changelog

Wonderfully Evil (Minecraft: RyanEthos & ImLadyDeath)

• Expert team in cooperative Minecraft plugin development
• Creators of immersive AI-driven gameplay experiences
• Dedicated to the Minecraft community since 2024
• Specializing in innovative challenge mechanics

This project is licensed under the MIT License - see the LICENSE file for details.

• Minecraft Community: For inspiration and feedback
• Server Owners: For testing and suggestions
• Contributors: For improvements and bug fixes
• Plugin Developers: For compatibility insights