### Character Setup with Inputs dialog example

Source: https://wiki.mythiccraft.io/mythicmobs/Dialogs

A character setup dialog with multiple input types (text, bool, range, option) and two buttons. The Confirm button triggers the CharacterConfirmed skill. Player choices are accessible via placeholders like <dialog.nickname>, <dialog.pvpEnabled>, <dialog.difficulty>, <dialog.classChoice>, and <dialog.button>.

```yaml
CharacterSetup:
  Title: "<blue>Character Setup"
  CanClose: false
  AfterAction: WAIT_FOR_RESPONSE
  Columns: 2
  Body:
  - Type: text
    Message: "<gray>Configure your character settings."
    Width: 300
  Inputs:
  - Type: text
    Key: nickname
    Label: "Display Name"
    MaxLength: 16
  - Type: bool
    Key: pvpEnabled
    Label: "Enable PvP?"
  - Type: range
    Key: difficulty
    Label: "Difficulty"
    Start: 1
    End: 10
    Initial: 5
    Step: 1
  - Type: option
    Key: classChoice
    Label: "Choose a Class"
    Options:
      warrior: "Warrior"
      mage: "Mage"
      ranger: "Ranger"
  Buttons:
  - Label: "<green>Confirm"
    Tooltip: "Save your settings"
    Width: 150
    Skill: CharacterConfirmed
  - Label: "<red>Cancel"
    Width: 150
  ExitButton:
    Label: "Close"
    Width: 100

```

--------------------------------

### RandomLocationsNearTargets example with particle effect

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Targeters/RandomLocationsNearTargets

Shows a two-skill setup where ExampleSkill1 triggers ExampleSkill2 at a random point in a 10-block radius, and ExampleSkill2 applies a particle effect at random locations near the inherited targets with 5 points and a 2-block radius.

```yaml
ExampleSkill1:
  Skills:
  - skill{s=ExampleSkill2} @PIR{r=10}

ExampleSkill2:
  Skills:
  - effect:particles @RandomLocationsNearTargets{a=5;r=2}

```

--------------------------------

### Skills file for SudoSkill example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/SudoSkill

Example of a skills file that defines the metaskill used by the SudoSkill example, including an arrow volley and a message with the trigger name.

```yaml
# Skills file
ExampleSudoskill:
  Skills:
  - arrowvolley{a=20;s=25;v=10;f=50;rd=200} @EIR{r=30}
  - message{msg="Triggername<&co> <trigger.name>"} @world

```

--------------------------------

### Pickupitem example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/pickupitem

Example skill configuration that uses pickupitem to pick up items within a 10-block radius.

```yaml
  Skills:
  - pickupitem @ItemsInRadius{r=10}

```

--------------------------------

### Skill Configuration Example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Targeters/EntitiesInRadius

Example skill configuration using the @EIR targeter with a radius of 10.

```yaml
  Skills:
  - ignite @EIR{r=10}

```

--------------------------------

### Light particle example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Light

Example skill configuration using the light particle. The particle has no attributes.

```yaml
  Skills:
  - particle{p=light}

```

--------------------------------

### Vibration particle skill example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Vibration

Example skill configuration using the Vibration particle with no attributes.

```yaml
  Skills:
  - particle{p=vibration}

```

--------------------------------

### Note particle skill example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Note

Example skill configuration using the note particle. The particle has no attributes.

```yaml
  Skills:
  - particle{p=note}

```

--------------------------------

### Reverse Portal Particle Example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Reverse_Portal

Example skill configuration using the reverse_portal particle. The particle has no attributes.

```yaml
  Skills:
  - particle{p=reverse_portal}

```

--------------------------------

### Barrier particle example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Barrier

Example of using the barrier particle in a MythicMobs skill configuration.

```yaml
  Skills:
  - particle{p=barrier}

```

--------------------------------

### Guardian Beam Skill Example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/GuardianBeam

Example skill configuration using the guardianbeam effect with attributes duration, interval, startYOffset, fromOrigin, and metaskills for start, tick, and end. The effect targets @Target.

```yaml
Guardian_Beam:
   Skills:
   - guardianbeam{d=200;i=1;syo=1;fromOrigin=false;oS=AStartingSkill;oT=ATickingSkill;oE=AEndingSkill} @Target

```

--------------------------------

### DropOptions full configuration example

Source: https://wiki.mythiccraft.io/mythicmobs/drops/FancyDrops

Shows the complete DropOptions configuration with all available options and their default values. Use this as a reference for the full structure.

```yaml
  DropOptions:
    DropMethod: FANCY
    ShowDeathChatMessage: false
    ShowDeathHologram: false
    PerPlayerDrops: false
    ClientSideDrops: false
    Lootsplosion: false
    HologramItemNames: false
    ItemGlowByDefault: false
    ItemBeamByDefault: false
    ItemVFXByDefault: false
    ItemVFX:
      Material: STONE
      Model: 0
    RequiredDamagePercent: 0.1
    HologramTimeout: 6000
    HologramMessage:
    - ...
    - ...
    ChatMessage:
    - ...
    - ...

```

--------------------------------

### Hide player's bossbar UI on cinematic start

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Triggers/onCinematicStart

Example skill that hides the player's bossbar UI the moment any cinematic starts. Uses the onCinematicStart trigger with a setVariable mechanic targeting @self.

```yaml
CinematicWatcher:
  Type: ARMOR_STAND
  Skills:
  # Hide the player's bossbar UI the moment any cinematic starts
  - setVariable{var=caster.hud;value=hidden} @self ~onCinematicStart

```

--------------------------------

### For Each with variable list (ExampleForEach)

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/ForEach

