DivineHordes

🔥 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.

🚀 INSTANT SETUP - WORKS EVERYWHERE

🎯 What Makes Us Different

✨ Core Features Overview

🏺 Dynamic Offering System

• Smart Requirements: Randomized item demands with history tracking to prevent repetition
• Tier-Based Difficulty: Easy (logs, stone) → Legendary (netherite, dragon eggs)
• XP-Based Changes: Players can negotiate different offerings for experience points
• Variety Guarantee: Advanced system prevents duplicate offerings between events

📊 Comprehensive Player Statistics

• Real-Time Tracking: Monitor every player action during Divine Horde events
• Performance Metrics: Events participated/completed, success rates, mob kills
• Resource Management: XP spent, offerings changed, items offered
• Strategic Insights: Deaths, teleports used, top offered items
• Persistent Data: All stats saved and displayed in the GUI

⚔️ 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

📊 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

🖥️ Complete Command Reference

👤 Player Commands

👑 Administrator Commands

🎛️ Advanced GUI Features

📊 Player Dashboard

• 📈 Live Statistics: Comprehensive tracking with persistent data storage:
  • Events participated/completed with success rate percentage
  • Offerings changed and total XP spent across all activities
  • Teleports used and mobs killed during events
  • Deaths during events for survival tracking
  • Top 5 most offered items with quantities
  • Average XP spent per completed event
• 🧭 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
• 👁️ Overlay Display Toggle: Customize your on-screen experience:
  • Always On: Show countdown timers and all overlays continuously (default)
  • During Hordes Only: Display overlays only during active events for focused gameplay
  • Always Off: Clean interface with no Divine Hordes overlays for minimalist players

🛠️ 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)

🔗 Optional Integrations

• 📊 PlaceholderAPI: 33+ placeholders for external plugin integration
• 🛡️ WorldGuard: Region protection and spawn restrictions
• 👥 Citizens: NPC integration for divine representation
• 📈 Performance Monitoring: Built-in TPS and memory tracking

🌐 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.5.0

🔧 Major Improvements

• ✅ Real-Time Health Bar Updates: Fixed health bars above mobs to update immediately when damaged
• ✅ Player Data Persistence: Complete login/logout data preservation
• ✅ Progressive Speed Scaling: Strategic mob movement from 60% → 100% speed
• ✅ Ravager Restrictions: Balanced progression with difficulty-gated dangerous mobs
• ✅ Enhanced Combat Feedback: Action bar damage indicators with HP percentages
• ✅ Sleep Prevention System: Players cannot skip the night during events but can set spawn points
• ✅ Fair Reward Distribution: All players now receive identical rewards when completing events
• ✅ Smart Reward Variety: Reward history prevents consecutive duplicate rewards
• ✅ Increased Reward Value: Rewards now guaranteed to be worth 1.5x offering value (up from 1.3x)
• ✅ Bounty Box Duplication Fix: Fixed critical bug where breaking bounty boxes would duplicate items

🛠️ Technical Updates

• ✅ Java 17-21+ Compatibility: Forward compatibility across modern Java versions
• ✅ API Modernization: Fixed deprecated method warnings for Minecraft 1.18+
• ✅ Memory Optimization: Complete bounded collections with LRU eviction
• ✅ Thread Safety: All concurrent operations properly synchronized
• ✅ Production Ready: Zero memory leaks with comprehensive cleanup systems
• ✅ MIT License: Open source with minimal restrictions for easy integration and modification

🏆 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.5.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!