The Mob

TheMob v1.8.4 – Boss Behaviors, Spawn Tools & Placeholder Update

This update expands TheMob’s core gameplay systems with fully integrated boss behaviors, spawn egg & spawner tooling, and improved placeholder & messaging support.

No power creep. No balance changes. System expansion & usability update.

🧠 Boss Behaviors (NEW)

Bosses now support phase-bound AI behaviors, fully integrated into the boss lifecycle.

What’s new

Boss behaviors are now directly bound to boss phases

Behaviors initialize on spawn and update on phase transitions

Behavior logic is tick-driven and lifecycle-safe

Supported behaviors

Aggressive

Controlled target acquisition

Cleaner movement & combat flow

Passive

Idle roaming behavior

Non-hostile positioning

Flee

Smarter disengage logic

Improved escape & recovery behavior

Result

Bosses now feel intentional, readable, and tactical, instead of reactive or chaotic.

🥚 Spawn Eggs & Spawner Integration (NEW)

TheMob now includes first-class spawn tools for admins and creators.

New commands

/mob egg

Example: /mob egg zombie

/mob spawner

Example: /mob spawner 1

Features

Spawn eggs are fully configurable via spawneggs.yml

Custom messages are read directly from spawneggs.yml

Spawned mobs fully respect:

mob configs

boss phases

behaviors

stats & visuals

Result

Custom mobs can now be spawned cleanly, consistently, and safely via items and spawners.

💬 Spawn Egg Messages (NEW)

Spawn egg feedback is now config-driven.

What changed

All player-facing messages are loaded from spawneggs.yml

Supports placeholders and color codes

Fully customizable per spawn egg

Result

Better UX, better feedback, no hardcoded messages.

🔧 Placeholder System Update

The placeholder system has been extended and cleaned up.

Improvements

More consistent placeholder resolution across:

boss phases

spawn eggs

commands

Improved safety when placeholders resolve without a player

Better formatting consistency

Result

Placeholders are now more reliable and easier to use across all systems.

⚙️ Internal Improvements

Cleaner separation between:

spawn logic

phase lifecycle

behavior runtime

Safer boss lifecycle handling

Improved reload & shutdown stability

Reduced edge cases caused by delayed initialization

⚠ Notes

No balance changes

No config migrations required

Existing mobs remain fully compatible

Spawn eggs and spawners are optional tools

✅ Compatibility

Paper / Spigot 1.21+

Fully compatible with existing TheMob mob configurations

Safe for Beta and production environments

Final Note

v1.8.4 focuses on control and extensibility:

Bosses that behave with intent

Spawn tools that empower creators

Systems that scale cleanly into future updates

This release sets a strong foundation for v1.9+, where advanced behaviors, progression systems, and deeper combat intelligence will continue to evolve.

TheMob v1.8.3_Beta – Phase Init, Behavior Expansion & Baby Prep

This update focuses on combat lifecycle correctness, AI behavior depth, and forward compatibility for upcoming Minecraft features.

Important: 🗑️ Delete boss_template.yml before updating (Old templates are incompatible with the new phase lifecycle and will be regenerated.)

No power creep. No balance shifts. Foundation & systems update only.

🔁 Phase Trigger on Spawn (Critical Fix)

Boss phases are now initialized immediately after spawn, instead of waiting for the first damage event.

What changed

Previously:

❌ Initial boss phase logic only triggered after receiving damage

❌ Phase effects, buffs, and UI were delayed

❌ BossBars appeared “inactive” until first hit

Now:

✅ Boss phase lifecycle initializes shortly after spawn

✅ Phase logic applies even with zero incoming damage

✅ BossBars, buffs, abilities, and world effects are active immediately

Result

Predictable, deterministic boss behavior from the very first tick of combat.

🧠 AI Behavior Expansion

Major internal improvements to mob behavior logic.

New & Improved Behaviors

Passive Behavior

Natural idle movement

Non-hostile positioning

Improved awareness handling

Aggressive Behavior

Cleaner target acquisition

Reduced jitter during combat

More readable attack flow

FLEE Behavior (Expanded)

Improved disengage logic

Smarter retreat paths

Better recovery after escape

Reduced AI “panic loops”

Result

Mobs feel intentional, readable, and tactical instead of chaotic or suicidal.

👶 Baby Mob Integration – System Preparation

This version introduces full internal support for baby mobs, preparing TheMob for Mojang’s upcoming baby-mob overhaul.

New Config Support