Shows a metaskill that uses For Each to execute ExampleSkill on each target within 10 blocks, sorted by nearest. The ExampleSkill adds the target's UUID to a skill list variable, which is then displayed after the loop.

```yaml
# Skills file
ExampleForEach:
  Skills:
  - setvariable{var=skill.listuuid;type=LIST;val=""} @self
  - foreach{skill=ExampleSkill} @PIR{r=10;sort=NEAREST}
  - message{m=<skill.var.listuuid>}

ExampleSkill:
  Skills:
  - variableadd{var=skill.listuuid;value=<target.uuid>}

```

--------------------------------

### BossBar example for SuperCreeper

Source: https://wiki.mythiccraft.io/mythicmobs/Mobs/BossBar

A complete example that gives a creeper a red solid boss bar titled 'Test' with a range of 20 blocks. Use this as a starting point for your own mob; note that the Title and Display use color codes with ampersand.

```yaml
SuperCreeper:
  Type: creeper
  Display: '&cTest'
  Health: 20
  BossBar:
    Enabled: true
    Title: 'Test'
    Range: 20
    Color: RED
    Style: SOLID

```

--------------------------------

### BlockWave Skill Example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/BlockWave

Creates a stone blockwave in a sphere shape starting at your self location. The effect is purely cosmetic and does not change any blocks in the world.

```yaml
  Skills:
  - blockwave{duration=100;material=stone;radius=5;radiusY=5;velocity=10;shape=sphere} @selflocation

```

--------------------------------

### Example equipment configuration

Source: https://wiki.mythiccraft.io/mythicmobs/Mobs/Equipment

Example of a mob equipped with a custom MythicMobs helmet in the HEAD slot and a vanilla diamond sword in the HAND slot.

```yaml
awesome_boss:
  Type: pig_zombie
  Equipment:
  - awesome_boss_helmet HEAD
  - diamond_sword HAND

```

--------------------------------

### Portal particle example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Portal

Example of using the portal particle in a MythicMobs skill configuration. The particle has no attributes.

```yaml
  Skills:
  - particle{p=portal}

```

--------------------------------

### Vault Connection particle example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Vault_Connection

Example skill configuration using the vault_connection particle. The particle has no attributes.

```yaml
  Skills:
  - particle{p=vault_connection}

```

--------------------------------

### Doppleganger skill example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/doppleganger

Creates a skeleton mob that copies the appearance of the nearest player when it spawns. Requires Libs' Disguises to be installed for the disguise functionality to work.

```yaml
TotallyNotDitto:
  Type: SKELETON
  Skills:
  - doppleganger @NearestPlayer ~onSpawn

```

--------------------------------

### ResetAI Example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/ResetAI

Example skill configuration using the resetai mechanic on the caster. The mechanic has no attributes.

```yaml
  Skills:
  - resetai @self

```

--------------------------------

### NumericEntityScopedPlaceholder example: DistancePlaceholder

Source: https://wiki.mythiccraft.io/mythicmobs/API/Placeholders

Example of a custom placeholder that extends NumericEntityScopedPlaceholder. It uses the inherited getLocation.get(PlaceholderContext) method to get the target location and computes the distance from the caster's location, returning null if they are in different worlds. The applyToScopeWithNumericFormatting method returns a Number and the constructor uses EntityScopedPlaceholderArguments.

```java
@MythicPlaceholder(placeholder="distance")
public class DistancePlaceholder extends NumericEntityScopedPlaceholder {


    public DistancePlaceholder(EntityScopedPlaceholderArguments context) {
        super(context);
    }

    @Nullable
    @Override
    public Number applyToScopeWithNumericFormatting(PlaceholderContext placeholderContext) {
        var caster = placeholderContext.meta().getCaster().getEntity().getLocation();
        var target = getLocation.get(placeholderContext);
        if (caster.getWorld().equals(target.getWorld())) {
            return caster.distance(target);
        }
        return null;
    }
}

```

--------------------------------

### Sudoskill example with mob and skills files

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/sudoskill

Two-file example: a mob file defines SudoMonkey that uses sudoskill on damage, and a skills file defines the metaskill ExampleSudoskill that fires an arrow volley and sends a message. The cat=true attribute sets the trigger to the caster.

```yaml
# Mob File
SudoMonkey:
  Type: villager
  Display: 'a Villager'
  Skills:
  - sudoskill{s=ExampleSudoskill;cat=true} @trigger ~onDamaged

```

```yaml
# Skills file
ExampleSudoskill:
  Skills:
  - arrowvolley{a=20;s=25;v=10;f=50;rd=200} @EIR{r=30}
  - message{msg="Triggername<&co> <trigger.name>"} @world

```

--------------------------------

### Configure item with new components (AttackRange, Weapon, JukeboxPlayable, etc.)

Source: https://wiki.mythiccraft.io/mythicmobs/changelogs/Changelogs

Example MythicMobs item configuration demonstrating new component support: AttackRange, Weapon, JukeboxPlayable, UseRemainder, Repairable, and PotDecorations. Use this as a template for items that use these newly added components.

```yaml
AnItem:
  Material: DIAMOND
  AttackRange: 3.5
  Weapon:
    ItemDamagePerAttack: 2
    DisableBlockingForSeconds: 0.5
  JukeboxPlayable: "minecraft:thirteen"
  UseRemainder: ADifferentItem
  Repairable:
  - STICK
  PotDecorations:
    Back: brick
    Left: arms_up_pottery_sherd
    Right: skull_pottery_sherd
    Front: prize_pottery_sherd
```

--------------------------------

### Speak Mechanic Example

