✨ Key Features

YAML-Based Custom Mobs

• Define mobs entirely via YAML
• Clean and predictable configuration structure
• Custom stats, attributes and equipmen

Boss System with Phases

• Multi-phase bosses based on HP percentage
• Minion support
• BossBar integration
• Phase messages, effects and abilities

Radar & Navigation HUD

Spoiler: Picture

• Player-specific BossBar HUD
• Directional compass display
• Detects nearby mobs within a radius
• Priority-based threat detection

⏱ Auto-Spawn System


Designed for performance and fairness

• Chunk-aware Hot / Cold Zone logic
• Spawns activate only when players enter
  
• Spawn cycles pause automatically when players leave
  
• Hard spawn limits (no refill spawning)
  Prevents:
  • Endless spawning
  • AFK farming
  • Kill-speed exploits
  • When players leave, the world rests.
  • When they return, it feels alive again.

Player Stats GUI

Spoiler: Pictures

• In-game stats menu
• No permissions required for basic access
• Player-friendly by default

⚡ Performance-First Design

• Event-driven logic (no global polling)
• Optimized for high player counts
• Radius-limited entity scans
• No forced chunk loading

Tested Scenarios
✔ 50+ players
✔ 300+ active custom mobs
✔ Multiple bosses running simultaneously
✔ Stable TPS on Paper 1.21.10

Commands

/mob reload
/mob spawn <mob-id>
/mob autospawn <mob-id> <interval> <max-alive>
/mob del autospawn <mob-id>
/mob killall
/stats
Permissions

• themob.spawn
• themob.spawn.set
• themob.killall
• themob.reload
• themob.stats

Permissions are cleanly separated and admin-safe.

Example Configuration
Documentation
Full documentation available here
Includes:

• Installation guide
• Mob & boss configuration
• Radar system
• Commands & permissions
• Best practices

⚙️ Requirements

• Paper / Spigot 1.21.10
• Java 21 recommended

Use Cases
✔ RPG Servers
✔ Boss Events
✔ Dungeons
✔ Hardcore / Purge Servers
✔ Custom PvE Content

Support & Feedback
This plugin is actively developed.
Feedback, bug reports and feature suggestions are welcome.

Final Notes
TheMob is built for server owners who want:

• Powerful custom mobs without coding
• Boss fights with real mechanics
• Strong performance
• Clean administration

If you value control, performance and scalability, this plugin is for you.

Thanks for the first downloads!
If you test this plugin on a live server, I’d love to hear feedback or suggestions.


Test Server

You can test TheMob live on our public test server:

IP: 213.136.84.139:27385
Version: Paper 1.21.10
Mode: PvE / Test Environment

Note:
This is a test server.
Configs, bosses and mechanics may change at any time.