mob-id: chicken_baby
base-type: CHICKEN
baby: true
name: "&bChicken Baby"
display-health: false

What’s included

Proper Ageable handling (API-safe)

Baby state applied at spawn

Growth locking support

Fully compatible with:

stats

behaviors

drops

visuals

combat logic

⚠️ Note: This update focuses on infrastructure, not balance. Baby-specific scaling and behavior tuning will come later.

Result

TheMob is now future-ready for Minecraft’s new baby mob models, sounds, and mechanics.

⚙️ Internal Stability Improvements

Hardened boss lifecycle tracking

Safer phase state initialization

Improved separation between:

spawn logic

combat logic

phase transitions

Reduced edge cases caused by delayed events

Result: More deterministic runtime behavior and fewer hidden edge-case bugs.

⚠ Notes

Boss template reset required (boss_template.yml)

No gameplay balance changes

No config migrations (except template reset)

Existing mobs remain compatible

Baby mobs are optional and opt-in

✅ Compatibility

Paper / Spigot 1.21+

Fully compatible with existing TheMob mob configs

Safe for Alpha & production test environments

Final Note

v1.8.3_Beta is about tightening the core:

Phases that start when they should

AI that behaves with intent

Systems ready for upcoming Minecraft features

This update lays the groundwork for v1.9+, where baby mobs, advanced behaviors, and deeper combat intelligence will fully come alive.

This update is a focused stability and behavior refinement hotfix.

Delete boss_template.yml

No new mobs. No power creep.

Instead, v1.8.3_Alpha fixes critical early issues found in v1.8.2 and introduces the first experimental FLEE behavior layer.

🛠 What was fixed ❤️ Health Display & BossBar Stability Fixed multiple long-standing issues where:

❌ Display-health stopped updating correctly

❌ BossBar & health display disappeared after long fights

❌ Health values desynced during long boss phases

Now:

Real-time synchronized updates

BossBar persistence during:

    long combat sessions

    multi-phase bosses

    reload-safe transitions

Automatic re-sync when edge cases occur

Result: Reliable visual health feedback even in extended boss encounters.

🧭 Phase Movement Bug – "Moonwalk Fix" Fixed an issue where mobs (especially bosses) could:

slide sideways

appear to "moonwalk"

drift unnaturally during high-intensity phases
(observed especially in chaotic / desperation phases)

Now:

Corrected velocity application

Stabilized movement vectors during:

    forced AI overrides

    phase-driven ability spam

Eliminated sideways drift artifacts

Result: Natural, readable movement even under extreme combat logic.

🩺 Long-Fight Visual Cleanup Bug Fixed a rare but critical issue where after very long fights:

❌ BossBar disappeared

❌ Health display vanished

❌ UI elements stopped updating

Root cause: Edge-case lifecycle cleanup triggered too aggressively during long runtimes.

Now:

Corrected cleanup triggers

Hardened lifecycle tracking

Added automatic recovery logic

Result: Boss fights remain visually stable for unlimited durations.

🆕 New: Experimental FLEE Behavior (Alpha) Introduced the first version of health-based flee logic.

🧠 Behavior Overview When certain health thresholds are reached, mobs can now:

attempt disengage

reposition strategically

escape pressure zones

break direct combat loops

✨ Features

Health-percentage based triggers

Smooth disengage pathing

Smart target loss handling

Fully AI-driven (no teleport abuse)

⚠ Status: Experimental (Alpha)

Enabled internally only

Still being tuned

Will be expanded in v1.9+

Goal: Create mobs that survive longer, reposition smarter, and feel tactical instead of suicidal.

⚙️ Stability Improvements

Additional safeguards in:

    AI tick loops

    boss phase transitions

    HUD lifecycle handling

Improved fail-safes for:

    stalled visuals

    stuck UI updates

Hardened runtime cleanup safety

Result: Higher uptime reliability & smoother long-session gameplay.

⚠ Notes

No gameplay balance changes

No config changes

No breaking changes

Safe update from v1.8.2

Existing mobs & bosses continue to work unchanged

✅ Compatibility

Paper / Spigot 1.20+

Fully compatible with all existing TheMob configs

Safe for production testing environments

Final Note v1.8.3_Alpha is about polishing the foundations:

Stable visuals Predictable AI Smarter combat flow

This hotfix pushes TheMob one step closer to true next-gen mob intelligence.

🔧 TheMob v1.8.2 – AI Navigation, Stability & System Hardening