Source: https://wiki.mythiccraft.io/mythicmobs/changelogs/4.7.x_changelogs

Makes mobs talk in chat with a configured syntax and speech bubbles if a hologram plugin is installed. Shown with @trigger and ~onInteract or ~onDamaged triggers.

```yaml
 - speak{m="OH BOY I HAVE SPEECH BUBBLES NOW"} @trigger ~onInteract
 - speak{m="OW THAT HURTS I CANT BELIEVE YOU WOULD HIT AN INNOCENT MAN"} @trigger ~onDamaged 

```

--------------------------------

### Example pack folder structure

Source: https://wiki.mythiccraft.io/mythicmobs/Packs

Example directory structure showing how files with identifiers and extensions are organized inside the `files` folder. Files are parsed based on their name regardless of their location.

```text
📦ExamplePack
 ┣ 📂files
 ┃ ┣ 📂aRandomFolder
 ┃ ┃ ┣ 📂aNestedFolder
 ┃ ┃ ┃ ┗ 📜ThisIsADroptableFile.droptable.yml
 ┃ ┃ ┣ 📜ThisIsAMobFile.mob.yml
 ┃ ┃ ┗ 📜ThisIsAPlaceholderFile.placeholder.yml
 ┃ ┣ 📂anotherRandomFolder
 ┃ ┃ ┣ 📜ThisIsAMobFile.mob.yml
 ┃ ┃ ┣ 📜ThisIsASchematic.schem
 ┃ ┃ ┗ 📜ThisIsASkillFile.skill.yml
 ┃ ┗ 📜ThisIsAStatFile.stat.yml
 ┗ 📜packinfo.yml

```

--------------------------------

### Splash Particle Skill Example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Splash

Example skill configuration that uses the splash particle. The particle has no attributes.

```yaml
  Skills:
  - particle{p=splash}

```

--------------------------------

### Undisguise on Interact

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/undisguise

Use this example to remove the mob's disguise when it is right-clicked. The skill is triggered by the ~onInteract signal and requires Libs' Disguises to be installed for disguise functionality.

```yaml
  Skills:
  - undisguise ~onInteract

```

--------------------------------

### packinfo.yml: PackDependencies and FileDependencies example

Source: https://wiki.mythiccraft.io/mythicmobs/changelogs/Changelogs

Example of the new PackDependencies and FileDependencies keys in packinfo.yml, letting a pack declare which plugins/files it needs so Mythic skips content gated behind a missing dependency.

```yaml
PackDependencies:
- MythicCrucible
FileDependencies:
- enchantments/* MythicEnchants

```

--------------------------------

### Variable placeholder with default value

Source: https://wiki.mythiccraft.io/mythicmobs/changelogs/4.6.x_changelogs

Variable placeholders can have a |default appended in case the variable is not set. This example gets the value of the variable 'something' on the target, defaulting to 'default' if unset.

```text
<target.var.something|default>

```

--------------------------------

### In-line item creation example

Source: https://wiki.mythiccraft.io/mythicmobs/changelogs/4.12.x_changelogs

Shows in-line item creation syntax with display name, enchantments, and model.

```text
diamond{display="test";enchants=DAMAGE_ALL:4,PROTECTION_ALL:4;model=2}

```

--------------------------------

### Gust particle skill example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Gust

Example skill configuration that uses the gust particle. The particle has no attributes.

```yaml
  Skills:
  - particle{p=gust}

```

--------------------------------

### Example mob configuration using onCreeperCharge

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Triggers/onCreeperCharge

Defines a creeper mob that sends a message to all players in the world when it gets charged. The skill is triggered by onCreeperCharge and uses @World as the target.

```yaml
EXAMPLE_MOB:
  Type: CREEPER
  Skills:
    # sends a message to all the players in the world
    # when the mob gets charge
    - message{m=CHARGED} @World ~onCreeperCharge

```

--------------------------------

### Inline Metaskill Example with Target Inheritance

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Metaskills

Shows the inline metaskill syntax within a skill mechanic, including target inheritance and use of delays.

```yaml
ExampleMob:
  Type: ZOMBIE
  Skills:
  - skill{s=[
    - message{m="Feeling cold? Don't you worry!"}
    - delay 40
    - ignite
    ]} @trigger ~onInteract
```

--------------------------------

### Beam skill example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/beam

Creates a beam with a duration of 100 ticks, a rotation speed of 2 degrees per tick, and a starting y offset of 100, targeting the caster's own location.

```yaml
  Skills:
  - beam{d=100;rs=2;syo=100} @selflocation

```

--------------------------------

### Take Experience Levels Example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/TakeExperienceLevels

Use this example to apply the takeexperiencelevels mechanic to a mob, taking 1 experience level from the triggering player when the mob is damaged.

```yaml
ExampleMob:
  Type: ZOMBIE
  Skills:
  - takeexperiencelevels{a=1} @trigger ~onDamaged

```

--------------------------------

### SAFE_FALL_DISTANCE attribute example

Source: https://wiki.mythiccraft.io/mythicmobs/Items/Attributes

The number of blocks an entity can fall before fall damage starts to be accumulated. Also the minimum amount of blocks the entity has to fall to make falling particles and sounds.

```yaml
custom_item:
  Id: wooden_sword
  Attributes:
    All:
      SAFE_FALL_DISTANCE: 2 ADD

```

--------------------------------

### Basic item configuration with Options

Source: https://wiki.mythiccraft.io/mythicmobs/Items/Options

Shows the basic structure of an item configuration with the Options tag.

```yaml
example_item:
  Id: diamond
  Options:
    SomeOption: value

```

--------------------------------

