TheMob is a high-performance custom mob and boss system for Paper / Spigot servers.
It allows you to create powerful custom mobs and multi-phase bosses using simple YAML configuration files – no coding required.
The plugin is designed for RPG servers, events, dungeons and PvE-focused gameplay, with a strong focus on performance and scalability.
Language & Customization
TheMob is fully English by design.
All player-facing texts (titles, phase names, descriptions, boss bars, messages) are defined in configuration files.
This allows server owners to fully localize, rename, or redesign bosses to fit their server’s language and lore.
TheMob is fully English by design.
All player-facing texts (titles, phase names, descriptions, boss bars, messages) are defined in configuration files.
This allows server owners to fully localize, rename, or redesign bosses to fit their server’s language and lore.
✨ Key Features
YAML-Based Custom Mobs
Spoiler: Video
Templates
Boss System with Phases
Spoiler: Pictures
![[IMG]](//proxy.spigotmc.org/3370b7b0b9f02e57271b535c34bce61af40579bf/68747470733a2f2f336f33792e676974626f6f6b2e696f2f7468652d6d6f622f7e676974626f6f6b2f696d6167653f75726c3d68747470732533412532462532463631343332353337312d66696c65732e676974626f6f6b2e696f25324625374525324666696c6573253246763025324662253246676974626f6f6b2d782d70726f642e61707073706f742e636f6d2532466f2532467370616365732532353246743436374556457766394c473056706646716e70253235324675706c6f616473253235324650336941514868737377334f4456724472313869253235324642502e706e67253346616c742533446d65646961253236746f6b656e25334438356231343032342d363430302d343336392d623832362d6135323836336264303262632677696474683d373638266470723d31267175616c6974793d313030267369676e3d64616632616139362673763d32)
![[IMG]](//proxy.spigotmc.org/6cf3d639f1ce41ad22bdd30c68ad368f93f9e807/68747470733a2f2f6d656469612e67697068792e636f6d2f6d656469612f75304a685341704e6437366c7867534b57312f67697068792e676966)
- Multi-phase bosses based on HP percentage
- Minion support
- BossBar integration
- Phase messages, effects and abilities
Spoiler: Picture
![[IMG]](//proxy.spigotmc.org/98e603774179e913e32545de01a093481e29b26f/68747470733a2f2f336f33792e676974626f6f6b2e696f2f7468652d6d6f622f7e676974626f6f6b2f696d6167653f75726c3d68747470732533412532462532463631343332353337312d66696c65732e676974626f6f6b2e696f25324625374525324666696c6573253246763025324662253246676974626f6f6b2d782d70726f642e61707073706f742e636f6d2532466f2532467370616365732532353246743436374556457766394c473056706646716e70253235324675706c6f61647325323532463749684b46784d734d6b3865347a6b324963574d2532353246323032352d31322d32365f31372e33322e34342e706e67253346616c742533446d65646961253236746f6b656e25334430313138653938342d663633652d343333662d613131632d3137343039376138616230632677696474683d373638266470723d31267175616c6974793d313030267369676e3d35636362373136352673763d32)
- Player-specific BossBar HUD
- Directional compass display
- Detects nearby mobs within a radius
- Priority-based threat detection
Spoiler: Pictures
![[IMG]](//proxy.spigotmc.org/69e077a621830b109097ff6112e78d8f364be525/68747470733a2f2f336f33792e676974626f6f6b2e696f2f7468652d6d6f622f7e676974626f6f6b2f696d6167653f75726c3d68747470732533412532462532463631343332353337312d66696c65732e676974626f6f6b2e696f25324625374525324666696c6573253246763025324662253246676974626f6f6b2d782d70726f642e61707073706f742e636f6d2532466f2532467370616365732532353246743436374556457766394c473056706646716e70253235324675706c6f616473253235324655623834373275517537647a476b504b564c614725323532466c6966656379636c652e706e67253346616c742533446d65646961253236746f6b656e25334430613339393264622d353632322d343666332d616534612d3963363933313730393531652677696474683d373638266470723d31267175616c6974793d313030267369676e3d32336361626131352673763d32)
![[IMG]](//proxy.spigotmc.org/98b53834ffa211f6e289a4718daf7116ce91731f/68747470733a2f2f336f33792e676974626f6f6b2e696f2f7468652d6d6f622f7e676974626f6f6b2f696d6167653f75726c3d68747470732533412532462532463631343332353337312d66696c65732e676974626f6f6b2e696f25324625374525324666696c6573253246763025324662253246676974626f6f6b2d782d70726f642e61707073706f742e636f6d2532466f2532467370616365732532353246743436374556457766394c473056706646716e70253235324675706c6f6164732532353246666b486d354f41477a796e334f64497a396249582532353246323032352d31322d32365f31372e30302e35392e706e67253346616c742533446d65646961253236746f6b656e25334466616465353735352d623130392d343536302d613339322d6462396535313736353162382677696474683d373638266470723d31267175616c6974793d313030267369676e3d36646663343862622673763d32)
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.
Spoiler: Pictures
![[IMG]](//proxy.spigotmc.org/015b0176f5949d3b8cfba622ebe25862bc1722bc/68747470733a2f2f696d616765732e676974626f6f6b2e636f6d2f5f5f696d672f6470723d322c77696474683d3736302c6f6e6572726f723d72656469726563742c666f726d61743d6175746f2c7369676e61747572653d313234353030333138352f687474707325334125324625324666696c65732e676974626f6f6b2e636f6d253246763025324662253246676974626f6f6b2d782d70726f642e61707073706f742e636f6d2532466f2532467370616365732532353246743436374556457766394c473056706646716e70253235324675706c6f616473253235324666685457564b3062354f673443386e5256706a55253235324656312e3525323532304c6f676f2e706e67253346616c742533446d65646961253236746f6b656e25334464353466393562322d383138332d346363322d613038362d376464663235666536313131)
![[IMG]](//proxy.spigotmc.org/8944b81c7d4329befc844cc662662d6c0c456001/68747470733a2f2f6d656469612e67697068792e636f6d2f6d656469612f4169714b4a334f4c7a4563646c52556230762f67697068792e676966)
- In-game stats menu
- No permissions required for basic access
- Player-friendly by default
- 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
Code (Text):
Core Commands
/mob reload
/mob spawn <mob-id>
/mob killall
/stats
Diagnostic Management
/mob diag status
/mob diag tps
/mob diag budgets
/mob diag throttle
/mob diag alive
/mob diag cooldown <boss-id>
/mob debug
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>
/mob egg <mob_key>
/mob spawner <amount>
Listing & Utilities
/mob list autospawn
/mob list all
/mob toggle hud
Legacy Alias (still supported)
/mob autospawn <mob-id> <seconds> <maxSpawns>
/mob reload
/mob spawn <mob-id>
/mob killall
/stats
Diagnostic Management
/mob diag status
/mob diag tps
/mob diag budgets
/mob diag throttle
/mob diag alive
/mob diag cooldown <boss-id>
/mob debug
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>
/mob egg <mob_key>
/mob spawner <amount>
Listing & Utilities
/mob list autospawn
/mob list all
/mob toggle hud
Legacy Alias (still supported)
/mob autospawn <mob-id> <seconds> <maxSpawns>
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
Code (Java):
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
type : ZOMBIE
stats :
health : 500
damage : 12
phases : # This will count the mob as a Boss
phase_2 :
at -health : 50
effects :
- INCREASE_DAMAGE
Full documentation available here
Includes:
- Installation guide
- Mob & boss configuration
- Radar system
- Commands & permissions
- Best practices
- Paper / Spigot 1.21.10
- Java 21 recommended
✔ 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
Thanks for the first 100 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: 176.57.168.247:36885
Version: Paper 1.21.10
Mode: PvE / Test Environment
Note:
This is a test server.
Configs, bosses and mechanics may change at any time.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
♂️ TheMob ✦ Advanced Custom Mobs & Bosses is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 310 times (via Spigot). Download it and open it directly in the game.