The Mob

Overview 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. ✨ Key Features YAML-Based Custom Mobs

Define mobs entirely via YAML
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

Interval-based spawning
Safe for long-running servers
Maximum alive limits
Persistent auto-spawn state

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 ✔ 50+ players ✔ 300+ active custom mobs ✔ Multiple bosses running simultaneously ✔ Stable TPS on Paper 1.21.11

Commands

/mob reload /mob spawn /mob autospawn /mob del autospawn /mob killall /stats Permissions

themob.spawn
themob.spawn.set
themob.killall
themob.reload
themob.stats

Permissions are cleanly separated and admin-safe.

Example Configuration Code (Java): mob-id: zombie_boss type: ZOMBIE boss: true

stats: health: 500 damage: 12

phases: 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.11
Java 21 recommended

Use Cases ✔ RPG Servers ✔ Boss Events ✔ Dungeons ✔ Hardcore / Purge Servers ✔ Custom PvE Content

Changelog v1.0.0 – Initial Release Core

Initial release of TheMob
YAML-based custom mob system
Persistent mob registry

Boss System

Multi-phase bosses
BossBar integration
Phase-based effects and actions

Radar & HUD

Player-specific radar HUD
Directional compass display
Priority-based mob detection

Auto-Spawn

Interval-based auto-spawn system
Maximum alive limits
Persistent auto-spawn state

Player Features

Player stats GUI
Clean, non-intrusive UI

Performance

Event-driven architecture
No global entity polling
Optimized for large servers

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.