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.