🔥 Divine Hordes - The Ultimate Hordes Plugin 🔥

⚡ Transform your server into an epic battleground where players unite against divine wrath! ⚡

A divine entity demands offerings from players, spawning enhanced hordes when demands aren't met. Can your players work together to survive the divine judgment?

🚀 PLUG & PLAY - WORKS INSTANTLY ON ANY SERVER

🔫 Gun Mod Ready | 🗡️ Vanilla Perfect | 👥 Auto-Scaling | ⚙️ Zero Setup

Divine Hordes Banner

🌟 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

One-click toggle for gun servers
75% more mobs, enhanced stats
Specialized for powerful weapons

🗡️ Vanilla Optimized

Perfect balance for vanilla
Progressive difficulty scaling
Standard Minecraft weapons

🚀 Plug & Play

Zero configuration required
Auto-scales 1-100+ players
Works instantly out-of-box

🎯 What Makes Us Different

🎭 AI Divine Personality

124+ unique taunting messages
6 distinct personality categories
Contextual responses to player actions

🧠 Adaptive Intelligence

Real-time difficulty scaling
Equipment & experience aware
Progressive mob enhancement

🛡️ Production Ready

Complete memory management
Thread-safe operations
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

📢 Listen for Divine Demands: The Divine One announces required offerings every 5-35 minutes
📦 Find the Offering Chest: Use compass navigation and GUI teleportation to locate the glowing chest
⚔️ Survive the Hordes: Enhanced mobs spawn immediately—work with your team to survive
🏺 Deliver Items: Collect and deposit the required materials before time runs out
🎉 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

📥 Download the latest divine-hordes-2.6.0.jar
📁 Place in your server's plugins/ folder
🔄 Restart your server
⚙️ Configure via GUI (/dh) or edit config.yml
🎉 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

Run /dh emergency before uninstalling
Wait for "cleanup completed" message
Remove plugin file and restart server
Zero remnants left behind!

🎭 Experience the Divine Challenge Today!

Divine Hordes transforms ordinary Minecraft servers into epic cooperative battlegrounds where players must unite against supernatural forces. With AI-driven personality, adaptive difficulty, and production-grade performance, it's the ultimate challenge plugin for servers seeking unforgettable multiplayer experiences.

🏆 Join Thousands of Players Already Experiencing Divine Judgment!

🔥 Why Divine Hordes?

🎮 Instant Engagement: Events start within 5-35 minutes of installation
🧠 Zero Learning Curve: Intuitive GUI system guides players naturally
⚡ Performance Optimized: Built for servers of any size without lag
🛡️ Production Tested: Zero memory leaks, complete cleanup systems
🎯 Highly Configurable: Adapt every aspect to your server's style
👥 Community Builder: Foster cooperation and team coordination

Made with Love

Divine Hordes v2.6.0 - Where mortals prove their worth against divine wrath!

Created with ❤️ by Wonderfully Evil (RyanEthos & ImLadyDeath)

📧 Support available through standard Minecraft plugin channels
🌟 Rate and review to help other server owners discover this plugin!