This update is a system-level refinement release. No new mobs. No power creep. Instead, v1.8.2 focuses on AI intelligence, pathfinding reliability, and long-term server stability.

🧠 New: Smart AI Pathfinding (Experimental)

A brand-new SmartRepath AI system has been introduced to solve one of Minecraft’s biggest problems: mobs getting stuck.

✨ What’s new

Automatic stuck detection

Monitors real movement progress over time

Detects blocked or looping navigation

Multi-stage recovery logic

Soft obstacle clearing (leaves, logs, vines, wooden blocks)

Safe teleport fallback near target

Soft repath using internal pathfinder hooks

Visual feedback

Subtle particle effects during AI recovery actions

🔒 Safety & Rules

Fully respects mobGriefing

No hard block breaking (iron, stone, protected blocks)

No world damage when disabled

Designed to behave like “smart vanilla AI”, not cheats

🧪 Status: Experimental Enabled internally for controlled mobs. Will expand in v1.9.

🤖 New: Modular Mob AI Controller

Introduced a new internal AI layer:

MobAIService

MobAIController

MobAIProfile

Capabilities

State-driven behavior:

IDLE

ENGAGE

FLEE

REGROUP

Intelligent target switching

Graceful disengage logic

Health-based flee mechanics

Tick-rate controlled per mob (performance friendly)

This lays the groundwork for future advanced behaviors (formations, roles, tactics).

🧱 Boss & Arena System Fixes ✅ Arena Radius (Chunk-Based)

New config option:

arena: radius-chunks: 3

Unified arena definition for:

Boss titles

World effects

Visual cleanup

AI & behavior logic

✅ Phase Visuals & World Effects

Phase titles are now shown only to players inside the arena

World effects are strictly arena-local

Removed global world ticks and broadcasts

🧟 AutoSpawnManager – Critical Stability Fixes Fixed

❌ Plugin chunk ticket leaks

❌ Chunks staying loaded after reloads / crashes

Improved

Guaranteed chunk ticket release on:

arena leave

unregister

killAll

plugin disable

Safer random-world spawn probing with try/finally

Result: Long-uptime safe, no hidden memory or chunk leaks.

⚙️ Performance Improvements

Removed unnecessary world-wide entity scans

Boss logic now scales with active bosses, not world size

Faster admin killAll execution

Reduced scheduler overhead in AI & behavior ticks

🧹 Lifecycle & Reload Safety

Unified shutdown logic

All systems now cleanly stop on:

/reload

plugin disable

crash recovery

Extra cleanup for:

HUD elements

visuals

AI controllers

boss locks

🧠 Internal Cleanup & Refactors

Restored and stabilized internal APIs after refactors

Clear separation of:

Boss phases

Behavior logic

AI navigation

Reduced cross-system coupling

⚠️ Notes

No gameplay balance changes

No config breakage

Existing mobs & bosses continue to work unchanged

AI Pathfinding is opt-in internally and will expand gradually

✅ Compatibility

Paper / Spigot 1.20+

Fully compatible with existing TheMob configs

Safe to update from v1.8.1

🧠 Final Note

v1.8.2 is not about flash. It’s about trust: smarter mobs, predictable behavior, and servers that stay healthy for weeks.

🔧 TheMob v1.8.1 – Hotfix (Stability & UX Fixes)

This hotfix focuses on combat clarity, spawn safety and message control. No new systems were added – only targeted fixes to improve gameplay reliability and visual consistency.

🧱 What was fixed ❤️ Display Health (Nametag)

Fixed an issue where display-health did not update correctly on mob name tags

Health values now:

    update reliably in real time

    correctly reflect custom max health

    stay in sync with boss bars and internal stats

☠ Player Death Messages (Custom Mobs)

Vanilla player death messages caused by custom mobs are now fully suppressed

Added support for optional custom death messages via config

Prevents duplicated or misleading vanilla messages

Config-controlled and fully optional

📍 Mob Spawn Position Safety

Fixed an issue where mobs spawned inside blocks or partially underground

Spawn logic now:

    applies a safe Y-offset

    snaps mobs to valid ground

    ensures sufficient headroom for large entities

This prevents:

suffocation damage

falling through blocks

visual glitches on spawn

🚧 In Development (Not part of this hotfix)

🧠 Pathfinding Improvements

Larger mobs may still occasionally get stuck in complex terrain

A smarter repath & navigation system is currently under development

No regressions introduced by this hotfix

As always

thanks for using TheMob ❤️

🔧 TheMob v1.8 – Combat, Config & Control

