📄 mob_assignments.yml

This is the most important file in the entire plugin. It acts as the orchestra conductor, telling each mob which health bar it should use.

Purpose

In this file, you create a section for each mob type (Vanilla or MythicMobs) and assign it a layout, a custom name, and other visual settings.

Full Example

# For a MythicMob
SkeletalKnight:
  name: '&7Sir Skelly'
  layout: 'boss_layout'
  vertical-offset: 2.8
  components:
    health_bar: 'epic_bar_style'
    level_display: 'boss_level_frame'

# For a Vanilla Mob
ZOMBIE:
  name: '&2Walker'
  layout: 'simple_layout'
  vertical-offset: 2.2
  components:
    health_bar: 'simple_bar'

Options Explained

• mob_name: (e.g., SkeletalKnight, ZOMBIE)

  • MythicMobs: Must be the mob's Internal Name.

  • Vanilla: Must be the entity type name in ALL CAPS (e.g., ZOMBIE, PIG, CREEPER).

• name: (Optional)

  • The text that will be displayed on the health bar. Replaces the %sunshine_mob_name% placeholder. Supports color codes (&c, &l, etc.).

• layout: (Required)

  • The name of your layout file located in the layouts/ folder (without the .yml extension).

• vertical-offset: (Required)

  • The final height where you want the bar to appear, measured in blocks from the mob's feet. This is the main value you should adjust to move the bar up or down..

• components: (Required)

  • Here you specify which component designs your layout will use.

    • health_bar: The name of a file from the components/health_bars/ folder.

    • level_display: The name of a file from the components/level_displays/ folder.

  • If your layout doesn't use a component (like in our tutorial), you can leave this blank or just put {}.