# 🔹 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 reload /mob killall 4️⃣ Auto-Spawn Management /mob set autospawn /mob set randomradius /mob set followplayer

... /mob set randomworld ... ``` **🔐 Permissions** Permission Description * themob.spawn Manually spawn custom mobs * themob.spawn.set Manage auto-spawns * themob.killall Remove all custom mobs * themob.reload Reload theMob * themob.stats Open player stats GUI ✔ Clean separation ✔ Safe for admin / moderator delegation ✔ No permission required for basic player features **📌 Recommended Use Cases** ✔ RPG Servers ✔ Boss Events & Arenas ✔ Dungeons ✔ Hardcore / Purge Servers ✔ Custom PvE Content **📦 Requirements** * Paper / Spigot 1.21.10 * Java 21 recommended **🚀 Final Notes** theMob is built for server owners who want: ✔ Powerful custom mobs without scripting ✔ Boss fights with real mechanics ✔ Strong performance under load ✔ Clean administration & safe reloads If you value control, performance and scalability, theMob is built for your server. 🔗 Links Download: [SpigotMC](https://www.spigotmc.org/resources/%25E2%2580%258D%25E2%2599%2582%25EF%25B8%258F-themob-%25E2%259C%25A6-advanced-custom-mobs-bosses.131017/) [Modrinth](https://modrinth.com/plugin/the-mob/) Documentation: [GitBook](https://3o3y.gitbook.io/the-mob/) Source Code: [GitHub](https://github.com/3o3y/TheMob) Support: [Patreon](https://www.patreon.com/cw/3o3y2024)

3o3y

3o3y's Plugins

TheMob by 3o3y

3o3y's Organizations

Stars

Watching

TheMob by