Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!

TheMob

High-Performance Mob Framework | YAML | Boss Phases | Smart AutoSpawns | 1.21.10

🔹 What is The Mob?

The Mob is a performance-focused custom mob & boss framework for Paper / Spigot 1.21.10.

It allows server owners to create custom mobs, multi-phase bosses and intelligent spawn systems using clean YAML configuration files, no scripting, no coding, no external dependencies.

Unlike traditional mob plugins, The Mob is built around control, lifecycle safety and server performance.

🎯 Design Philosophy

The Mob was built to solve common problems of mob plugins:

✔ Uncontrolled mob spawning

✔ TPS drops under load

✔ Script-heavy configurations

✔ Broken reloads & leftover mobs

✔ AFK farming & spawn abuse

Everything in The Mob is state-driven, predictable and reload-safe.

✨ Core Features 🧱 YAML-Based Custom Mobs

Define mobs entirely via YAML
Custom health, damage, attributes & equipment
Clean and predictable configuration structure
No scripting language required

👑 Boss System with Phases

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

Boss fights are mechanical, readable and fair — not random spam.

🧭 Radar & Navigation HUD

Player-specific BossBar HUD
Directional compass display
Priority-based threat detection
Helps players track bosses and encounters

⏱ Smart Auto-Spawn System

Designed for performance and fairness:

Chunk-aware hot / cold zone logic
Spawns activate only when players are nearby
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

Built-in in-game stats menu
No permissions required for basic access
Player-friendly by default

⚡ Performance-First Architecture

theMob is designed for long-running servers:

Event-driven logic (no global polling loops)
Radius-limited entity scans
No forced chunk loading
Clean entity lifecycle handling

🧪 Tested Under Real Load

Tested in live server environments:

✔ 20+ concurrent players

✔ 400+ active custom mobs

✔ Multiple bosses at the same time

✔ Stable TPS on Paper 1.21.10

✔ /mob reload without server restart

Stable during:

Player joins & leaves
Boss phase transitions
Auto-spawn hot/cold state changes

🛠 How to Use theMob

1️⃣ Installation

Drop theMob.jar into your plugins folder
Start your server (Paper / Spigot 1.21.10)
Java 21 recommended

2️⃣ Create a Custom Mob (YAML)

mob-id: zombie_boss
type: ZOMBIE

stats:
  health: 500
  damage: 12

phases:
  phase_2:
    at-health: 50
    effects:
      - INCREASE_DAMAGE

Reload and your mob is ready.

3️⃣ Spawn & Control
/mob spawn <mob-id>
/mob reload
/mob killall

4️⃣ 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> ...
/mob set randomworld <mob-id> <seconds> <maxSpawns> ...

🔐 Permissions

Permission Description