‍♂️ TheMob ✦ Advanced Custom Mobs & Bosses

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.

✨ Key Features

YAML-Based Custom Mobs

Video

Templates

Boss System with Phases

Pictures

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

Radar & Navigation HUD

Picture

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

⏱ Auto-Spawn System

Pictures

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

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 (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

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>

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.

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.