### GoToParent AI Goal Example

Source: https://wiki.mythiccraft.io/mythicmobs/Mobs/ai/goals/GoToParent

Configures the GoToParent AI goal for a mob. The followrange (fr) is set to 10 blocks and minrange (mr) to 3 blocks, so the mob starts following its parent when farther than 10 blocks and stops when within 3 blocks.

```yaml
  AIGoalSelectors:
  - clear
  - gotoparent{fr=10;mr=3}

```

--------------------------------

### Example Mechanic - Multiple Attributes

Source: https://wiki.mythiccraft.io/mythicmobs/Wiki-Editors-Resources/ExampleMechanic

Example of the Example Mechanic with two attributes. The mechanic is used in a Skills section and targets a targeter.

```yaml
  Skills:
  - examplemechanic{attribute1=value1;attribute2=value2} @targeter

```

--------------------------------

### Example Mechanic - Basic Usage

Source: https://wiki.mythiccraft.io/mythicmobs/Wiki-Editors-Resources/ExampleMechanic

Basic example of the Example Mechanic with a single attribute. The mechanic is used in a Skills section and targets a targeter.

```yaml
  Skills:
  - examplemechanic{attribute1=value1} @targeter

```

--------------------------------

### Mob File Example for Missile Skill

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/missile

Example of a mob file that triggers the 'Homer' skill on a timer. The skill is defined in the skills file example.

```yaml
# Mob File
Mob:
  Type: ZOMBIE
  Skills:
  - skill{s=Homer} @target ~onTimer:100

```

--------------------------------

### Dynamic Metaskill with vskill and Inline Metaskills

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Dynamic-Metaskills

Example of a dynamic metaskill using the `vskill` mechanic and inline metaskills. It stores a metaskill in a variable and then executes it with `vskill`, and also constructs a metaskill inline with a variable placeholder. Note: this is not an intended mechanic and can be exploited if any string is sourced from a player.

```yaml
Testmob:
  Type: pig
  Skills:
  - skill{s=
    [
      - setvariable{var=skill.temp;type=STRING;val=glow} @self
      - setvariable{var=skill.testskill;type=STRING;
        val=
        [
          - message{m=hello} @World
          - message{m=world} @World
          - message{m=<skill.var.temp>} @World
        ]} @self
      - vskill{s=<skill.var.testskill>}
      - vskill{s=
        [
          - particle{p=<skill.var.temp>} @selflocation{y=2}
        ]} @self
    ]} @self ~onInteract
```

--------------------------------

### sendresourcepack skill example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/sendresourcepack

Example skill using the sendresourcepack mechanic. The hash shown is only a demonstration and should not be used in a real skill.

```yaml
Skills:
  - sendresourcepack{url="https://yourresourcepackurlhere";hash="cf23df2207d99a74fbe169e3eba035e633b65d94"} @PIR{r=15} ~onSpawn
  - ...
```

--------------------------------

### Flash particle example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Flash

Example of the flash particle with no attributes.

```yaml
  Skills:
  - particle{p=flash}

```

--------------------------------

### Enchant particle example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Enchant

Example of using the enchant particle in a skill configuration.

```yaml
  Skills:
  - particle{p=enchant}

```

--------------------------------

### goToSpawn goal example for a zombie

Source: https://wiki.mythiccraft.io/mythicmobs/Mobs/ai/goals/goToSpawnLocation

Configures a zombie with the goToSpawn goal so it melee attacks until it is more than 20 blocks from its spawn, then walks back to within 4 blocks. Uses speed=1, max=20, and min=4 attributes.

```yaml
ExampleMob:
  Type: ZOMBIE
  AIGoalSelectors:
    - clear
    - goToSpawn{speed=1;max=20;min=4}
    - meleeattack
```

--------------------------------

### Open custom menu with opencustommenu

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/OpenCustomMenu

Opens the custom menu named 'ExampleMenu' when the skill is triggered by an interaction. Requires MythicMobs Premium or MythicRPG.

```yaml
  Skills:
  - opencustommenu{m=ExampleMenu} @trigger ~onInteract

```

--------------------------------

### Get an item with /mm items get

Source: https://wiki.mythiccraft.io/mythicmobs/Guides/%28Step-4%29-Essential-Commands

Gives you the specified MythicMobs item.

```text
/mm items get [itemname]
```

--------------------------------

### hasitem condition example

Source: https://wiki.mythiccraft.io/mythicmobs/changelogs/4.13.x_changelogs

Example of the new hasitem condition checking for 2 sticks.

```yaml
  Conditions:
  - hasitem{i=STICK;amount=2}

```

--------------------------------

### packinfo.yml: PackOverrides and FileOverrides example

Source: https://wiki.mythiccraft.io/mythicmobs/changelogs/Changelogs

Example of the new PackOverrides and FileOverrides keys in packinfo.yml, which skip a pack or its files when the listed pack or plugin is present. All four keys accept conditions combined with &&, ||, ! and parentheses, and a name can be a plugin, another pack's folder name, or MythicMobsPremium.

```yaml
PackDependencies:
- ((MythicCrucible && MythicMobsPremium) || Nexo)
PackOverrides:
- TheRealPack
FileDependencies:
- armors/** MythicArmors
FileOverrides:
- items/armors_vanilla.yml MythicArmors

```

--------------------------------

### dimension condition example

Source: https://wiki.mythiccraft.io/mythicmobs/changelogs/4.13.x_changelogs

Example of the new dimension condition checking for the NETHER dimension.

```yaml
  Conditions:
  - dimension NETHER

```

--------------------------------

### Demon complete example

