🔥 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

🔫 Gun Mod Ready	🗡️ Vanilla Optimized	🚀 Plug & Play
One-click toggle for gun servers	Perfect balance for vanilla	Zero configuration required
75% more mobs, enhanced stats	Progressive difficulty scaling	Auto-scales 1-100+ players
Specialized for powerful weapons	Standard Minecraft weapons	Works instantly out-of-box

🎯 What Makes Us Different

🎭 AI Divine Personality	🧠 Adaptive Intelligence	🛡️ 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

• Smart Requirements: Randomized item demands with history tracking to prevent repetition
• Tier-Based Difficulty: Easy (logs, stone) → Legendary (diamonds, emeralds)
• 💎 Rare Item Protection: 100+ irreplaceable items protected from offerings
• XP-Based Changes: Players can negotiate different offerings for experience points
• Variety Guarantee: Advanced system prevents duplicate offerings between events

⚔️ Enhanced Horde Mechanics

• Progressive Difficulty: Mobs spawn 20-40 blocks away with strategic spawn distances
• Real-Time Combat Feedback: Action bar displays exact damage dealt and remaining HP
• Daylight Immunity: Divine mobs survive in sunlight with divine protection
• Speed Scaling: Mobs move 60-70% speed early game, reaching normal speed at Nightmare difficulty
• Smart Restrictions: Dangerous mobs like ravagers blocked until appropriate difficulty levels
• Sleep Prevention: 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)

• Dynamic Calculation: Based on player equipment, experience, and time progression
• Player Separation: Player count affects mob quantity, not individual difficulty
• Admin Override: 9 manual difficulty levels plus automatic dynamic mode
• Real-Time Adaptation: Difficulty adjusts every 30 seconds based on current conditions

🖥️ Comprehensive GUI System

• All-in-One Dashboard: Complete control panel accessible via /dh
• Real-Time Statistics: Live event status, difficulty monitoring, and performance metrics
• Admin Tools: 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. 📢 Listen for Divine Demands: The Divine One announces required offerings every 5-35 minutes
2. 📦 Find the Offering Chest: Use compass navigation and GUI teleportation to locate the glowing chest
3. ⚔️ Survive the Hordes: Enhanced mobs spawn immediately—work with your team to survive
4. 🏺 Deliver Items: 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

⚡ 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!)

🌙 Strategic Night Mechanics

• Sleep Prevention: Players cannot sleep during active Divine Horde events
• Spawn Point Setting: Beds still work to set respawn locations during events
• Tactical Pressure: 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

• 📈 Live Statistics: Events participated, completion rate, XP spent, items offered
• 🧭 Real-Time Navigation: Distance and direction to offering chest with compass targeting
• 💫 Teleportation System: Distance-based XP costs (1-5 levels depending on range)
• 📚 Interactive Tutorials: 12+ page comprehensive guide system
• ⚙️ Personal Settings: Notification preferences, particle controls, GUI themes

🛠️ Admin Control Panel

• 🎯 Difficulty Override: 9 levels + Dynamic mode with instant switching
• 🔄 Play Mode Toggle: Normal vs Gun Mod with specialized mob scaling
• 📊 Real-Time Monitoring: Memory usage, TPS impact, entity counts
• 🚨 Emergency Controls: One-click cleanup, system shutdown, emergency override
• 📈 Performance Metrics: Live server performance and resource utilization

---

⚙️ Advanced Configuration

🔥 Dual Intensity Modes - ONE-CLICK TOGGLE

🔫 Gun Mod Mode (Instant Switch)

• 🎯 Optimized for gun mod servers - MrCrayfish's Gun Mod, Vic's Modern Warfare, etc.
• ⚡ 75% more mobs with enhanced health and damage scaling
• 🔥 Reduced restrictions for intense ranged combat
• 💪 Perfect for powerful weapons and action-oriented gameplay
• ⚙️ Admin GUI toggle - switch modes instantly without restart

🗡️ Vanilla Mode (Default - Instant Switch)

• 🛡️ Perfectly balanced for standard Minecraft gameplay
• 📈 Progressive difficulty with safety restrictions for new players
• 🏗️ Building-friendly with strategic combat challenges
• ⚙️ Admin GUI toggle - switch modes instantly without restart

🚀 PLUG & PLAY FEATURES:

• 📦 Zero Setup Required - Works perfectly out-of-the-box
• 👥 Auto-Scaling - Automatically adjusts for 1-100+ players
• ⚙️ Live Configuration - 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]

• ⏰ 30-Minute Delay: Purchase additional time when running low
• 💎 Strategic Cost: Valuable items based on server progression
• ✨ Visual Effects: Unique spiral particle effects mark active boxes