This release expands TheMob’s core systems with advanced combat configuration, admin-only feedback controls and full global config transparency, building directly on top of the v1.7 automation & scaling foundation.

No gameplay rebalance.

No forced behavior.

Only more control, safety and clarity for server owners.

⚔️ Advanced Combat Configuration (NEW)

Combat behavior is now globally configurable and admin-controlled.

combat:
  damage-indicator:
    enabled: false
    show-to:
      - op
      - admin

✔ Floating damage indicators are now fully optional

✔ Visible only to admins / operators by default

✔ No PvP clutter, no immersion break for players

➡️ Ideal for debugging, balancing and boss tuning

➡️ Zero gameplay impact for normal players

🧠 Automation Feedback Control (NEW)

Spawn protection feedback is now configurable.

automation:
  feedback:
    show-to-players: false

✔ TPS warnings

✔ Budget blocks

✔ Cooldown blocks

➡️ Shown only to admins by default

➡️ Players never see internal system messages

This keeps gameplay clean while admins stay fully informed.

📖 Full Global Config Documentation (LIVE)

The entire config.yml is now fully documented on GitBook.

✔ Every section explained

✔ Safe defaults clarified

✔ Performance & scaling behavior documented

✔ Network-ready explanations

👉 Documentation

🛠 Internal Stability Improvements

Several under-the-hood improvements were included:

✔ Safer phase combat modifier handling

✔ Improved lifecycle cleanup for bosses & minions

✔ Defensive checks against invalid stat keys

✔ No forced despawns – ever

These changes improve long-session stability and reduce edge-case risks.

✔ Safe for live servers

✔ No performance regressions

✔ Fully backward compatible

✔ No required config migration

⚠️ Some systems are intentionally admin-only for now

→ Player-facing options will unlock later in v1.9 / v2.0

📌 Notes

Protection systems only block spawns, never delete mobs

All config values are optional – missing sections fall back safely

Designed for long-running servers & large networks

Thanks to everyone testing, reporting and pushing TheMob forward ❤️

More combat and UI polish coming next.

🔧 TheMob v1.7.2 – Hotfix Update

This hotfix focuses on stability, rendering fixes and foundational feature unlocks requested by the community.

No new gameplay systems – only important fixes and integrations.

🧱 NBT & Base64 Item Support (Partial)

Custom items can now be equipped on mobs using:

✔ Raw NBT strings

✔ Base64-encoded items

✔ Custom heads via texture strings

✔ Enchantments & metadata

⚠️ Note: This is a foundation release. Advanced NBT validation & tooling will be expanded in v1.8+.

🧩 PlaceholderAPI & MiniMessage Integration

Text rendering across the plugin now supports:

✔ PlaceholderAPI (optional dependency)

✔ MiniMessage formatting

✔ Dynamic values (mob name, phase, distance, player, etc.)

Used in:

BossBars

Phase titles

HUD elements

Future event & ability messages

🧭 Navigation HUD Reload Fix

Fixed a critical reload issue:

❌ Duplicate HUD boss bars after /mob reload

❌ Orphaned bossbars persisting across reloads

✔ All HUD bars are now:

Properly cleaned up on reload

Safely removed on disable

Re-initialized cleanly after restart

This fixes:

Reload crashes

Ghost HUD bars

ConcurrentModificationExceptions

🧪 Version Status

🟡 STABLE HOTFIX

✔ Safe for live servers

✔ No performance regression

✔ Fully backward compatible

✔ No config changes required

Thanks to everyone reporting issues and testing edge cases. v1.7.2 prepares the ground for v1.8’s equipment, visuals and ability architecture.

🚀

🔧 TheMob v1.7.1 – Hotfix (Metrics Accuracy)

This hotfix addresses an issue with bStats SingleLineCharts reporting inconsistent values under certain conditions.

🛠 What was fixed

Corrected metrics sampling timing to avoid temporary zero or spike values

Ensured bStats values are reported only after full system initialization

Prevented inaccurate data points during:

server startup

reloads

short-lived transitional states

📊 Impact

bStats charts now reflect stable, long-running system values

No change to gameplay, mobs, bosses or performance

Metrics remain fully anonymous and optional

🔒 Privacy & Safety

No additional data collected

No IPs, player names or server identifiers

Fully compliant with bStats standards

✅ Compatibility

Fully compatible with TheMob v1.7

No config changes required

Safe to update on running servers

Recommended for all servers running v1.7.

As always, thanks for using TheMob ❤️