Source: https://wiki.mythiccraft.io/mythicmobs/examples/Mob-Examples

The final complete Demon mob configuration combining all previous parts: basic options, AI, equipment, options, and skills.

```yaml
Demon:
  Type: blaze # Mob Type
  Display: 'Demon' # Mob Display name
  Damage: 6 # The amount of Damage it deals
  Health: 60 # The amount of Health it has
  Faction: bad # Set the Demon's faction as "bad".
  Disguise: Player 164_ setCustomName Demon setCustomNameVisible false # Disguise it as a player with a skin. Requires LibsDisguises.
  AIGoalSelectors:  # We will not clear the mob's base AI, instead adding to it
  - meleeattack # Uses melee attacks
  - randomstroll # Randomly walks
  - float # Randomly floats
  AITargetSelectors:
  - clear # Clears the mob's base AI
  - players # Firstly targets players
  - attacker # Targets whatever attacks it
  - specificfaction good # Targets mobs from the faction "good"
  Equipment:
  - NETHERITE_AXE HAND # Makes the mob hold a netherite axe in its hand
  Options:
    AlwaysShowName: false
    PreventOtherDrops: true
    PreventMobKillDrops: true
    MovementSpeed: 0.35
    Silent: false
  Skills:
  # PARTICLE EFFECTS
  - effect:flames @self ~onTimer:100 # Every 100 ticks (5 seconds), show a spawner flame effect on mob's location.
  # SOUND EFFECTS
  - effect:sound{s=entity.elder_guardian.ambient;v=1;p=2} @self 0.5 ~onTimer:150 # Ever 150 ticks (7.5 seconds), 50% chance to play the entity.elder_guardian.ambient sound with volume 1 and pitch 2
  - effect:sound{s=entity.elder_guardian.hurt;v=1;p=0.7} @self ~onDamaged # When the mob gets damaged, play the entity.elder_guardian.hurt sound with volume 1 and pitch 0.7
  - effect:sound{s=entity.elder_guardian.death;v=1;p=0.7} @self ~onDeath # When the mob dies, play the entity.elder_guardian.death sound with volume 1 and pitch 0.7
  - effect:sound{s=entity.blaze.death;v=0.3;p=0.7} @self ~onDeath # When the mob dies, also play the entity.blaze.death sound with volume 0.3 and pitch 0.7
```

--------------------------------

### Underwater Particle Example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Underwater

Example of using the underwater particle in a MythicMobs skill configuration.

```yaml
  Skills:
  - particle{p=underwater}

```

--------------------------------

### Show a character setup dialog to nearby players

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/ShowDialog

Shows a character setup dialog to all players within 10 blocks using the alias 'd' and the @PlayersInRadius targeter.

```yaml
  Skills:
  - showDialog{d=CharacterSetup} @PlayersInRadius{r=10}

```

--------------------------------

### Particle trial_spawner_detection_ominous example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Trial_Spawner_Detection_Ominous

Example of using the trial_spawner_detection_ominous particle in a MythicMobs skill configuration.

```yaml
  Skills:
  - particle{p=trial_spawner_detection_ominous}

```

--------------------------------

### Soul particle example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Soul

Example of using the soul particle in a MythicMobs skill configuration.

```yaml
  Skills:
  - particle{p=soul}

```

--------------------------------

### Disguise configuration example

Source: https://wiki.mythiccraft.io/mythicmobs/changelogs/2.0.x_changelogs

Shows the new way to configure disguises in MythicMobs, using a SHEEP type and a PLAYER type with Player and Skin options. The old configuration method still works.

```yaml
Mob:
  Type: ZOMBIE
  Health: 100
  Disguise:
    Type: SHEEP

Mob:
  Type: ZOMBIE
  Health: 100
  Disguise:
    Type: PLAYER
    Player: Ashijin
    Skin: Notch
```

--------------------------------

### Item Particle Example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Item

Example of using the item particle with material STONE in a skill.

```yaml
  Skills:
  - particle{p=item;material=STONE}

```

--------------------------------

### Flame particle example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Flame

Example of using the flame particle in a MythicMobs skill configuration.

```yaml
  Skills:
  - particle{p=flame}

```

--------------------------------

### Using LivingInLine with Forward and ignite

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Targeters/LivingInLine

Shows a metaskill that uses @Forward to move 10 blocks and then triggers ExampleSkill2, which applies ignite to entities in a line with a radius of 0.5.

```yaml
ExampleSkill1:
  Skills:
  - skill{s=ExampleSkill2} @Forward{f=10}

ExampleSkill2:
  Skills:
  - ignite @LivingInLine{r=0.5}

```

--------------------------------

### Flee Sun AI Goal Example

Source: https://wiki.mythiccraft.io/mythicmobs/Mobs/ai/goals/fleeSun

Example configuration for a zombie mob with the fleesun AI goal, setting speed to 2.

```yaml
ExampleMob:
  Type: ZOMBIE
  AIGoalSelectors:
    - clear
    - fleesun{s=2}

```

--------------------------------

### Particle falling_nectar Example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Falling_Nectar

Example of using the falling_nectar particle in a MythicMobs skill configuration.

```yaml
  Skills:
  - particle{p=falling_nectar}

```

--------------------------------

### Example skill using @TargetLocation

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Targeters/TargetLocation

Use this skill to apply particle effects at the target location. The example shows a skill named ExampleSkill with a single skill line that triggers particle effects at the target location.

```yaml
ExampleSkill:
  Skills:
  - effect:particles @TargetLocation

```

--------------------------------

### Particle falling_lava example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Falling_Lava

Example of using the falling_lava particle in a MythicMobs skill configuration.

```yaml
  Skills:
  - particle{p=falling_lava}

```

--------------------------------

### Example: Using @LocationsOfTargets in MythicMobs skills

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Targeters/LocationsOfTargets

Shows a skill configuration where ExampleSkill1 triggers ExampleSkill2 at the location of targets within a 10-block radius, and ExampleSkill2 casts lightning at those locations. Use this targeter to apply effects at the positions of inherited targets.

```yaml
ExampleSkill1:
  Skills:
  - skills{s=ExampleSkill2} @EIR{r=10}

ExampleSkill2:
  Skills:
  - lightning @LocationsOfTargets

```

--------------------------------

### Global Randomspawn Example

Source: https://wiki.mythiccraft.io/mythicmobs/Random-Spawns

Example of a global randomspawn configuration with all common options: Action, Type, Level, Chance, Priority, UseWorldScaling, Worlds, Biomes, and Conditions.

```yaml
    my_favorite_randomspawn:
      Action: ADD
      Type: cute_zombie
      Level: 2
      Chance: 0.01
      Priority: 10
      UseWorldScaling: false
      Worlds: my_overworld,my_overworld_nether
      Biomes: JUNGLE,PLAINS
      Conditions:
      - day true

```

--------------------------------

### isMythicMob condition example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Conditions/isMythicMob

Example of using the isMythicMob condition in a TargetConditions list. It has no attributes.

```yaml
  TargetConditions:
  - isMythicMob true

```

--------------------------------

### Crouching condition example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Conditions/crouching

Example condition configuration that checks if the target player is crouching.

```yaml
  Conditions:
  - crouching true

```

--------------------------------

### Tool component example with material list

Source: https://wiki.mythiccraft.io/mythicmobs/Items/Items

Configures a tool with custom mining speed and rules for specific materials. The rules override the default mining speed and correctness for those materials.

```yaml
OBSIDIAN_BREAKER:
  Id: COD
  Display: '&8Obsidian Breaker'
  Tool:
    DamagePerBlock: 1
    DefaultMiningSpeed: 0.0
    Rules:
      - materials: "OBSIDIAN,CRYING_OBSIDIAN"
        speed: 10000.0
        isCorrectForBlock: true

```

--------------------------------

### Skeleton King Banner Example

Source: https://wiki.mythiccraft.io/mythicmobs/Items/Banner-Layers

Example MythicMobs item configuration for a banner with multiple banner layers, using an orange banner as the base. This demonstrates the same layer pattern as the shield example but for a banner item.

```yaml
SkeletonKingBanner:
  Id: orange_banner
  Display: <dark_red>Skeleton King's Banner</dark_red>
  BannerLayers:
  - RED BASE
  - WHITE CURLY_BORDER
  - WHITE STRIPE_CENTER
  - BLACK STRIPE_BOTTOM
  - WHITE CREEPER
  - YELLOW STRIPE_TOP
  - BLACK TRIANGLES_TOP

```

--------------------------------

### Spawner Configuration Example

Source: https://wiki.mythiccraft.io/mythicmobs/Spawners

Example YAML configuration for a spawner. Defines spawn location, mob type, timers, cooldowns, and other options. Note that once loaded on a running server, this file can only be edited via in-game commands.

```yaml
SpawnerName:
  MobName: mobTypeName 
  World: worldname
  SpawnerGroup: GroupName
  X: 0 
  Y: 0 
  Z: 0 
  Radius: 0 
  RadiusY: 0 
  UseTimer: true  
  MaxMobs: 1
  MobLevel: 1
  MobsPerSpawn: 1
  Cooldown: 0
  CooldownTimer: 0
  Warmup: 0
  WarmupTimer: 0
  CheckForPlayers: true
  ActivationRange: 40
  LeashRange: 32
  HealOnLeash: false
  ResetThreatOnLeash: false
  ShowFlames: false
  Breakable: false
  Chance: 1
  RandomRotation: false
  UseWorldScaling: false
  Conditions: []
  ActiveMobs: 1

```

--------------------------------

### Line targeter example with radius 0.5

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Targeters/Line

Shows a metaskill that uses the Line targeter with a radius of 0.5 to spawn particles along a line from the mob to the inherited target. The first skill forwards 10 blocks before invoking the second skill.

```yaml
ExampleSkill1:
  Skills:
  - skill{s=ExampleSkill2} @Forward{f=10}

ExampleSkill2:
  Skills:
  - effect:particles @Line{r=0.5}

```

--------------------------------

### IsSibling condition example

Source: https://wiki.mythiccraft.io/mythicmobs/skills/conditions/IsSibling

Example of using the IsSibling condition in a TargetConditions list. The condition has no attributes.

```yaml
  TargetConditions:
  - IsSibling

```

--------------------------------

### Stun Mechanic Example

Source: https://wiki.mythiccraft.io/mythicmobs/changelogs/4.8.x_changelogs

Example of the Stun aura mechanic that stuns the target entity for its duration.

```mythicmobs
stun{auraName=stunned;d=100;facing=true;onTick=[ - particles{p=crit;amount=10;hS=0.4} ]} @trigger ~onInteract
```

--------------------------------

### Equip Copy Skill Example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/EquipCopy

Example of using the equipcopy skill in a MythicMobs skill configuration. The skill is applied to the target entity, copying their equipment slots (default ALL).

```yaml
  Skills:
  - equipcopy @target

```

--------------------------------

### Nested Inline Metaskills with Skill Variables

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Metaskills

Demonstrates nested inline metaskills and how they share the same skilltree, enabling the use of skill-scoped variables.

