‍♂️ TheMob ✦ Advanced Custom Mobs & Bosses icon

‍♂️ TheMob ✦ Advanced Custom Mobs & Bosses -----

Mob Framework | YAML | Boss Phases | Radar HUD | AutoSpawn | Player Stats | 1.21.10



TheMob v1.2.1 – Stability & Configuration Hotfix
This hotfix focuses on stability, configuration consistency and long-session behavior, based on real server usage and early community feedback after the v1.2 release.

No gameplay balance changes.
No new mechanics.
Just fixes, cleanup and polish.

Fixes & Improvements
Navigation HUD / BossBar
  • Fixed an issue where the Navigation HUD bossbar could disappear in certain config combinations
  • Improved internal handling when:
    • navigation-hud.enabled = false
  • BossBar now remains stable and predictable across reloads and server restarts
  • Clear separation between:
    • Direction display (N / E / S / W)
    • Radar logic
    • BossBar lifecycle
➡️ Result:
More reliable HUD behavior, especially on servers with custom HUD setups or frequent reloads.

AutoSpawn Logic
  • Increased AutoSpawn inactivity reset delay from 60 seconds to 5 minutes
  • Prevents bosses or mobs from despawning too aggressively during:
    • AFK moments
    • Creative-mode observation
    • Arena preparation phases
➡️ Result:
A more natural survival feeling while still fully preventing AFK farming.

Extra:

  • Scale improvements
  • Code (Text):

    stats:
      health:
        max: 20                    # Max health (10 hearts)
        current: 20                # Spawn health
      movement-speed: 0.23         # Vanilla = ~0.23
      attack-damage: 0             # 0 = harmless (good for events / early game)
      scale: 0.8                   # Entity size multiplier (1.0 = default size)
     
  • Crown / visual polish across bosses
  • Code (Text):
    name: "&2&lZombie King"
    display-health: true            # Show health bar / health display
    visual:                         # Get him a new Crown
      helmet:
        # What should float above the boss
        #
        # Supported values:
        # - PLAYER_HEAD        → Custom textured head (crown, skull, etc.)
        # - ANY Minecraft item or block
        #
        # Examples:
        # - GOLDEN_CARROT
        # - NETHER_STAR
        # - DIAMOND_BLOCK
        # - WITHER_SKELETON_SKULL
        #
        type: PLAYER_HEAD
        # Base64 texture (ONLY for PLAYER_HEAD)
        # Leave empty or remove if using an item or block
        #
        texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOTFiMGE1YmJjNjk3YzBjNDJhNmNmMWI5YzRjNDQzNWIwNzMyMmZjZTViYjI3ZDgyYjY5MzA4NDNlNWFiN2EwOSJ9fX0="
     

Internal Cleanup
  • Refactored visual handling:
    • Boss spawning logic is now cleanly separated from floating visuals
    • Crowns / floating items are handled exclusively by the visual system
  • Reduced internal coupling between spawn, visuals and boss logic
  • Minor safety checks added for edge cases during reloads
Community Feedback Acknowledged
“Really cool plugin!
I was wondering if you could add more settings, e.g. disabling the directions bossbar and more spawn options.”


✅ This feedback has been noted and directly influences upcoming work.

Current status:

  • Direction HUD can already be fully disabled
  • Colors of Radar can be changed
  • More granular spawn configuration is planned
Code (Text):
  # -------------------------------------------------------
  # Navigation HUD / Direction Bossbar
  # -------------------------------------------------------
  #
  # Client-side HUD showing player facing direction
  # and nearby mob activity via a BossBar.
  #
  navigation-hud:

    enabled: true
    # true  → HUD enabled
    # false → completely disabled (zero overhead)

    update-interval-ticks: 5
    # How often the HUD updates
    # 1 tick  = ultra smooth, higher CPU
    # 5 ticks = recommended (default)
    # 10+     = very low impact

    hide-in-combat: false
    # true  → hide HUD while player is fighting
    # false → always visible

    hide-when-idle: false
    # true  → hide HUD if no mobs are detected
    # false → always show

    hide-in-creative: false
    hide-in-spectator: true

  # -------------------------------------------------------
  # Mob Radar
  # -------------------------------------------------------

  # Controls how nearby mobs are detected
  # for the Navigation HUD.
    colors:
      plugin-mob: PURPLE
      aggressive-mob: RED
      neutral-mob: YELLOW
      passive-mob: GREEN
      empty: WHITE

  mob-radar:
    scan-radius: 20
    # Radius in blocks to search for mobs

    scan-chunks:
      horizontal: 1
      vertical: 1
    # Chunk scan radius (±chunks)

    priority:
      plugin-mobs: 1
      aggressive: 2
      neutral: 3
      passive: 4

    ignore:
      bats: true
      villagers: true
      named-mobs: false
What’s Next
v1.3 – Boss Phase Depth (Planned)
Goal:
Make boss phases truly meaningful and readable for players.

Focus:

  • Phase logic
  • Phase transitions
Planned Features:

  • Phase enter / leave hooks
  • Phase-specific action cooldowns
  • Phase transition effects (sound, title, particles)
  • Phase-based stat overrides
  • Cleaner and more readable phase YAML structure
⚠️ These features are NOT part of v1.2.1
They are intentionally scheduled for a dedicated feature release.

ℹ️ Notes & Compatibility
  • ✅ Fully backward compatible with v1.2
  • ✅ No configuration changes required
  • ✅ Safe update for existing worlds and AutoSpawn setups
  • ❌ No new content added in this hotfix
Summary
v1.2.1 is a quality-focused hotfix, designed to:

  • Improve long-session stability
  • Respect admin configuration intent
  • Prepare a clean foundation for v1.3
Less friction.
More control.
Same performance.
----------, Dec 27, 2025
Resource Information
Author:
----------
Total Downloads: 50
First Release: Dec 22, 2025
Last Update: Dec 29, 2025
Category: ---------------
All-Time Rating:
1 ratings
Find more info at 3o3y.gitbook.io...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings