MythicMobs

MythicMobs defines all custom mob behaviour, skills, and drop tables. It works alongside ModelEngine for rendering and Denizen (via Depenizen) for scripted reactions.

File layout

plugins/MythicMobs/
  Mobs/          # mob definitions
  Skills/        # skill definitions
  DropTables/    # loot tables
  Items/         # custom MythicMobs items
  RandomSpawns/  # spawn rules
  spawners/      # placed spawner configs

Mob definitions

Each mob is defined in a YAML file under Mobs/. A minimal example:

MyMob:
  Type: ZOMBIE
  Display: '&cMy Mob'
  Health: 20
  Damage: 5
  Options:
    Silent: true
    NoAI: false
  Skills:
    - skill{s=MySkill} @trigger ~onTimer:100
  Equipment:
    - my_sword HAND

Current mobs include characters from Majora's Mask: skullkid.yml, tatl.yml, tatl_g.yml, Richard.yml, fish variants, and enemy scrubs. VanillaMobs.yml holds overrides to vanilla mob behaviour.

Skills

Skills live in Skills/. A skill is a reusable behaviour block:

MySkill:
  Skills:
    - message{m="Grr!"} @trigger
    - effect:particles{p=flame;amount=10} @trigger

Skills can call Denizen scripts via the denizen mechanic (provided by Depenizen):

MySkill:
  Skills:
    - denizen{script=my_denizen_task;definitions=target=<trigger>} @trigger

This is the primary bridge between MythicMobs events and Denizen logic.

Models

To attach a ModelEngine model to a MythicMobs mob, add the Model option:

Tatl:
  Type: SLIME
  Options:
    Model: tatl
    Silent: true
    Size: 1

The model ID must match a blueprint filename (without .bbmodel) in plugins/ModelEngine/blueprints/.

Drop tables

Drop tables in DropTables/ are referenced from mob definitions:

MyMob:
  Drops:
    - droptable MyDropTable

Reloading

/mm reload

Reloads all MythicMobs configs. Required after any edit to mobs, skills, or drop tables.

To spawn a mob for testing:

/mm mobs spawn <MobName>