```yaml
  Skills:
  - skill{s=[
    - message{m="Hello there! A pleasure to meet you!"}
    - setvariable{var=skill.examplename;type=STRING;val=<target.name>}
    - skill{s=[
      - message{m="OHI, OHI! WHO IS THAT GUY OVER THERE NAMED <skill.var.examplename>?!?"}
      ]} @Owner
    ]} @target
```

--------------------------------

### SlimeSize condition example

Source: https://wiki.mythiccraft.io/mythicmobs/changelogs/4.11.x_changelogs

Example of the new SlimeSize condition, showing a size threshold of 5.

```yaml
- size >5

```

--------------------------------

### OnCooldownSkills with a list of mechanics

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Metaskills

Defines a list of mechanics to execute when the metaskill is on cooldown, instead of referencing another metaskill. The example shows a sound and a particle effect.

```yaml
  OnCooldownSkills:
  - s{s=entity.village.no}
  - particle{p=VILLAGER_ANGRY;y=1.5}

```

--------------------------------

### giveitemfromtarget example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/giveitemfromtarget

Example skill using giveitem with a diamond sword and amount 1, targeting players within 20 blocks on spawn.

```yaml
  Skills:
  - giveitem{i=diamond_sword;a=1} @PIR{r=20} ~onSpawn

```

--------------------------------

### variablesubtract example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/variablesubtract

Example skill using variablesubtract to subtract 1 from the variable skill.testVar on interact.

```yaml
  Skills:
  - variablesubtract{var=skill.testVar;amount=1} ~onInteract

```

--------------------------------

### summonPassenger example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/summonpassenger

Example skill configuration that summons a mob of type 'MyZombie' to ride the caster.

```yaml
  Skills:
  - summonPassenger{type=MyZombie}

```

--------------------------------

### Basic damage example with ignoreArmor

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Damage

Basic example dealing 20 damage ignoring armor to the target every 20 ticks.

```yaml
  Skills:
  - damage{amount=20;ignoreArmor=true} @target ~onTimer:20
```

--------------------------------

### currencytake skill example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/currencytake

Example skill that takes 20 money from all players within a radius of 20 blocks when the mob spawns.

```yaml
Skills:
- currencytake{amount=20} @pir{r=20} ~onSpawn
```

--------------------------------

### Oxygen mechanic example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/oxygen

Example skill that gives 10 oxygen to the trigger player on interaction.

```yaml
  Skills:
  - oxygen{amount=10} @trigger ~onInteract

```

--------------------------------

### ExampleMob with leapattarget AI goal

Source: https://wiki.mythiccraft.io/mythicmobs/Mobs/ai/goals/leapattarget

Example configuration for a zombie mob using the leapattarget AI goal with a speed of 4. The AIGoalSelectors list is cleared before adding the goal.

```yaml
ExampleMob:
  Type: ZOMBIE
  AIGoalSelectors:
    - clear
    - leapattarget{s=4}

```

--------------------------------

### Totem Of Undying Example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/TotemOfUndying

Example of using the totemofundying skill with model=2 on players in radius 5.

```yaml
PlayTotemEffect:
  Skills:
  - totemofundying{model=2} @PIR{r=5}

```

--------------------------------

### Give Experience Levels Example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/GiveExperienceLevels

Example skill configuration that gives one experience level to the triggering player when the mob is damaged.

```yaml
ExampleMob:
  Type: ZOMBIE
  Skills:
  - giveexperiencelevels{a=1} @trigger ~onDamaged

```

--------------------------------

### Basic mob configuration with Options

Source: https://wiki.mythiccraft.io/mythicmobs/Mobs/Options

Shows the basic structure of a MythicMobs mob configuration with the Options section. The example sets MovementSpeed and PreventSunburn for a skeleton.

```yaml
Dummy:
  Type: skeleton
  Options:
    MovementSpeed: 0.3
    PreventSunburn: true

```

--------------------------------

### Particle warped_spore skill example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Warped_Spore

Example skill configuration that triggers the warped_spore particle effect.

```yaml
  Skills:
  - particle{p=warped_spore}

```

--------------------------------

### Wax Off Particle Example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Wax_Off

Example of using the wax_off particle in a MythicMobs skill. The particle has no attributes.

```yaml
  Skills:
  - particle{p=wax_off}

```

--------------------------------

### Inline MetaSkills with projectile and nested skills

Source: https://wiki.mythiccraft.io/mythicmobs/changelogs/4.7.x_changelogs

Shows how to use inline MetaSkills by placing a list of mechanics inside square brackets for onHit, onTick, and onEnd options of a projectile skill. This avoids creating separate skill files. The example uses a projectile with a MAGMA_BLOCK bullet and nested damage, ignite, particles, sound, and area damage effects.

```yaml
Skills:
- projectile{
      interval=1; velocity=30; bulletType=BLOCK; material=MAGMA_BLOCK; tyo=0.5; g=1; bulletSpin=-40; hnp=true; stopatentity=false; duration=100;
      onHit=[
          - damage{amount=50}
          - ignite{ticks=20}
      ];
      onTick=[
          - particles{p=flame;a=20;hs=0.5;vs=0.5}
      ];
      onEnd=[
          - particles{p=largeexplode;a=50;speed=1;hs=0.05;vs=0.05}
          - effect:sound{s=entity.dragon_fireball.explode;p=0.6;v=2}
          - damage{amount=30} @ENO{r=5}
      ];
  } @targetlocation

```

--------------------------------

### Fake Lightning Skill Example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/FakeLightning

Example skill configuration demonstrating the fakelightning effect on different targets, including a repeated version with a 1-tick interval.

