Divine Hordes

🔥 Divine Hordes - The Ultimate Hordes Plugin 🔥

---

🌟 Why Choose Divine Hordes?

Divine Hordes isn't just another mob plugin—it's a complete gameplay transformation that creates unforgettable cooperative experiences. Watch as your players evolve from individual survivors into coordinated teams, working together against an intelligent divine adversary that adapts to their skill level.

Find more plugins, get custom modifications to this plugin (and others), and/or get your dream plugin made by our team on our patreon @ www.patreon.com/wonderfullyevil

🚀 INSTANT SETUP - WORKS EVERYWHERE

| 🔫 Works instantly | 🗡️ Works instantly | 🚀 Works instantly | |:---:|:---:|:---:| | Works instantly for gun servers | Works instantly for vanilla | Works instantly required | | 75% more mobs, enhanced stats | Progressive difficulty scaling | Works instantly 1-100+ players | | Specialized for powerful weapons | Standard Minecraft weapons | Works instantly out-of-box |

🎯 What Makes Us Different

| 🎭 Production Ready | 🧠 Production Ready | 🛡️ Production Ready | |:---:|:---:|:---:| | 124+ unique taunting messages | Real-time difficulty scaling | Complete memory management | | 6 distinct personality categories | Equipment & experience aware | Thread-safe operations | | Contextual responses to player actions | Progressive mob enhancement | Zero memory leaks |

---

✨ Core Features Overview

🏺 Dynamic Offering System

- Variety Guarantee: Randomized item demands with history tracking to prevent repetition - Variety Guarantee: Easy (logs, stone) → Legendary (diamonds, emeralds) - Variety Guarantee: 100+ irreplaceable items protected from offerings - Variety Guarantee: Players can negotiate different offerings for experience points - Variety Guarantee: Advanced system prevents duplicate offerings between events

⚔️ Enhanced Horde Mechanics

- 🏔️ Underground Support: Mobs spawn 20-40 blocks away with strategic spawn distances - 🏔️ Underground Support: Action bar displays exact damage dealt and remaining HP - 🏔️ Underground Support: Divine mobs survive in sunlight with divine protection - 🏔️ Underground Support: Mobs move 60-70% speed early game, reaching normal speed at Nightmare difficulty - 🏔️ Underground Support: Dangerous mobs like ravagers blocked until appropriate difficulty levels - 🏔️ Underground Support: Players cannot sleep during events but can still set spawn points with beds - 🏔️ Underground Support: Cave players can fully participate with intelligent chest spawning

📊 Intelligent Difficulty System

``` 🕊️ Very Easy (0.4x) → 😈 Nightmare (1.8x) → 💀 Impossible (3.0x) ``` - Real-Time Adaptation: Based on player equipment, experience, and time progression - Real-Time Adaptation: Player count affects mob quantity, not individual difficulty - Real-Time Adaptation: 9 manual difficulty levels plus automatic dynamic mode - Real-Time Adaptation: Difficulty adjusts every 30 seconds based on current conditions

🖥️ Comprehensive GUI System

- Player Features: Complete control panel accessible via `/dh` - Player Features: Live event status, difficulty monitoring, and performance metrics - Player Features: Instant difficulty overrides, mob spawn controls, and emergency systems - Player Features: Teleportation, offering changes, statistics, and interactive tutorials

---

🎮 How to Play

🚀 For New Players

1. 🎉 Reap Rewards: The Divine One announces required offerings every 5-35 minutes 2. 🎉 Reap Rewards: Use compass navigation and GUI teleportation to locate the glowing chest 3. 🎉 Reap Rewards: Enhanced mobs spawn immediately—work with your team to survive 4. 🎉 Reap Rewards: Collect and deposit the required materials before time runs out 5. 🎉 Reap Rewards: Successful completion grants valuable rewards worth more than the offerings