---

🔌 Integration & Compatibility

📋 System Requirements

• ☕ Java: 17-21+ (Latest LTS recommended)
• 🎮 Minecraft: 1.18.2 - 1.21.6
• 🖥️ Server: Bukkit, Spigot, Paper (Paper recommended)
• 💾 Memory: 2GB minimum (4GB+ recommended)

🔗 Dependencies

• 📊 PlaceholderAPI: 33+ placeholders for external plugin integration

🌐 PlaceholderAPI Support

%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

• 🔄 Bounded Collections: LRU eviction prevents memory growth
• 🧹 Auto-Cleanup: Every 30 seconds with configurable thresholds
• 📊 Real-Time Monitoring: GUI-based memory stats and optimization
• 🔒 Thread Safety: All operations properly synchronized
• 🚨 Leak Prevention: Comprehensive cleanup on plugin removal

⚡ Performance Optimization

• 🔀 Async Operations: Non-blocking file I/O and database operations
• ✨ Particle Batching: Efficient rendering with 5 density levels
• 📦 Entity Limits: Configurable caps prevent server overload
• 🎯 Smart Spawning: Optimized spawn algorithms with distance controls
• 📈 TPS Monitoring: Real-time server performance tracking

---

🎉 What's New in v2.6.0

🌟 Major Features

• ✅ 💎 Rare Item Protection: 100+ items (dragon eggs, elytras, netherite) protected from offerings
• ✅ 🏔️ Underground Player Support: Full event participation for cave dwellers with smart spawning
• ✅ 🖥️ GUI Experience Improvements: Cleaner layout with better information flow
• ✅ 🎲 Smart Fallback System: Automatic fair alternatives when all tier items are protected
• ✅ 😄 New Divine Messages: 7 humorous responses for underground spawn failures
• ✅ 🔄 Auto-Retry System: Failed spawns retry automatically after 5 minutes
• ✅ ⚙️ Enhanced Configuration: New underground spawning options in config.yml

🛠️ Technical Improvements

• ✅ New RareItemFilter Class: Efficient HashSet-based item protection system
• ✅ Enhanced Underground Detection: Better player position analysis and spawning logic
• ✅ Dynamic Distance Scaling: Progressive reduction (100→80→60→40→20→10 blocks)
• ✅ 100% Backwards Compatible: No migration needed, drop-in replacement
• ✅ Optimized Performance: Faster item lookups and spawn location finding
• ✅ Minecraft 1.21.6 Ready: Forward compatible with upcoming 1.21.6 release

---

🏆 Perfect For

🎯 Server Types

• 🏘️ Survival Servers: Add cooperative challenges without disrupting building
• ⚔️ PvP Servers: Unite players against common threats
• 🔫 Gun Mod Servers: Enhanced difficulty mode for powerful weapons
• 👥 Community Servers: Foster teamwork and social interaction
• 🎪 Event Servers: Scheduled challenges and competitions

👥 Player Counts

• 🏠 Small (1-10 players): Intimate cooperative experiences
• 🏙️ Medium (10-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

• Event Start (23 messages) - "Ah, my favorite mortals! Time for your divine tax payment..."
• Mid-Event (20 messages) - "Tick tock, mortals! Time waits for no one..."
• Offering Changes (18 messages) - "Ooh, plot twist! Iron Ingots instead? Absolutely riveting..."
• Success (22 messages) - "Well, well... you actually managed it. Color me surprised!"
• Failure (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

• Sweet Berry Bushes: Create maze-like paths to slow mobs
• Cactus Walls: Deal passive damage to approaching enemies
• Magma Block Floors: Constant fire damage to ground mobs
• Lava Moats: 2-3 block wide defensive perimeters

🏗️ Advanced Fortification Designs

• The Fortress Layout: Complete defensive perimeter with multiple layers
• Chokepoint Strategy: Single entrance with concentrated firepower
• Floating Island Defense: 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

• 📚 Complete Documentation: Comprehensive guides included with plugin
• 🔧 Built-in Tutorials: Interactive 12+ page tutorial system
• 💬 Command Help: Detailed /dh help system
• 📊 Debug Tools: Built-in diagnostic commands and GUI monitoring

🌟 Community Features

• 📈 Statistics Tracking: Comprehensive player performance metrics
• 🏆 Achievement System: Recognition for consistent participation
• 📊 Leaderboards: Track top performers and team statistics
• 🎪 Event Scheduling: Flexible timing for peak player engagement

---

🚀 Quick Installation

1. 📥 Download the latest divine-hordes-2.6.0.jar
2. 📁 Place in your server's plugins/ folder
3. 🔄 Restart your server
4. ⚙️ Configure 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

✅ 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!

---