```yaml
SuperLightningSkill:
  Skills:
  - fakelightning @target
  - fakelightning @self
  - fakelightning{repeat=20;repeatInterval=1} @PIR{r=100}

```

--------------------------------

### Tinted Leaves Particle Example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Tinted_Leaves

Example of using the tinted_leaves particle in a MythicMobs skill configuration.

```yaml
  Skills:
  - particle{p=tinted_leaves}

```

--------------------------------

### Book option example

Source: https://wiki.mythiccraft.io/mythicmobs/Items/Items

Sets book options including title, author, and pages. Pages can contain newlines using \n.

```yaml
SomeBook:
  Id: WRITTEN_BOOK
  Title: <green>How to make YouTube Videos
  Author: CarsonJF
  Pages:
  - "Page 1"
  - "Page 2\n\nwith some other lines"
  - "Page 3"

```

--------------------------------

### Example drop list with attributes

Source: https://wiki.mythiccraft.io/mythicmobs/drops/FancyDrops

A multi-line example of a Drops list with multiple items, each using inline attributes for visual effects and holograms.

```yaml
  Drops:
  - amber_1{itemglow=true;itemglowcolor=GOLD;hn=true;lootsplosion=true;vfxmaterial=POTION;vfxdata=21;vfxc=#55ff55} 1 1
  - adamantium_ore{itemglow=true;itemglowcolor=WHITE;hn=true;lootsplosion=true;vfxmaterial=POTION;vfxdata=21;vfxc=#55ff55} 1 1
  - amethyst_1{itemglow=true;itemglowcolor=YELLOW;hn=true;lootsplosion=true;vfxmaterial=POTION;vfxdata=21;vfxc=#55ff55} 1 1
  - andesite_bricks{itemglow=true;itemglowcolor=LIGHT_PURPLE;hn=true;lootsplosion=true;vfxmaterial=POTION;vfxdata=21;vfxc=#55ff55} 1 1
  - bananarang{itemglow=true;itemglowcolor=RED;hn=true;lootsplosion=true;vfxmaterial=POTION;vfxdata=21;vfxc=#55ff55} 1 1
  - augment_sword_midas_6{itemglow=true;itemglowcolor=AQUA;hn=true;lootsplosion=true;vfxmaterial=POTION;vfxdata=21;vfxc=#55ff55} 1 1
  - blue_stained_tiles{itemglow=true;itemglowcolor=GREEN;hn=true;lootsplosion=true;vfxmaterial=POTION;vfxdata=21;vfxc=#55ff55} 1 1
  - black_stained_tiles{itemglow=true;itemglowcolor=BLUE;hn=true;lootsplosion=true;vfxmaterial=POTION;vfxdata=21;vfxc=#55ff55} 1 1
  - bismuth_2{itemglow=true;itemglowcolor=DARK_RED;hn=true;lootsplosion=true;vfxmaterial=POTION;vfxmodel="mythic:effects/item_beam_3"} 1 1

```

--------------------------------

### Sculk Soul Particle Example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Sculk_Soul

Example of using the sculk_soul particle in a MythicMobs skill configuration.

```yaml
  Skills:
  - particle{p=sculk_soul}

```

--------------------------------

### packinfo.yml metadata example

Source: https://wiki.mythiccraft.io/mythicmobs/Packs

Place this file in the pack's main directory to embed metadata such as name, version, author, icon, URL, and description. The description supports color codes and is shown when hovering over the pack icon in the MythicMobs menu (`/mm menu`).

```yaml
Name: The name of the pack
Version: 0.1.0
Author: The name of the author
Icon:
  Material: The bukkit name of the item you want to use
  Model: The CustomModelData of the material
URL: The link to your site, if any
Description:
- This is a list
- of things that will appear
- as the pack's description
- &aYou can also use color codes!&r

```

--------------------------------

### Nautilus particle example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Nautilus

Example of using the nautilus particle in a MythicMobs skill. The particle has no attributes.

```yaml
  Skills:
  - particle{p=nautilus}

```

--------------------------------

### Create a custom menu named MyCustomMenu

Source: https://wiki.mythiccraft.io/mythicmobs/Custom-Menus

Defines a menu with a 27-slot grid, a filler icon, a test button that plays a sound and sends a message, and a dynamic button. The schema maps characters to icons.

```yaml
MyCustomMenu:
  Display: "My Custom Menu"
  Size: 27
  Shared: false # Whether the Menu should not be cached and shared across players
  Schema:
    - '1 1 1 1 1 1 1 1 1'
    - '0 0 0 0 B 0 0 0 0'
    - '1 1 1 1 1 1 1 1 1'
  Icons:
    FILLER:
      Mapping: 1
      Material: RED_STAINED_GLASS_PANE
      Display: ''
      Model: 1
    TEST_BUTTON:
      Mapping: B
      Material: GOLD_INGOT
      Model: 4
      Display: 'Test'
      Skills:
      - sound{s=entity.chicken.egg}
      - setcustommenubutton{slot=11;icon=DYNAMIC_BUTTON}
      - message{m="you hit me"} @self
    DYNAMIC_BUTTON:
      Material: IRON_SWORD
      Model: 100

```

--------------------------------

### Glow Particle Example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Glow

Example of using the glow particle in a MythicMobs skill. The particle has no attributes.

```yaml
  Skills:
  - particle{p=glow}

```

--------------------------------

### Fishing particle example

Source: https://wiki.mythiccraft.io/mythicmobs/Skills/Mechanics/Particle/Particle-Types/Fishing

Example of using the fishing particle in a MythicMobs skill. The particle has no attributes.

```yaml
  Skills:
  - particle{p=fishing}

```