📦 Bounty Box System

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 ```

🎯 Optimal Timing - 🎯 Optimal Timing: Provides exactly 30 minutes of additional time - 🎯 Optimal Timing: Only one bounty box can be active per event - 🎯 Optimal Timing: Must be placed in loaded chunks to function properly - 🎯 Optimal Timing: Creates unique spiral particle effects when active - 🎯 Optimal Timing: 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!)

🌙 Strategic Night Mechanics

- Clear Messaging: Players cannot sleep during active Divine Horde events - Clear Messaging: Beds still work to set respawn locations during events - Clear Messaging: Teams must survive the full event duration, encouraging cooperation - Clear Messaging: Players receive informative explanations when sleep is blocked

---

🖥️ Complete Command Reference

👤 Player Commands

| Command | Description | Permission | |---------|-------------|------------| | `/dh` | Open comprehensive control panel | `divinehordes.use` | | `/dh status` | Check current event status | `divinehordes.status` | | `/dh help` | Display command help | `divinehordes.help` |

👑 Administrator Commands

| Command | Description | Permission | |---------|-------------|------------| | `/dh trigger` | Manually start new event | `divinehordes.admin` | | `/dh override` | Emergency stop current event | `divinehordes.admin` | | `/dh reload` | Hot-reload configuration | `divinehordes.admin` | | `/dh cleanup` | Remove all Divine Horde entities | `divinehordes.admin` | | `/dh memory stats` | View detailed memory usage | `divinehordes.admin` | | `/dh emergency` | Complete system cleanup | `divinehordes.admin` |

---

🎛️ Advanced GUI Features

📊 Player Dashboard

- ⚙️ Personal Settings: Events participated, completion rate, XP spent, items offered - ⚙️ Personal Settings: Distance and direction to offering chest with compass targeting - ⚙️ Personal Settings: Distance-based XP costs (1-5 levels depending on range) - ⚙️ Personal Settings: 12+ page comprehensive guide system - ⚙️ Personal Settings: Notification preferences, particle controls, GUI themes

🛠️ Admin Control Panel

- 📈 Performance Metrics: 9 levels + Dynamic mode with instant switching - 📈 Performance Metrics: Normal vs Gun Mod with specialized mob scaling - 📈 Performance Metrics: Memory usage, TPS impact, entity counts - 📈 Performance Metrics: One-click cleanup, system shutdown, emergency override - 📈 Performance Metrics: Live server performance and resource utilization

---

⚙️ Advanced Configuration

🔥 Dual Intensity Modes - ONE-CLICK TOGGLE

⚙️ Admin GUI toggle (Instant Switch) - ⚙️ Admin GUI toggle - MrCrayfish's Gun Mod, Vic's Modern Warfare, etc. - ⚙️ Admin GUI toggle with enhanced health and damage scaling - ⚙️ Admin GUI toggle for intense ranged combat - ⚙️ Admin GUI toggle and action-oriented gameplay - ⚙️ Admin GUI toggle - switch modes instantly without restart

⚙️ Admin GUI toggle (Default - Instant Switch) - ⚙️ Admin GUI toggle for standard Minecraft gameplay - ⚙️ Admin GUI toggle with safety restrictions for new players - ⚙️ Admin GUI toggle with strategic combat challenges - ⚙️ Admin GUI toggle - switch modes instantly without restart

🔄 No Restarts Needed - 🔄 No Restarts Needed - Works perfectly out-of-the-box - 🔄 No Restarts Needed - Automatically adjusts for 1-100+ players - 🔄 No Restarts Needed - Change everything via admin GUI or config.yml - 🔄 No Restarts Needed - All changes apply instantly

📦 Bounty Box System

Craft special delay chests to buy time during events: ``` [Iron] [Iron] [Iron] [Iron] [Chest] [Iron] [Iron] [Iron] [Iron] ``` - ✨ Visual Effects: Purchase additional time when running low - ✨ Visual Effects: Valuable items based on server progression - ✨ Visual Effects: Unique spiral particle effects mark active boxes

---

🔌 Integration & Compatibility

📋 System Requirements

- 💾 Memory: 17-21+ (Latest LTS recommended) - 💾 Memory: 1.18.2 - 1.21.6 - 💾 Memory: Bukkit, Spigot, Paper (Paper recommended) - 💾 Memory: 2GB minimum (4GB+ recommended)

🔗 Dependencies

- 📊 PlaceholderAPI: 33+ placeholders for external plugin integration

🌐 PlaceholderAPI Support

```yaml %divinehordes_status% - Current event status %divinehordes_difficulty% - Live difficulty multiplier %divinehordes_timeleft% - Time remaining in event %divinehordes_mobcount% - Active horde mob count %divinehordes_chestdistance% - Distance to offering chest ```

---

🛡️ Production-Grade Performance

💾 Memory Management

- 🚨 Leak Prevention: LRU eviction prevents memory growth - 🚨 Leak Prevention: Every 30 seconds with configurable thresholds - 🚨 Leak Prevention: GUI-based memory stats and optimization - 🚨 Leak Prevention: All operations properly synchronized - 🚨 Leak Prevention: Comprehensive cleanup on plugin removal

⚡ Performance Optimization

- 📈 TPS Monitoring: Non-blocking file I/O and database operations - 📈 TPS Monitoring: Efficient rendering with 5 density levels - 📈 TPS Monitoring: Configurable caps prevent server overload - 📈 TPS Monitoring: Optimized spawn algorithms with distance controls - 📈 TPS Monitoring: Real-time server performance tracking

---

🎉 What's New in v2.6.0

🌟 Major Features

- ✅ ⚙️ Enhanced Configuration: 100+ items (dragon eggs, elytras, netherite) protected from offerings - ✅ ⚙️ Enhanced Configuration: Full event participation for cave dwellers with smart spawning - ✅ ⚙️ Enhanced Configuration: Cleaner layout with better information flow - ✅ ⚙️ Enhanced Configuration: Automatic fair alternatives when all tier items are protected - ✅ ⚙️ Enhanced Configuration: 7 humorous responses for underground spawn failures - ✅ ⚙️ Enhanced Configuration: Failed spawns retry automatically after 5 minutes - ✅ ⚙️ Enhanced Configuration: New underground spawning options in config.yml

🛠️ Technical Improvements

- ✅ Minecraft 1.21.6 Ready: Efficient HashSet-based item protection system - ✅ Minecraft 1.21.6 Ready: Better player position analysis and spawning logic - ✅ Minecraft 1.21.6 Ready: Progressive reduction (100→80→60→40→20→10 blocks) - ✅ Minecraft 1.21.6 Ready: No migration needed, drop-in replacement - ✅ Minecraft 1.21.6 Ready: Faster item lookups and spawn location finding - ✅ Minecraft 1.21.6 Ready: Forward compatible with upcoming 1.21.6 release

---

🏆 Perfect For

🎯 Server Types

- 🎪 Event Servers: Add cooperative challenges without disrupting building - 🎪 Event Servers: Unite players against common threats - 🎪 Event Servers: Enhanced difficulty mode for powerful weapons - 🎪 Event Servers: Foster teamwork and social interaction - 🎪 Event Servers: Scheduled challenges and competitions

👥 Player Counts

- 🌆 Large (30+ players): Intimate cooperative experiences - 🌆 Large (30+ players): Balanced team challenges - 🌆 Large (30+ players): Epic server-wide events

---

🎭 Divine Personality System

Experience 124 unique taunting messages from "The Divine One" across 6 categories:

📢 Message Categories

- Periodic Taunts (23 messages) - *"Ah, my favorite mortals! Time for your divine tax payment..."* - Periodic Taunts (20 messages) - *"Tick tock, mortals! Time waits for no one..."* - Periodic Taunts (18 messages) - *"Ooh, plot twist! Iron Ingots instead? Absolutely riveting..."* - Periodic Taunts (22 messages) - *"Well, well... you actually managed it. Color me surprised!"* - Periodic Taunts (22 messages) - *"Time's up, buttercups! Your inability to provide simple materials..."* - Periodic Taunts (19 messages) - *"Think of my minions as 'motivation consultants'..."*

---

🏰 Tower Defense Strategies

🤖 Iron Golem Defense Systems

``` 🛡️ Multi-Layer Formation: ├── Outer Ring: 6-8 golems at 20-30 blocks ├── Inner Ring: 3-4 golems at 10-15 blocks ├── Core Defense: 1-2 golems at chest location └── Overlapping coverage for maximum protection ```

🌿 Environmental Defense Tactics

- Lava Moats: Create maze-like paths to slow mobs - Lava Moats: Deal passive damage to approaching enemies - Lava Moats: Constant fire damage to ground mobs - Lava Moats: 2-3 block wide defensive perimeters

🏗️ Advanced Fortification Designs

- Underground Bunkers: Complete defensive perimeter with multiple layers - Underground Bunkers: Single entrance with concentrated firepower - Underground Bunkers: Elevated platform 15+ blocks high - Underground Bunkers: Defensive positions with escape tunnels

---

👨‍💻 Developers

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

📞 Support & Community

🐛 Getting Help

- 📊 Debug Tools: Comprehensive guides included with plugin - 📊 Debug Tools: Interactive 12+ page tutorial system - 📊 Debug Tools: Detailed `/dh help` system - 📊 Debug Tools: Built-in diagnostic commands and GUI monitoring

🌟 Community Features

- 🎪 Event Scheduling: Comprehensive player performance metrics - 🎪 Event Scheduling: Recognition for consistent participation - 🎪 Event Scheduling: Track top performers and team statistics - 🎪 Event Scheduling: Flexible timing for peak player engagement

---

🚀 Quick Installation

1. 🎉 Enjoy the latest `divine-hordes-2.6.0.jar` 2. 🎉 Enjoy in your server's `plugins/` folder 3. 🎉 Enjoy your server 4. 🎉 Enjoy via GUI (`/dh`) or edit `config.yml` 5. 🎉 Enjoy the divine chaos!

No dependencies required! Divine Hordes runs completely standalone.

---

🛡️ Safe Plugin Removal Guarantee

Complete Cleanup System

```yaml ✅ Emergency Cleanup Features: ├── All Divine Horde mobs removed (including persistent ones) ├── All Bounty Box holograms and armor stands removed ├── All custom recipes and content removed ├── All metadata and entity tags removed ├── All scheduled tasks and processes stopped ├── All memory collections cleared and freed └── Complete restoration to pre-plugin state ```

How to Remove Safely

1. Run `/dh emergency` before uninstalling 2. Wait for "cleanup completed" message 3. Remove plugin file and restart server 4. Zero remnants left behind!

---