MythicMobs
The foundation of the Mythic suite: a YAML system for custom mobs, a scripting language of mechanics, targeters, triggers and conditions, plus items, drop tables, spawners and stats. This page covers the file layout, the anatomy of a skill line, and the complete indexes of every documented mechanic, targeter, trigger and condition.
MythicMobs is a Paper/Spigot server plugin, not a data pack β its content lives in plugins/MythicMobs/ as YAML. Version syntax on this page targets the 5.13.x line. Where the docs mark a feature as Premium-only it is flagged; see free vs premium.
File layout & commands
Content is split by kind, each in its own folder. Any number of .yml files may live in each β Mythic merges them, so one file per mob or one file for fifty both work.
plugins/MythicMobs/
config/ # config-general, -mobs, -items, -skills, -spawning
Mobs/ # mob definitions
Skills/ # metaskills
Items/ # item definitions
DropTables/ # drop tables
Spawners/ # spawner definitions (see the warning below)
RandomSpawns/ # natural-spawn rules
Stats/ # custom stat definitions
packs/ # self-contained content bundles
The base command is /mm (alias /mythicmobs). Required arguments are shown in [], optional in <>.
| Command | Does |
|---|---|
/mm reload (/mm r) | Reloads the plugin. |
/mm debug [level] | Sets debug level; 0 is off. |
/mm debugmode [true|false] | Disables random/mob spawners and other noise that makes debugging hard. |
/mm mobs spawn [mob]:<level> <amount> <world,x,y,z,yaw,pitch> | Spawns a mob. |
/mm mobs info [mob] | Dumps everything Mythic knows about a mob definition. |
/mm mobs list / listactive | Loaded definitions / currently spawned mobs. |
/mm mobs kill [mob] / killall | Removes mobs by name, or all of them. |
/mm items get [item] <amount> | Gives yourself a Mythic item. |
/mm item import <itemName> [fileName] | Imports the held item into Items/. |
/mm egg get [mob] <amount> | Gives a spawn egg for a Mythic mob. |
/mm test cast [metaskill] | Casts a metaskill for testing. |
/mm camera <pathId> add|remove [index] 5.13.0 | Authors cinematic camera paths in-game. |
/mm save | Force-saves active mobs and spawners. |
Several commands take flags before their first argument:
| Flag | Effect | Example |
|---|---|---|
-s | Silent β no chat feedback. | /mm test cast -s [metaskill] |
-p <player> | Execute at the given player. | /mm m s -p <player> [mob] |
-t | Execute at your target location. | /mm m s -t [mob] |
-n | Fake a NATURAL spawn reason instead of COMMAND. | /mm m s -n [mob] |
-f [faction] | Act on all mobs of a faction. | /mm m kill -f [faction] |
-d | Drop on the ground if the inventory is full. | /mm i give -d [item] |
Defining a mob
Only two things are required: the internal name (the YAML key, no spaces, unique) and Type. Everything else is optional.
plugins/MythicMobs/Mobs/example.yml
SkeletalKnight:
Type: WITHER_SKELETON
Display: '<gold>Skeletal Knight'
Health: 200
Damage: 12
Armor: 15
Faction: undead
Options:
MovementSpeed: 0.25
PreventOtherDrops: true
Despawn: false
Equipment:
- IronSword HAND
- DiamondHelmet HEAD
Skills:
- skill{s=KnightSlam} @target ~onAttack 0.2
Drops:
- GoldCoin 1-4 0.5
- exp 50 1
The documented top-level mob options are:
| Option | Purpose |
|---|---|
Type | Base entity type. Required. New vanilla entity types only work once Mythic adds support. |
Display | Display name; supports colour codes and placeholders. Does not auto-update β use the setname mechanic to change it later. |
Health | Base max health. Spigot caps this at 2048 by default (raise it in spigot.yml). |
Damage | Base melee damage. 1 damage = half a heart. Never affects ranged/projectile damage. |
Armor | Base armor attribute. Minecraft caps armor at 30. |
HealthBar | Hologram health bar above the mob (Enabled, Offset). |
BossBar | Wither/dragon-style bar (Enabled, Title, Range, Color, Style, CreateFog, DarkenSky, PlayMusic). |
Faction | Faction name, used by custom AI and targeter filtering. |
Mount | Another Mythic mob to spawn and ride. |
Options | Large per-entity option block (movement speed, despawn, collidability, β¦). |
Display Options | Options specific to display entities. |
Modules | Opt-in behaviour modules such as threat and immunity tables. |
AIGoalSelectors / AITargetSelectors | Replace the vanilla AI goal/target lists outright. |
AIPathfindingMalus | Per-block pathfinding cost overrides. |
Drops | Inline drop list (see Drops). |
DamageModifiers | Per-damage-type multipliers β immunity, healing from a type, resistances. |
Equipment | Items placed in equipment slots on spawn. |
KillMessages | Custom death messages. |
Level / LevelModifiers | Base level and per-level stat scaling. |
Disguise | LibsDisguises integration. |
Skills | The skill list (see below). |
Nameplate | Nameplate rendering options. |
Hearing | Lets the mob react to sounds. |
Totem | Totem behaviour. |
Variables | Per-mob variables set at spawn. |
Trades | Villager trade definitions. |
Display is rendered once. A name containing a placeholder such as <caster.hp> will show the value from spawn time and then sit there stale. To keep it live you must re-apply it, e.g. setname on a repeating timer skill.
Anatomy of a skill line
Every skill line follows one grammar. Only the mechanic is mandatory:
The general form
- mechanic{argument=value} @[targeter] ~on[trigger] [health_modifier] [chance]
A concrete line, and what each part contributes:
plugins/MythicMobs/Mobs/fiery.yml
FieryZombie:
Type: ZOMBIE
Display: 'Fiery Zombie'
Health: 50
Skills:
- ignite{ticks=100} @target ~onAttack <50% 0.5
| Part | In the example | Meaning |
|---|---|---|
| Mechanic | ignite | What happens. The base action. Required. |
| Arguments | {ticks=100} | In braces, separated by ;. Most have defaults. |
| Targeter | @target | What it is aimed at. Always prefixed @; may take its own {} options. |
| Trigger | ~onAttack | When it fires. Prefixed ~. Only valid in a mob's own Skills list. |
| Health modifier | <50% | Only run while the caster's health is under (or over, with >) that fraction. |
| Chance | 0.5 | Probability from 0 to 1 that the line executes. |
There are 20 ticks in a second, so ticks=100 is five seconds. Long argument lists may be wrapped for readability as long as the YAML indentation stays valid:
Wrapped argument style
Skills:
- mechanic{option=value;
option=value;
option=value}
Metaskills
A metaskill is a named, reusable skill defined in Skills/ and invoked with the skill mechanic. This is where conditions, timers and multi-step sequences live.
plugins/MythicMobs/Skills/knight.yml
KnightSlam:
Cooldown: 8
Conditions:
- targetwithin 5
Skills:
- sound{s=entity.generic.explode;v=1;p=0.8} @self
- particles{p=explode;amount=30;hS=1;vS=0.5} @origin
- damage{amount=18} @EntitiesInRadius{r=4}
- throw{velocity=6;velocityY=3} @EntitiesInRadius{r=4}
Calling it accepts several equivalent spellings:
Skills:
- skill{skill=KnightSlam}
- skill{s=KnightSlam}
- skill:KnightSlam
Skill parameters β passing arguments into a metaskill so one definition serves many callers β are a Premium feature, as are in-line target conditions and origin=@targeter.
Mechanic index
Mechanics are the verbs. These usually target entities, though many accept locations too. 241 documented mechanics:
| Mechanic | Description |
|---|---|
ActivateSpawner | Activates a MythicMobs spawner at the targeted location |
AddTrade | Changes the trades of a villager |
AnimateArmorStand | Animates an armorstand |
ArmAnimation | Makes the caster swing their arm |
ArrowVolley | Fires a volley of arrows |
AttributeModifier | Adds an attribute modifier to the attributable target |
AuraRemove | Removes an aura from the target entity |
BarCreate | Creates a custom boss bar on the casting mob |
BarRemove | Removes a custom boss bar on the casting mob |
BarSet | Modifies a custom boss bar on the casting mob |
BlackScreen | Blacks out the target's screen for the duration |
BlockDestabilize | Causes the targeted blocks to fall, as if affected by gravity |
BlockMask | Temporarily masks a block as a different block |
BlockUnmask | Unmasks blocks that have been masked |
BlockPhysics | Triggers a block physics update at the target location |
BlockWave | Creates a wave of blocks at the target location |
BloodyScreen | Makes the target's screen glow red |
BoneMeal | Applies a bone meal effect to the target blocks |
BossBorder | Creates an inescapable border around the mob |
Bouncy | Applies an aura to the target that makes it bouncy |
BreakBlock | Breaks the block at the target location |
BreakBlockAndGiveItem | Breaks the block at the target location and gives an item/droptable |
ClearExperience | Clears the experience for the targeted players |
ClearExperienceLevels | Clears the experience levels for the targeted players |
ClearTarget | Forces the target of the mechanic to reset its current target |
GiveExperienceLevels | Gives experience levels to the targeted players |
TakeExperienceLevels | Takes experience levels to the targeted players |
CloseInventory | Closes the target player's inventory |
Command | Executes a command for each target |
Consume | Deals damage and restores health per target hit |
ConsumeSlot | Remove an item from a specific slot of the player's inventory |
DirectionalVelocity | Changes the velocity on the target entity on a specific vector |
Disengage | Causes the caster to leap backwards away from the target entity |
Disguise | Changes the caster's disguise |
DisguiseModify | Modifies the caster's already applied disguise |
DisguiseTarget | Changes the target's disguise |
Undisguise | Remove the caster's disguise |
Dismount | Makes the caster dismount whatever they're riding |
DisplayTransformation | Sets the targeted display entity's transformations |
ClearThreat | Makes a mob clear its threat table |
CurrencyGive | Give money to a player. Requires Vault and a currency plugin |
CurrencyTake | Take money from a player. Requires Vault and a currency plugin |
Damage | Damages the target for an amount |
BaseDamage | Damages the target for a percent of the mob's damage stat |
PercentDamage | Damages the target for a percent of their health |
Decapitate | Drops a player head item based on target |
Doppleganger | Copies the appearance of the target player |
DropItem | Drops an item or droptable at the target location |
EjectPassenger | Ejects anything riding the caster |
Ender | Causes the "Ender" effect |
EnderBeam | Creates a EnderCrystal's beam effect to the target |
EnderDragonResetCrystals | Generates the EnderDragon crystals |
EnderDragonSetPhase | Sets the EnderDragon phase |
EnderDragonSetRespawnPhase | Sets the EnderDragon respawn phase |
EnderDragonSpawnPortal | Generates the portal of the EnderDragon battle |
Equip | Causes the casting mob to equip an item |
EquipCopy | Causes the caster to equip a copy of the target's equipment |
Explosion | Causes an explosion |
FakeExplosion | Causes a fake explosion |
Extinguish | Removes fire ticks from the target entity |
FawePaste | Pastes a Schematic using FAWE (Fast Async World Edit) |
Feed | Feeds the target player |
Fear | Applies an aura that makes the target run around in fear |
FillChest | Fills a chest with items, or a droptable |
Firework | Creates a firework effect at the target |
Flames | Creates the flames effect at the location of the targeter |
Fly | Applies an aura that allows the targeted player to fly |
ForcePull | Teleports the target to the caster |
Freeze | Freezes the target for the given number of ticks using the Powdered Snow freezing effect |
Geyser | Creates a "geyser" of water or lava |
GiveItem | Gives an item to the target |
GiveItemFromSlot | Gives an item to the target from the item in the given slot of caster |
GiveItemFromTarget | Gives the caster an item while playing the pickup-item animation from the target entity or location |
Glow | Makes the target glow |
GoatRam | Causes the casting goat mob to ram the targeted entity |
GoTo | Move toward the location of the targeter (entity or location) |
GuardianBeam | Draws a guardian beam between the origin and the target |
Heal | Heals the target |
HealPercent | Heals the target for a percentage of its max-health |
Hide | Hides the caster from the targeted player(s) for a set duration. |
Hit | Simulates a physical hit from the mob. |
Hologram | Summons a hologram to the targeted location |
Ignite | Sets the target on fire |
ItemSpray | Causes an explosion of temporary items at the target location |
JSONMessage | Sends a JSON-format message to the target player(s) |
Jump | Causes the caster to jump |
Leap | Causes the caster to leap towards the target |
Lightning | Strikes lightning at the target |
FakeLightning | Strikes a fake lightning at the target |
Log | Logs a message to console. |
Look | Causes the caster to look at the target |
Lunge | Causes the caster to lunge forward at the target |
MatchRotation | Sets the caster's yaw and pitch to the same value of the target's |
Message | Sends a message to the target player(s) |
ModifyDamage | Modifies the damage event that triggered the skill |
ModifyGlobalScore | Modifies a scoreboard value of the fake player: \_\_GLOBAL\_\_ |
ModifyTargetScore | Modifies a scoreboard value of the target |
ModifyMobScore | Modifies a scoreboard value of the casting mob |
ModifyScore | Modifies the score of a dummy player |
Mount | Summons a mob for the caster and mounts it |
MountMe | Forces the targeted entity to mount the caster |
MountTarget | Mounts the target |
MovePin | Moves the given pin to the target location |
OpenCustomMenu | Opens a custom menu |
OpenTrades | Opens the trades of the casting villager to the target player |
Oxygen | Gives oxygen to a player target |
Particle | Creates particle effects around the target |
ParticleBox | Draws a box of particles around the target |
ParticleEquation | Generates particles based on equations |
ParticleLine | Draws a line of particle effects to the target |
ParticleLineHelix | Draws a line based helix effect |
ParticleLineRing | Draws a particle ring connected by lines |
ParticleOrbital | Draws orbiting particle effects around the target |
ParticleRing | Draws a ring of particles around the target |
ParticleSphere | Draws a sphere of particles around the target |
ParticleTornado | Draws a persistent "tornado" of particles at the target |
Atom | Creates some particles in the shape of an atom |
PickUpItem | Pick up the targeted item |
PlayAnimation | Forces the entity to play an animation |
PlayBlockBreakSound | Plays a block breaking sound |
PlayBlockFallSound | Plays a block falling sound |
PlayBlockHitSound | Plays a block hit sound |
PlayBlockPlaceSound | Plays a block place sound |
PlayBlockStepSound | Plays a block step sound |
PoseArmorStand | Changes the pose of the target ArmorStand |
Potion | Applies a potion effect to the target |
PotionClear | Removes all potion effects from target entity |
Prison | Imprisons the target inside a block |
PrintParentTree | Prints debug information regarding the Metaskill executing the mechanic and its SkillTree |
Propel | Propels the caster towards the target |
Pull | Pulls the target towards the mob |
PushBlock | Pushes the block at the target location in the given direction |
PushButton | Pushes a button at the target location |
RayTrace | Traces a straight line to the target |
RayTraceTo | Executes a skill with the result of a raytrace to the target location |
Rally | Causes other nearby mobs to attack the target |
RandomMessage | Sends a random message to the target player |
Recoil | Kicks the target's screen in order to simulate a recoil |
Remount | Remounts the mob the caster originally spawned riding, if it is still alive |
Remove | Removes the target mob |
RemoveHeldItem | Removes some of the item the target player is holding |
RemoveOwner | Removes the ownership of the target mob |
ResetAI | Attempts to resets the AI of a casting mob to the base type's default |
RotateTowards | Rotates the caster towards the target location |
RunAIGoalSelector | Change the caster's AIGoalSelectors |
RunAITargetSelector | Change the caster's AITargetSelectors |
Saddle | Equips or remove a saddle on the target entity |
SendActionMessage | Sends an Actionbar Message to the target player |
SendResourcePack | Sends a Resource Pack to the target player |
SendTitle | Sends a Title/Subtitle Message to the target player |
SendToast | Sends an achievement toast to the target player |
SetAI | Disables/enables the AI of the target mob |
SetBlockOpen | Sets the target block's open state |
SetBlockType | Change block type at target location |
SetChunkForceLoaded | Sets the force-loaded status of a location's chunk |
SetCollidable | Sets if the target should have a collidable hitbox or not |
SetCustomMenuButton | Sets a specific slot of the opened custom menu to the specified button |
SetDragonPodium | Sets the position of the dragon's podium at the target location |
SetGameMode | Sets the Game Mode of the target player |
SetGliding | Makes the target glide if they have elytra |
SetGlobalScore | Sets a scoreboard value on the fake player: \_\_GLOBAL\_\_ |
SetGravity | Sets whether gravity affects the target entity |
SetHealth | Sets the health of the target entity |
SetInteractionSize | Sets the size of the target INTERACTION entity. |
SetItemGroupCooldown | Sets the cooldown on an item group for the target player |
setDisplayEntityItem | Sets the item component of ITEM_DISPLAY entities. |
SetLeashHolder | Changes the holder of a mobs lead |
SetLevel | Changes the casting mob's level |
SetMaterialCooldown | Sets a cooldown for usable materials like ender pearls, chorus fruit, etc |
SetMaxHealth | Sets the max health of the target entity |
SetMobColor | Changes the color of the target if it is a colorable mob |
SetMobScore | Sets a scoreboard value on the casting mob |
SetName | Changes the caster entity's name |
setRaiderCanJoinRaid | Sets if the target raider entity can join a raid or not |
SetRaiderPatrolBlock | Sets the target raider to patrol a location |
SetRaiderPatrolLeader | Sets the raider patrol leader |
SetFaction | Changes the target entity's faction |
SetFlying | Sets whether the target player is flying |
SetNoDamageTicks | Sets the nodamageticks of the target |
SetOwner | Makes the target the owner of the casting mob |
SetParent | Makes the target the parent of the casting mob |
SetPathfindingMalus | Sets the pathfinding malus of a mob for given terrain types |
SetPitch | Sets the head pitch of the target entity |
SetPose | Sets the entity's pose |
SetRotation | Sets the rotation of the target |
SetTarget | Sets the caster's target |
SetTargetScore | Sets the score of the target |
SetTextDisplay | Sets the text component of target Text Display entity |
SetTongueTarget | Sets the tongue target for a frog caster to the target entity |
SetScore | Sets the scoreboard value of a dummy player |
SetSpeed | Sets the target entity's speed attribute |
SetStance | Sets the stance of the target mob |
Shield | Applies an absorb shield to the target entity |
ShieldBreak | Forces the player to lower their shield and puts it on cooldown |
ShieldPercent | Applies an absorb shield to the target entity for a percentage of their max health |
ShootFireball | Shoots a fireball at the target |
ShootPotion | Throws a potion at the target |
ShootSkull | Shoots a wither skull at the target |
ShootShulkerBullet | Shoots a shulker bullet at the target entity |
ShowEntity | Shows the hidden caster to the targeted players |
Signal | Sends a signal to a mob |
Skybox | Alters the target player's skybox |
Smoke | Creates a puff of smoke |
SmokeSwirl | Creates a persistent "swirl" of smoke |
Sound | Plays a sound effect from both vanilla Minecraft and resource packs |
StealItem | Steals an item from the target and puts it in the mob's hand |
StopSound | Stops a sound effect from playing |
Speak | Causes the mob to speak in chat, with options for speech bubbles |
Spin | Causes the target to spin |
Spring | Creates a temporary spring of liquid at the target |
Stun | Applies an aura that stuns the target entity |
StopUsingItem | Stops the targeted entity from using an item |
Suicide | Causes the caster to die |
Summon | Summons other mobs at the target |
SummonAreaEffectCloud | Summons a cloud of particles at the target |
SummonFallingBlock | Summons a falling block |
SummonPassenger | Summons a mob to ride the target. |
Swap | Swaps locations with the target |
SwingOffhand | Makes the casting player swing their offhand |
AddTag | Adds a scoreboard tag to the target |
RemoveTag | Removes a scoreboard tag from the target |
TakeItem | Removes an item from the targeted player's inventory |
Taunt | Modifies the threat level that the caster holds with the target entities |
Teleport | Teleports to the target |
TeleportY | Teleports the caster vertically |
TeleportIn | Teleports the target relative to the caster's yaw |
TeleportTo | Teleports the target to a specified location |
Time | Changes the time |
Threat | Modifies the mob's threat towards the target |
Throw | Throws the target entity |
ThunderLevel | Creates a client-side, per-player rainless storm |
ToggleLever | Toggles a lever at the target location |
TogglePiston | Toggles a piston at the target location |
ToggleSitting | Toggles the sitting state for cats, dogs, foxes, and parrots. |
TotemOfUndying | Plays the effect of a player resurrecting |
TrackLocation | Sets the mob's tracked location to the targeted location |
UndoPaste | Undoes a previously made paste |
Velocity | Modifies the velocity of the target entity(s) |
Weather | Modifies the weather in the target world |
WolfSit | Forces a targeted wolf to sit. |
WorldEditReplace | Replaces blocks in a region using WorldEdit |
The list above is core MythicMobs only. ModelEngine, MythicCrucible, MythicEnchantments and MCPets each register additional mechanics that only exist when that plugin is installed.
Meta-mechanic index
Meta-mechanics operate on other skills β branching, looping, delaying and composing. 59 documented:
| Mechanic | Description |
|---|---|
Skill | Executes a meta-skill. The butter for your bread. |
VariableSkill | Executes a meta-skill. Supports placeholders. |
Aura | Applies an aura to the targeted entity, allowing for skills to be run onStart/onTick/onEnd/Etc which all originate from the target. |
Beam | Creates a beam of a material between the caster and the target |
CancelEvent | Cancels the Event that triggered the current skill-tree. Only works for certain triggers. |
CancelSkill | Cancels the execution of the Metaskill when triggered. |
Cast | Applies an aura that "Casts" a meta-skill using various advanced options. |
Chain | Chains a skill between multiple targets that are near each other. |
ChainMissile | A missile that chains between entities. Premium-Only mechanic! |
Delay | Delays execution of the current skill list by a set number of ticks. |
DetermineCondition | Determines the outcome of a Metaskill that is used as a Condition via the MetaskillCondition condition |
EndProjectile | Terminates the projectile. Only usable in projectile mechanics. |
ForEach | Executes a metaskill once for each target of the mechanic |
ForEachValue | Executes a metaskill once for each entry or key-value pair in the specified value |
ForEachPin | Executes a metaskill once for each pin of a multi-pin |
GlobalCooldown | Sets the caster's Global Cooldown timer |
Missile | Fires a homing projectile towards the target. |
ModifyProjectile | Modifying the projectile / missile / orbital |
OnAttack | Applies an aura to the target that triggers skills when they attack |
OnDamaged | Applies an aura to the target that triggers skills when they take damage |
OnShoot | Applies an aura to the target that triggers skills when they shoot a bow |
OnBlockBreak | Applies an aura to the target that triggers skills when they break a block |
OnBlockPlace | Applies an aura to the target that triggers skills when they place a block |
OnChat | Applies an aura to the target that triggers skills when they chat |
OnSwing | Applies an aura to the target that triggers skills when they swing / left click |
OnInteract | Applies an aura to the target that triggers skills when they interact / right click while holding a block or looking at an outlined block (NOT AIR) |
OnJump | Applies an aura to the target that triggers a skill when they jump (PAPER ONLY MECHANIC) |
OnDeath | Applies an aura to the target that triggers a skill when they die |
Orbital | Applies an aura that causes a projectile to orbit around the target |
FollowPath | Applies an aura that causes the mob to follow a path |
FormLine | Applies an aura that causes the mob to follow a straight path |
Polygon | Creates a highly-customizable polygon-shaped pattern that can execute metaskills. |
Projectile | Fires a highly-customizable projectile towards the target |
ProjectileVelocity | Modifies the velocity of the calling Projectile or Missile |
RandomSkill | Executes a random skill from a list |
SetSkillCooldown | Sets the given metakill's cooldown to the given value |
SetProjectileDirection | Sets the calling projectile's movement direction to the given target |
SetProjectileBulletModel | Sets the model of the projectile. (DISPLAY bullets only) |
Shoot | Shoots a item-projectile at the target, similar to arrows/eggs/snowballs. |
Slash | Creates a highly-customizable slash pattern that can execute metaskills. |
SudoSkill | Makes the target execute a skill |
Switch | Acts as a switch/case |
StatAura | Applies an aura to the target that applies a specific stat to them |
Totem | Creates a static "totem" at a location that can execute other skills |
Terminable | Creates an aura that cancels the execution of its onStart metaskill is some conditions are met |
Volley | Shoots a volley of projectile-items at the target with various options |
VariableAdd | Adds an amount to a numeric variable |
VariableMath | Performs math on a numeric variable |
SetVariable | Sets the value of a variable |
SetVariableLocation | Sets a variable to the target location |
VariableUnset | Unsets the variable |
VariableSubtract | Subtracts an amount from a numeric variable |
VariableMove | Moves an already created variable across names and/or registries |
Wait | Puts the metaskill on hold until a set of conditions is met |
CinematicCamera | Plays a cinematic camera path for the target player |
CinematicCancel | Cancels an active cinematic for the target player |
CloseDialog | Closes any open dialog for the target player |
OnKeyPress | Applies an aura that triggers a skill when the player presses a key |
OnKeyRelease | Applies an aura that triggers a skill when the player releases a key |
Targeter index
Targeters answer "aimed at what". They split into entity targeters, location targeters and meta targeters. 88 documented:
| Targeter | Shorthand | Description |
|---|---|---|
@Self | @Caster / @Boss / @Mob | Targets the caster of the mechanic |
@Target | @T | Targets the caster's target |
@NearestPlayer | — | Targets the nearest player in radius |
@WolfOwner | — | Targets the owner of the wolf |
@Owner | — | Targets the owner of the mob |
@Parent | @summoner | Targets the parent of the mob |
@Mount | — | Targets the caster's original mount |
@Father | @dad / @daddy | Targets the father of the casting mob. |
@Mother | @mom / @mommy | Targets the mother of the casting mob. |
@Passenger | — | Targets the rider of the casting mob. |
@PlayerByName | @specificplayer | Targets a specific player by name. Supports placeholders. |
@UniqueIdentifier | @UUID | Targets a specific entity by their UUID, supports placeholders |
@Vehicle | — | Targets the caster's vehicle |
@InteractionLastAttacker | @lastAttacker | Targets the last entity that attacked the casting INTERACTION entity |
@InteractionLastInteract | @lastInteract | Targets the last entity that interacted with the casting INTERACTION entity |
@OwnerLocation | — | Targets the position of the owner of the mob |
@ParentLocation | @summonerlocation | Targets the position of the parent of the mob |
@LivingInCone | @entitiesInCone / @livingEntitiesInCone / @LEIC / @EIC | Targets all living entities in cone with a specified angle, length and rotation relative to facing direction |
@LivingInWorld | @EIW | Targets all living entities in the caster's world |
@NotLivingNearOrigin | @nonLivingNearOrigin / @NLNO | Targets all non living entities in a radius near the origin |
@PlayersInRadius | @PIR | Targets all players in the given radius |
@MobsInRadius | @MIR | Targets all mythicmobs or vanilla overrides of the given type in a radius |
@EntitiesInRadius | @livingEntitiesInRadius / @livingInRadius / @allInRadius / @EIR | Targets all entities in the given radius. |
@EntitiesInRing | @EIRR | Targets all entities in the given ring. |
@EntitiesInRingNearOrigin | @ERNO | Targets all entities in the given ring around the origin. |
@PlayersInWorld | @World | Targets all players in the current world. |
@PlayersOnServer | @Server / @Everyone | Targets all players in the server. |
@PlayersInRing | — | Target all players between the specified min and max radius. |
@PlayersNearOrigin | @PNO | Targets players near the origin of a meta-skill. |
@TrackedPlayers | @tracked | Targets players that are within the render distance of the caster |
@MobsNearOrigin | — | Targets all MythicMobs or vanilla overrides of the given type(s) in a radius around the origin |
@EntitiesNearOrigin | @ENO | Targets all entities near the origin of a meta-skill |
@Children | @child / @summons | Targets any child entities summoned by the caster. |
@Siblings | @sibling / @brothers / @sisters | Targets any mobs that share the same parent as the caster. |
@ItemsNearOrigin | — | Targets item drops near the origin of a meta-skill. |
@ItemsInRadius | @IIR | Targets all item drops in the given radius |
@ThreatTable | @TT | Targets every entity on the casting mob's threat table |
@ThreatTablePlayers | — | Targets all the players on the casting mob's threat table |
@RandomThreatTarget | @RTT | Targets a random entity on the casting mob's threat table |
@RandomThreatTargetLocation | @RTTL | Targets the location of a random entity on the casting mob's threat table |
@SelfLocation | @casterLocation / @bossLocation / @mobLocation | Targets the caster's location |
@SelfEyeLocation | @eyeDirection / @casterEyeLocation / @bossEyeLocation / @mobEyeLocation | Targets the caster's eye location |
@Forward | — | Targets a location in front of caster's facing direction |
@ProjectileForward | — | Targets a location in front of the casting projectile, relative to its direction |
@TargetLocation | @targetloc / @TL | Targets the caster's target's location |
@TargetPredictedLocation | @targetPredictedLoc / @TPL / @PredictedTargetLocation | Targets the predicted location at which the caster's top target will be after an amount of ticks has elapsed, based on its current movement speed |
@TriggerLocation | — | Targets the location of the entity that triggered the skill |
@SpawnLocation | — | Targets the world's spawn location. |
@CasterSpawnLocation | — | Targets the location the caster spawned at. |
@Location | — | Targets the specified coordinates in the caster's world. |
@Origin | @source | Targets the location of the "origin" or "source" of a meta-skill. While that is usually the casting mob, there are special cases where this is not true (such as with the Projectile Skill, where the "origin" is the location of the projectile). |
@ObstructingBlock | — | Tries to target the block in front of the caster that is obstructing it |
@TargetBlock | — | Targets the block the casting player is looking at. |
@TrackedLocation | — | Targets the mob's tracked location |
@NearestStructure | — | Targets the nearest structure of the specified type within a radius in the caster's world |
@VariableLocation | @varLocation | Targets the location stored in the specified variable |
@HighestBlock | — | Targets the highest block at the skill origin |
@PlayerLocationByName | — | Targets a specific player's location by their name |
@EscapeLocation | — | Targets a nearby safe escape location like how an Enderman would choose its teleport destination |
@ForwardWall | — | Targets a plane in front of the caster |
@PlayerLocationsInRadius | @PLIR | Targets all player locations in the given radius |
@Pin | — | Targets the location(s) of a pin. |
@Ring | — | Target points to form a ring of locations |
@RandomRingPoint | — | Targets random points in a ring around the caster |
@Cone | — | Returns the # of points target locations that comprise a cone (Note: Cone is fixed on the y-axis, and cannot be rotated up or down) |
@Sphere | — | Targets points in a sphere around the caster |
@Rectangle | @cube / @cuboid | Returns the # of points target locations that comprise a rectangle |
@RandomLocationsNearCaster | @randomLocations / @RLNC | Targets random locations near the caster. |
@RandomLocationsNearOrigin | @RLO / @randomLocationsOrigin / @RLNO | Targets random locations near the origin of a skill. |
@BlocksNearOrigin | @BNO | Targets all blocks in a radius around the origin of the metaskill. |
@RingAroundOrigin | @ringOrigin / @RAO | Targets locations in a specified ring around the origin. |
@Spawners | — | Targets the location of the specified spawners. |
@BlocksInPinRegion | — | Targets the blocks in a region delimited by two pins |
@ChunksInWERegion | @chunksInWGRegion | Targets the 0,0 chunk corners of the chunks in a specified WorldGuard region |
@LivingInLine | @entitiesInLine / @livingEntitiesInLine / @LEIL / @EIL | Targets any entities in a line between the inherited target and the casting mob. |
@LivingNearTargetLocation | @LNTL / @ENTL / @ENT | Targets all living entities near the inherited target. |
@PlayersNearTargetLocations | @playersNearTargetLocation / @PNTL | Targets all players near the inherited targets. |
@TargetedTarget | @Targeted | Targets the inherited targeted entities. |
@Line | — | Targets locations between the mob and the inherited targets. |
@RandomLocationsNearTargets | @randomLocationsNearTarget / @randomLocationsNearTargetEntities / @randomLocationsNearTargetLocations / @RLNT / @RLNTE / @RLNTL | Targets random locations around the inherited targets. |
@FloorOfTargets | @FOT / @floorsOfTarget | Targets the blocks underneath the inherited targets. |
@LocationsOfTargets | @locationOfTarget / @LOT | Targets the location of the inherited target entities. |
@TargetedLocation | @targetedLocations / @targetedLoc | Targets the location of the inherited target locations. |
@BlocksInRadius | @BIR | Targets all blocks in a radius of the inherited targets. |
@BlocksInChunk | @BIC | Targets all blocks in a chunk relative to the inherited target. |
@BlockVein | @vein / @bv | Target all adjancent blocks that match the blocktype, starting from the origin of the skill. |
@None | — | Provides no target. (Useful for mechanics with no target input.) |
@Region | — | Special targeter to target a region. Only works with specific mechanics |
Match the targeter's kind to the mechanic's. A location mechanic given an entity targeter (or the reverse) is the single most common reason a skill silently does nothing. /mm mobs info and a raised /mm debug level will show what a skill actually resolved to.
Trigger index
Triggers are only valid inside a mob's own Skills list β a metaskill's internal lines inherit the trigger of the line that called them. Use @trigger to target whatever caused the trigger to fire. 36 documented:
| Trigger | Fires when |
|---|---|
onCombat | Default |
onAttack | When the mob hits something |
onDamaged | When the mob is damaged |
onSpawn | When the mob spawns |
onDespawn | When the mob is despawned |
onReady | Triggered the first time a mob is spawned from a spawner |
onLoad | When the mob is loaded after a server restart |
onSpawnOrLoad | When the mob either spawns or loads |
onDeath | When the mob dies |
onTimer | Every \# ticks (where \# is the interval in ticks) |
onInteract | When the mob is right-clicked |
onPlayerKill | When the mob kills a player |
onEnterCombat | When the mob enters combat (requires threat tables be on) |
onDropCombat | When the mob leaves combat (requires threat tables be on) |
onChangeTarget | When the mob changes targets (requires threat tables be on) |
onExplode | When the mob explodes (typically only used for creepers) |
onPrime | When the creeper charges up for an explosion |
onCreeperCharge | When the creeper is charged (when lightning hits a creeper) |
onTeleport | When the mob teleports (typically only used for endermen) |
onSignal | When the mob receives a signal |
onShoot | When the mob fires a projectile |
onBowHit | When the mob's fired projectile hits an entity |
onTame | When the mob gets tamed |
onBreed | When the mob breeds with another mob. |
onTrade | When the Villager completes a trade. Requires Paper |
onChangeWorld | When the mob changes world |
onBucket | When the cow is milked or an entity is bucketed (axolotl etc.) |
onSkillDamage | When the mob deals damage to other entities via a mechanic |
onHear | When the mob hears a sound, if enabled |
onProjectileHit | When a mob's special projectile hits an entity |
onProjectileLand | When a mob's special projectile hits a block |
onDismounted | When the mob is dismounted from |
onCinematicStart | When a cinematic camera path begins playing on a player |
onCinematicEnd | When a cinematic camera path ends on a player (finish, cancel, quit, or death) |
onEnterBounds | When the mob moves into a defined region |
onExitBounds | When the mob moves out of a defined region |
Condition index
Conditions gate execution. The Type column says what a condition inspects β Entity, Location, Meta or Compare β which determines where it is legal to use. 194 documented:
Conditions appear in four places, each with its own semantics:
| Block | Checked against |
|---|---|
Conditions | The caster. |
TargetConditions | Each target β non-matching targets are filtered out. |
TriggerConditions | The entity that triggered the skill. |
EquipConditions | (Crucible items) the wearer, before stats and skills apply. |
Each condition line may carry an action that changes what a match does, rather than just pass/fail:
| Action | Effect on a match |
|---|---|
true | The skill runs if the condition is met. (Default.) |
false | The skill runs only if the condition is not met. |
cast <skill> | Casts a metaskill when matched. |
castinstead <skill> | Casts a metaskill in place of the original. |
power <multiplier> | Multiplies the skill's power (e.g. 2.0 doubles it). |
orElseCast <skill> | Casts a fallback skill when not matched. |
| Condition | Type | Description |
|---|---|---|
Altitude | Entity | Tests how far above the ground the target entity is |
Biome | Location | Tests if the target is within the given list of biomes |
BiomeType | Location | Tests for the biome category at a location. |
BlockType | Location | Tests the material type present at the target location |
BlockTypeInRadius | Location | Checks against the amount of specified blocks in a radius around the target location |
Blocking | Entity | Tests if the targeted player is blocking with a shield |
BoundingBoxesOverlap | Compare | Checks if the caster's BoundingBox overlaps with the target's |
BowTension | Meta | Checks the bow tension of when an entity shoots from a bow |
Burning | Entity | Whether or not the target entity is on fire |
Chance | Meta | The chance that the metaskill has to be executed |
Charged | Entity | Checks if the target creeper is charged |
Children | Entity | Tests how many children the caster has |
Color | Entity | Tests the entity's colors |
CompareValues | Meta | Compares two values based on a specified operation |
Crouching | Entity | Whether or not the target entity is crouching |
Cuboid | Compare | Whether the target is within the given cuboid between location1 x location2 |
DamageAmount | Meta | Checks for a range of damage taken |
DamageCause | Meta | Checks the type of the damage cause |
DamageTag | Meta | Checks the tags of the damage cause |
Dawn | Location | If the time is dawn, from 22000 to 2000 in-game time |
Day | Location | If the time is day, from 2000 to 10000 in-game time |
Dimension | Location | If the target location is within a certain dimension |
DirectionalVelocity | Entity | If the target has a velocity matching the given parameters |
Distance | Compare | Whether the distance between the caster and target is within the given range |
DistanceFromLocation | Entity | Whether the distance between the target and a specified location is within a certain range |
DistanceFromPin | Location | Checks if the target is within a certain distance of a specified pin |
DistanceFromSpawn | Location | Whether the distance from the world's spawn point to the target is within the given range |
DistanceFromTrackedLocation | Location | Whether the distance from the tracked location to the caster is within the given range |
Dusk | Location | If the time is dusk, from 14000 to 18000 in-game time. |
EnchantingExperience | Entity | Checks the target player's experience points |
EnchantingLevel | Entity | Checks the target player's experience level |
EnderDragonAlive | Location | Checks if there is at least one EnderDragon alive in the world of the targeted location |
EnderDragonPhase | Entity | Checks if the ender dragon is in a phase or phases |
EntityItemIsSimilar | Entity | Tests if the target item entity is similar to another item |
EntityItemType | Entity | Tests the type of the target item entity |
EntityMaterialType | Entity | Tests the material of the target item entity |
EntityType | Entity | Tests the entity type of the target |
Faction | Entity | Tests for the targets faction |
FallSpeed | Entity | If the fall speed of the target is within the given range |
FieldOfView | Compare | Tests if the target is within the given angle from where the caster is looking |
FoodLevel | Entity | Checks if the target has food within the range |
FoodSaturation | Entity | Checks if the target has food within the range |
Gamemode | Entity | Checks if the target player's gamemode is the specified one |
Gliding | Entity | If the target is gliding |
GlobalScore | Entity | Checks a global scoreboard value |
HasAI | Entity | Checks if the target entity has its AI enabled |
HasAura | Entity | Checks if the target entity has the given aura |
HasAuraStacks | Entity | Tests if the target has the given range of stacks from an aura |
HasAuraType | Entity | Checks if the target entity has the given aura type |
HasCurrency | Entity | If the target has the given amount of vault currency |
HasDialogOpen | Entity | Checks if the target player has a dialog open |
HasEnchantment | Entity | Checks if the target entity's equipped item has an enchantment |
HasFreeInventorySlot | Entity | Checks if the evaluated entity has a free inventory slot |
HasGravity | Entity | Tests if the target mob has gravity |
HasItem | Entity | Tests if the target player has the given number of given material |
HasOffhand | Entity | Checks if the target entity has something in the offhand |
HasOwner | Entity | Tests if the target mob has an owner |
HasParent | Entity | Tests if the target mob has a parent |
HasPassenger | Entity | Checks if the target entity has a passenger |
HasPermission | Entity | Tests if the target player has a permission |
HasPotionEffect | Entity | Tests if the target entity has a potion effect |
HasTag | Entity | Tests if the target has a scoreboard tag |
Health | Entity | Matches the target's health |
HealthPercent | Entity | Matches the target's health percentage or multiplier |
Height | Location | Checks if the target's Y location is within a range |
HeightAbove | Location | Checks if the target's Y location is above a value |
HeightBelow | Location | Checks if the target's Y location is below a given value |
Holding | Entity | Checks if the target is holding a given material(support MythicMobs and MMOItems) |
inBounds | Compare | Tests whether the target is inside an axis-aligned bounds box between two corners |
inClaim | Location | Checks if the target location is inside a claim |
InCombat | Entity | Checks if the target mob is considered in combat |
InPinRegion | Location | Checks if the target location is within a region delimited by two pins |
IsInvulnerable | Entity | Checks whether the target entity is invulnerable |
IsInSurvivalMode | Entity | Checks if the target player is in survival mode |
Inside | Location | Checks if the target has a block over their head |
isBaby | Entity | Checks if the target entity is a baby |
isCancelled | Meta | Checks if the triggering event is cancelled |
isCaster | Entity | Checks if the target is the caster |
isChild | Entity | Checks if the target is a child of the caster |
isClimbing | Entity | Checks if the target entity is climbing |
IsCreeperPrimed | Entity | Checks if the target creeper is primed to explode |
isFlying | Entity | Checks if the target player is flying |
isFrozen | Entity | Checks if the target entity is frozen |
isInCinematic | Entity | Checks if the target player is in an active cinematic |
isLeashed | Entity | Checks if the target has been leashed |
isLiving | Entity | Checks if the target is a living entity |
isMonster | Entity | Checks if the target is a monster |
isMythicMob | Entity | Checks if the target is a MythicMob |
IsParentAlive | Entity | Checks if the parent of the target entity is still alive |
IsParent | Compare | Checks if the target entity is the parent of the caster |
isPlayer | Entity | Checks if the target is a player |
isRaiderPatrolLeader | Entity | Checks if the target entity is the captain of a pillager group |
isSaddled | Entity | Checks if the target entity is saddled |
IsSibling | Compare | Whether the target entity is a sibling of the caster |
isSkill | Meta | Checks whether the specified metaskill exists |
isTamed | Entity | Checks if the target entity is tamed |
IsUsingSpyglass | Entity | Checks if the target player is using a spyglass |
ItemGroupOnCooldown | Entity | Checks whether the target player has the specified item group on cooldown |
ItemIsSimilar | Entity | Checks that targeted player's inventory slot if it's similar to an item |
ItemRecharging | Entity | Checks if the target's weapon is recharging |
ItemType | Meta | Checks against the material of the item that triggered the skill |
LastDamageCause | Entity | Checks the target's last damage cause |
LastSignal | Entity | Matches the last signal received by the target mob |
Level | Entity | Checks the target MythicMob's level |
LightLevel | Location | Tests the light level at the target location |
LightLevelFromBlocks | Location | Tests the light level originating from light-emitting blocks at the target location |
SkyLightLevel | Location | Tests the sky light level at the target location |
LineOfSight | Compare | Tests if the target is within line of sight of the caster |
LineOfSightFromOrigin | Compare | Tests if the target is within line of sight of the caster |
LivingInRadius | Location | Matches a range to how many living entities are in the given radius |
LocalDifficulty | Location | Tests the difficulty scale at the target location |
LookingAt | Entity | Checks if the player is looking at something |
LunarPhase | Location | Checks the target world's lunar phase |
MaterialisOnCooldown | Entity | Checks if the target player's specified material is on cooldown |
MetaskillCondition | Meta | Casts a Metaskill that will determine if the condition should check or not |
MobsInChunk | Location | Matches a range to how many mobs are in the target location's chunk |
MobsInRadius | Location | Checks how many mobs are in a given radius |
MobsInWorld | Location | Matches a range to how many mobs are in the target world |
MobsNearOrigin | Meta | Matches a range to how many mobs are in the given radius around the origin |
MobSize | Entity | Checks the size of an entity that can have its size changed |
Moist | Location | Checks if the target block of farmland is hydrated |
MoistureLevel | Location | Checks if the target block of farmland has the specified level of hydratation |
MotionX | Entity | Checks the X motion of the target entity against a range. |
MotionY | Entity | Checks the Y motion of the target entity against a range. |
MotionZ | Entity | Checks the Z motion of the target entity against a range. |
Mounted | Entity | If the target entity is riding a mount/vehicle |
Moving | Entity | If the target has a velocity greater than zero |
MythicMobType | Entity | Checks the MythicMob type of the target mob |
MythicPack | Meta | Checks for the presence of Pack |
MythicPackVersion | Meta | Checks if a pack has a specified version |
MythicPackVersionGreater | Meta | Checks if a pack has a version greater or equal the specified one |
NearClaim | Location | If the target location is near any GriefPrevention claims |
Night | Location | If the time is night, from 14000 to 22000 in-game time |
NotInRegion | Location | If the target location is not within the given WorldGuard region |
OffGCD | Entity | Checks if the target mob has an active Global Cooldown |
OnBlock | Location | Matches the block the target entity is standing on |
OnGround | Entity | If the target entity is standing on solid ground |
OriginDistanceFromPin | Location | Checks if the origin is within a certain distance of a specified pin |
OriginLocation | Meta | Checks if the origin is at a given location |
Outside | Location | If the target has open sky above them |
Owner | Compare | Checks if the target entity is the owner of the caster |
OwnerIsOnline | Entity | Checks if the owner of the target mob is online, if the owner is a player |
Pitch | Entity | Checks if the pitch of the target entity is within a range |
PlayerKills | Entity | Matches how many players the target mob has killed |
PlayerNotWithin | Location | Checks if any players are within a radius of the target |
PlayerWithin | Location | Checks if any players are within a radius of the target |
PlayersInRadius | Entity | Checks how many players are in a radius |
PlayersInWorld | Meta | Matches the number of players in the caster's world |
PlayersOnline | Meta | Matches the number of players online |
Plugin | Meta | Checks if the specified plugin is running on the server |
Premium | Meta | Checks if MythicMobs Premium is running on the server |
ProjectileHasEnded | Meta | Checks if the calling projectile has ended |
Raining | Location | If it's raining in the target world |
Region | Location | If the target is within the given WorldGuard region |
SameFaction | Entity | Tests if the caster and target are in the same faction |
Score | Entity | Checks a scoreboard value of the target entity |
ServerIsPaper | Meta | Checks whether the server is running a fork of paper. |
ServerNmsVersion | Meta | Checks if the server is running the specified minecraft NMS version. |
ServerVersion | Meta | Checks if the server is running the specified minecraft version. |
ServerVersionAfterOrEqual | Meta | Checks whether the server is after or equal to a specific version |
ServerVersionBefore | Meta | Checks whether the server is before a specific version |
Size | Entity | Checks the size of the target entity |
SkillOnCooldown | Entity | Checks if the given skill is in cooldown for the target |
SpawnReason | Entity | Checks against the spawn reason of the target |
Sprinting | Entity | Checks if the target Player is sprinting |
Stance | Entity | Checks the stance of the target mob |
StatDamageModifier | Meta | Used in stat triggers to check the increased damage (as a multiplier). |
StringEmpty | Meta | Checks if the provided string is empty |
StringNotEmpty | Meta | Checks if the provided string is not empty |
StringEquals | Meta | Checks if value1 equals value2. Both values can use variables and placeholders. |
Structure | Location | Matches if the target location is inside of a structure |
Sunny | Location | If the weather is sunny in the target world. |
TargetInLineOfSight | Entity | Tests if the target has line of sight to their target |
TargetNotInLineOfSight | Entity | Tests if the target doesn't have line of sight to their target |
TargetWithin | Entity | Tests if the target's target is within a certain distance |
TargetNotWithin | Entity | Tests if the target's target is not within a certain distance |
Targets | Meta | Tests if the number of inherited targets from the parent skilltree matches the given range. |
TemplateType | Entity | Checks if the target mob extends the specified Template |
Thundering | Location | If it's thundering in the target world |
TriggerBlockType | Meta | Checks against the material type that triggered the skill |
TriggerItemType | Meta | Checks against the item material type that triggered the skill |
VariableContains | Meta | Checks if the given variable contains a certain value |
VariableEquals | Meta | Checks if the given variable has a particular value. |
VariableInRange | Meta | Checks if the given numeric variable is within a certain range. |
VariableIsSet | Meta | Checks if the given variable is set. |
VehicleIsDead | Entity | Checks if the casters mounted vehicle is dead. |
Velocity | Entity | Checks the velocity of the target entity against a range. |
Wearing | Entity | Tests what the target entity has equipped. |
World | Location | Checks the name of the target world. |
WorldTime | Location | Matches a range against the target location's world's time. |
Yaw | Entity | Checks the yaw of the target entity against a range. |
xDiff | Entity | Checks the difference in X between the targeted entity and the caster. |
yDiff | Entity | Checks the difference in Y between the targeted entity and the caster. |
zDiff | Entity | Checks the difference in Z between the targeted entity and the caster. |
Drops & drop tables
The simplest form is an inline list of <drop> <amount> <chance>:
plugins/MythicMobs/Mobs/example.yml
internal_mobname:
Type: ZOMBIE
Drops:
- GoldCoin 1-3 0.5
- diamond 1 0.05
- exp 50 1
- Drop β a Mythic item, a vanilla item,
exp, a drop table, or an item from a supported plugin. - Amount β a number or a range (
1-3/1to3). Note the upper bound is exclusive:1to3yields 1 or 2, never 3. - Chance β 0 to 1, or a percentage such as
10%.
A chance may be a math expression, placeholder or variable that resolves to a number, evaluated per loot roll β so drop rates can scale with mob level or a variable. Resolving to ≥1 always drops, ≤0 never does. Requires Premium (math/variables in numeric values). Works with FancyDrops.
Spawners
Spawners are fixed points with timers, cooldowns, warmups and conditions. They work independently of vanilla natural spawning.
plugins/MythicMobs/Spawners/example.yml
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
Warmup: 0
Once a spawner file has been loaded by a running server, editing it in a text editor will not stick β the server rewrites it from memory. Either edit spawners with in-game commands, or stop the server first. Spawner commands accept g:group_name to act on a whole group and r:radius to act on everything within a radius.
- 5.13.0 Spawners gained
Chance,RandomRotationandUseWorldScaling. - 5.13.0 Most spawner fields β
Cooldown,Warmup,MobsPerSpawn,MobLevel,Radius,RadiusY,ActivationRange,ScalingRange,LeashRangeβ now accept placeholders and ranged values, where previously they took flat numbers only.
5.13.0+ ranged and random spawner options
Chance: 0.5
RandomRotation: true
Cooldown: 5to10
MobsPerSpawn: 1to3
Math, variables & placeholders
Placeholders resolve values at runtime β <caster.hp>, <target.name>, <skill.var.damage> and so on. Variables are named values scoped to a caster, skill, world or the server, set with the setvariable mechanic.
Using placeholders and math inside numeric fields β mob attributes, item attributes, most skill arguments and drop-table amounts β is a Premium capability. On the free build those fields accept literal numbers only. This is the single biggest practical difference between the two tiers, because most advanced configs found online assume it.
Version history
MythicMobs keeps per-minor changelog files from pre-2.0 through 5.9.x, with 5.10 onward in a single master changelog. Highlights of the current line:
| Version | Notable changes |
|---|---|
| 5.13.0 | Cinematics system β keyframed camera paths under cutscenes/, played with cinematicCamera (aliases cinecam, camerapath), with looping, per-leg easing, a packet-only DISPLAY camera or TELEPORT fallback, and onStart/onEnd skills. Adds cinematicCancel, the isInCinematic condition, cinematic.* placeholders, /mm camera, and cancellable start/end API events.New clearpath mechanic (clears navigation). mount/summonPassenger gain mode = ADD/SET/REPLACE. packinfo.yml gains PackDependencies/FileDependencies. Spawner Chance/RandomRotation/UseWorldScaling plus placeholders in spawner fields. Placeholders accepted in numeric attributes across 40+ mechanics. Menu icons gain Hide, HideFlags, Glint, Enchantments. CRITICAL_STRIKE_DAMAGE reverted to a compounding multiplier; a lost-update race in stat recompute fixed. |
| 5.12.1 | Maintenance release on the 5.12 line. |
| 5.12.0 | Large feature release (the master changelog's second-biggest section). |
| 5.11.0 | Feature release. |
| 5.10.0 | First entry in the current master changelog. |
| ≤ 5.9.x | Documented in per-minor files under changelogs/. The 5.9 line was heavily 1.21.5-compatibility focused (projectile, equipment, display-packet and drop-weight fixes). |
The upstream changelog summarises 5.10β5.12 far less granularly than 5.13. Rather than reconstruct those release notes second-hand, this page reports only what the changelog states; consult the changelog directly for the full 5.12.0 entry.
Gotchas
- Entity-type support lags Minecraft. Mob options for newly added vanilla entity types do not function until Mythic explicitly adds support, and some types have quirks documented on the wiki's unstable-entity-types page.
- Triggers do not work inside metaskills. A
~onXon a line inside a metaskill is meaningless; put the trigger on the mob's skill line that calls the metaskill. - Health caps. Spigot caps max health at 2048 regardless of what you write in
Health; Minecraft caps armor at 30. - Range upper bounds are exclusive in drop amounts β
1to3never yields 3. - Addon mechanic collisions. If two addons register the same name, disambiguate with a namespace prefix such as
meg:β see interoperation. - Equipment and attribute modifiers stack into base stats. Items with attribute modifiers change the mob's effective health, damage and armor beyond what the mob file declares.
Sources
- MythicMobs Wiki β Home
- MythicMobs Wiki β Mobs
- MythicMobs Wiki β Skills
- MythicMobs Wiki β Mechanics
- MythicMobs Wiki β Targeters
- MythicMobs Wiki β Triggers
- MythicMobs Wiki β Conditions
- MythicMobs Wiki β Drops
- MythicMobs Wiki β Spawners
- MythicMobs Wiki β Commands and Permissions
- MythicMobs Wiki β Premium Features
- MythicMobs Wiki β Changelogs