Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
✨ Key Features
YAML-Based Custom Mobs
Define mobs entirely via YAML
Including Custom Heads with Base64 String
Clean and predictable configuration structure
Custom stats, attributes and equipmen
Boss System with Phases
Spoiler
Multi-phase bosses based on HP percentage
Minion support
BossBar integration
Phase messages, effects and abilities
Radar & Navigation HUD
Player-specific BossBar HUD
Directional compass display
Detects nearby mobs within a radius
Priority-based threat detection
⏱ Auto-Spawn System
Spoiler
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
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 (v1.5)
TheMob v1.5 has been tested under real server conditions with the following results:
✔ 20+ concurrent players
✔ 400+ active custom mobs
✔ Multiple bosses running simultaneously
✔ Stable TPS on Paper 1.21.10
✔ No forced chunk loading
✔ No spawn refill abuse or AFK farming
The system remains stable during:
Player joins & leaves
Boss phase transitions
Auto-spawn hot/cold state changes
/mob reload without server restart
Commands (v1.5)
Core Commands
/mob reload
/mob spawn <mob-id>
/mob killall
/stats
Auto-Spawn Management
/mob set autospawn <mob-id> <seconds> <maxSpawns>
/mob set randomradius <mob-id> <seconds> <maxSpawns> <minRadius> <maxRadius>
/mob set followplayer <player> <mob-id> <seconds> <maxSpawns> <onetime/endless> <minDistance> <maxDistance> <message>
/mob set randomworld <mob-id> <seconds> <maxSpawns> <onetime/endless> <message-timer> <message>
Deleting Spawns
/mob del autospawn <mob-id>
/mob del randomradius <mob-id>
/mob del followplayer <player> <mob-id>
/mob del randomworld <world> <mob-id>
Listing & Utilities
/mob list autospawn
/mob list all
/mob toggle hud
Legacy Alias (still supported)
/mob autospawn <mob-id> <seconds> <maxSpawns>
Permissions (v1.5)
Permission Description
themob.spawn Manually spawn custom mobs
themob.spawn.set Create, delete and manage auto-spawns
themob.killall Remove all custom mobs instantly
themob.reload Reload TheMob without server restart
themob.stats Open the player stats GUI (optional/future use)
✔ Permissions are cleanly separated
✔ Safe for admin / moderator delegation
✔ No permission required for basic player features (Stats GUI, HUD toggle)
Example Configuration
mob-id: zombie_boss
type: ZOMBIE
stats:
health: 500
damage: 12
phases: # This will count the mob as a Boss
phase_2:
at-health: 50
effects:
- INCREASE_DAMAGE
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
server-ip=5.189.130.253 server-port=31185 Version: Paper 26.3 Mode: PvE / Test Environment
If you value control, performance and scalability, this plugin is for you.
Thanks for over 800 downloads! ❤️
If you test this plugin on a live server, I’d love to hear feedback or suggestions.