The Mob

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

Tebex | Github | Gitbook | Patreon

✨ 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

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

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

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

Thanks for the first 100 downloads! ❤️

If you test this plugin on a live server, I’d love to hear feedback or suggestions.