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.

πŸ“Œ Scope note

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 <>.

CommandDoes
/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 / listactiveLoaded definitions / currently spawned mobs.
/mm mobs kill [mob] / killallRemoves 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.0Authors cinematic camera paths in-game.
/mm saveForce-saves active mobs and spawners.

Several commands take flags before their first argument:

FlagEffectExample
-sSilent β€” no chat feedback./mm test cast -s [metaskill]
-p <player>Execute at the given player./mm m s -p <player> [mob]
-tExecute at your target location./mm m s -t [mob]
-nFake 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]
-dDrop 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:

OptionPurpose
TypeBase entity type. Required. New vanilla entity types only work once Mythic adds support.
DisplayDisplay name; supports colour codes and placeholders. Does not auto-update β€” use the setname mechanic to change it later.
HealthBase max health. Spigot caps this at 2048 by default (raise it in spigot.yml).
DamageBase melee damage. 1 damage = half a heart. Never affects ranged/projectile damage.
ArmorBase armor attribute. Minecraft caps armor at 30.
HealthBarHologram health bar above the mob (Enabled, Offset).
BossBarWither/dragon-style bar (Enabled, Title, Range, Color, Style, CreateFog, DarkenSky, PlayMusic).
FactionFaction name, used by custom AI and targeter filtering.
MountAnother Mythic mob to spawn and ride.
OptionsLarge per-entity option block (movement speed, despawn, collidability, …).
Display OptionsOptions specific to display entities.
ModulesOpt-in behaviour modules such as threat and immunity tables.
AIGoalSelectors / AITargetSelectorsReplace the vanilla AI goal/target lists outright.
AIPathfindingMalusPer-block pathfinding cost overrides.
DropsInline drop list (see Drops).
DamageModifiersPer-damage-type multipliers β€” immunity, healing from a type, resistances.
EquipmentItems placed in equipment slots on spawn.
KillMessagesCustom death messages.
Level / LevelModifiersBase level and per-level stat scaling.
DisguiseLibsDisguises integration.
SkillsThe skill list (see below).
NameplateNameplate rendering options.
HearingLets the mob react to sounds.
TotemTotem behaviour.
VariablesPer-mob variables set at spawn.
TradesVillager trade definitions.
⚠ Gotcha

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
PartIn the exampleMeaning
MechanicigniteWhat happens. The base action. Required.
Arguments{ticks=100}In braces, separated by ;. Most have defaults.
Targeter@targetWhat it is aimed at. Always prefixed @; may take its own {} options.
Trigger~onAttackWhen 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.
Chance0.5Probability 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
πŸ“Œ Premium

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:

MechanicDescription
ActivateSpawnerActivates a MythicMobs spawner at the targeted location
AddTradeChanges the trades of a villager
AnimateArmorStandAnimates an armorstand
ArmAnimationMakes the caster swing their arm
ArrowVolleyFires a volley of arrows
AttributeModifierAdds an attribute modifier to the attributable target
AuraRemoveRemoves an aura from the target entity
BarCreateCreates a custom boss bar on the casting mob
BarRemoveRemoves a custom boss bar on the casting mob
BarSetModifies a custom boss bar on the casting mob
BlackScreenBlacks out the target's screen for the duration
BlockDestabilizeCauses the targeted blocks to fall, as if affected by gravity
BlockMaskTemporarily masks a block as a different block
BlockUnmaskUnmasks blocks that have been masked
BlockPhysicsTriggers a block physics update at the target location
BlockWaveCreates a wave of blocks at the target location
BloodyScreenMakes the target's screen glow red
BoneMealApplies a bone meal effect to the target blocks
BossBorderCreates an inescapable border around the mob
BouncyApplies an aura to the target that makes it bouncy
BreakBlockBreaks the block at the target location
BreakBlockAndGiveItemBreaks the block at the target location and gives an item/droptable
ClearExperienceClears the experience for the targeted players
ClearExperienceLevelsClears the experience levels for the targeted players
ClearTargetForces the target of the mechanic to reset its current target
GiveExperienceLevelsGives experience levels to the targeted players
TakeExperienceLevelsTakes experience levels to the targeted players
CloseInventoryCloses the target player's inventory
CommandExecutes a command for each target
ConsumeDeals damage and restores health per target hit
ConsumeSlotRemove an item from a specific slot of the player's inventory
DirectionalVelocityChanges the velocity on the target entity on a specific vector
DisengageCauses the caster to leap backwards away from the target entity
DisguiseChanges the caster's disguise
DisguiseModifyModifies the caster's already applied disguise
DisguiseTargetChanges the target's disguise
UndisguiseRemove the caster's disguise
DismountMakes the caster dismount whatever they're riding
DisplayTransformationSets the targeted display entity's transformations
ClearThreatMakes a mob clear its threat table
CurrencyGiveGive money to a player. Requires Vault and a currency plugin
CurrencyTakeTake money from a player. Requires Vault and a currency plugin
DamageDamages the target for an amount
BaseDamageDamages the target for a percent of the mob's damage stat
PercentDamageDamages the target for a percent of their health
DecapitateDrops a player head item based on target
DopplegangerCopies the appearance of the target player
DropItemDrops an item or droptable at the target location
EjectPassengerEjects anything riding the caster
EnderCauses the "Ender" effect
EnderBeamCreates a EnderCrystal's beam effect to the target
EnderDragonResetCrystalsGenerates the EnderDragon crystals
EnderDragonSetPhaseSets the EnderDragon phase
EnderDragonSetRespawnPhaseSets the EnderDragon respawn phase
EnderDragonSpawnPortalGenerates the portal of the EnderDragon battle
EquipCauses the casting mob to equip an item
EquipCopyCauses the caster to equip a copy of the target's equipment
ExplosionCauses an explosion
FakeExplosionCauses a fake explosion
ExtinguishRemoves fire ticks from the target entity
FawePastePastes a Schematic using FAWE (Fast Async World Edit)
FeedFeeds the target player
FearApplies an aura that makes the target run around in fear
FillChestFills a chest with items, or a droptable
FireworkCreates a firework effect at the target
FlamesCreates the flames effect at the location of the targeter
FlyApplies an aura that allows the targeted player to fly
ForcePullTeleports the target to the caster
FreezeFreezes the target for the given number of ticks using the Powdered Snow freezing effect
GeyserCreates a "geyser" of water or lava
GiveItemGives an item to the target
GiveItemFromSlotGives an item to the target from the item in the given slot of caster
GiveItemFromTargetGives the caster an item while playing the pickup-item animation from the target entity or location
GlowMakes the target glow
GoatRamCauses the casting goat mob to ram the targeted entity
GoToMove toward the location of the targeter (entity or location)
GuardianBeamDraws a guardian beam between the origin and the target
HealHeals the target
HealPercentHeals the target for a percentage of its max-health
HideHides the caster from the targeted player(s) for a set duration.
HitSimulates a physical hit from the mob.
HologramSummons a hologram to the targeted location
IgniteSets the target on fire
ItemSprayCauses an explosion of temporary items at the target location
JSONMessageSends a JSON-format message to the target player(s)
JumpCauses the caster to jump
LeapCauses the caster to leap towards the target
LightningStrikes lightning at the target
FakeLightningStrikes a fake lightning at the target
LogLogs a message to console.
LookCauses the caster to look at the target
LungeCauses the caster to lunge forward at the target
MatchRotationSets the caster's yaw and pitch to the same value of the target's
MessageSends a message to the target player(s)
ModifyDamageModifies the damage event that triggered the skill
ModifyGlobalScoreModifies a scoreboard value of the fake player: \_\_GLOBAL\_\_
ModifyTargetScoreModifies a scoreboard value of the target
ModifyMobScoreModifies a scoreboard value of the casting mob
ModifyScoreModifies the score of a dummy player
MountSummons a mob for the caster and mounts it
MountMeForces the targeted entity to mount the caster
MountTargetMounts the target
MovePinMoves the given pin to the target location
OpenCustomMenuOpens a custom menu
OpenTradesOpens the trades of the casting villager to the target player
OxygenGives oxygen to a player target
ParticleCreates particle effects around the target
ParticleBoxDraws a box of particles around the target
ParticleEquationGenerates particles based on equations
ParticleLineDraws a line of particle effects to the target
ParticleLineHelixDraws a line based helix effect
ParticleLineRingDraws a particle ring connected by lines
ParticleOrbitalDraws orbiting particle effects around the target
ParticleRingDraws a ring of particles around the target
ParticleSphereDraws a sphere of particles around the target
ParticleTornadoDraws a persistent "tornado" of particles at the target
AtomCreates some particles in the shape of an atom
PickUpItemPick up the targeted item
PlayAnimationForces the entity to play an animation
PlayBlockBreakSoundPlays a block breaking sound
PlayBlockFallSoundPlays a block falling sound
PlayBlockHitSoundPlays a block hit sound
PlayBlockPlaceSoundPlays a block place sound
PlayBlockStepSoundPlays a block step sound
PoseArmorStandChanges the pose of the target ArmorStand
PotionApplies a potion effect to the target
PotionClearRemoves all potion effects from target entity
PrisonImprisons the target inside a block
PrintParentTreePrints debug information regarding the Metaskill executing the mechanic and its SkillTree
PropelPropels the caster towards the target
PullPulls the target towards the mob
PushBlockPushes the block at the target location in the given direction
PushButtonPushes a button at the target location
RayTraceTraces a straight line to the target
RayTraceToExecutes a skill with the result of a raytrace to the target location
RallyCauses other nearby mobs to attack the target
RandomMessageSends a random message to the target player
RecoilKicks the target's screen in order to simulate a recoil
RemountRemounts the mob the caster originally spawned riding, if it is still alive
RemoveRemoves the target mob
RemoveHeldItemRemoves some of the item the target player is holding
RemoveOwnerRemoves the ownership of the target mob
ResetAIAttempts to resets the AI of a casting mob to the base type's default
RotateTowardsRotates the caster towards the target location
RunAIGoalSelectorChange the caster's AIGoalSelectors
RunAITargetSelectorChange the caster's AITargetSelectors
SaddleEquips or remove a saddle on the target entity
SendActionMessageSends an Actionbar Message to the target player
SendResourcePackSends a Resource Pack to the target player
SendTitleSends a Title/Subtitle Message to the target player
SendToastSends an achievement toast to the target player
SetAIDisables/enables the AI of the target mob
SetBlockOpenSets the target block's open state
SetBlockTypeChange block type at target location
SetChunkForceLoadedSets the force-loaded status of a location's chunk
SetCollidableSets if the target should have a collidable hitbox or not
SetCustomMenuButtonSets a specific slot of the opened custom menu to the specified button
SetDragonPodiumSets the position of the dragon's podium at the target location
SetGameModeSets the Game Mode of the target player
SetGlidingMakes the target glide if they have elytra
SetGlobalScoreSets a scoreboard value on the fake player: \_\_GLOBAL\_\_
SetGravitySets whether gravity affects the target entity
SetHealthSets the health of the target entity
SetInteractionSizeSets the size of the target INTERACTION entity.
SetItemGroupCooldownSets the cooldown on an item group for the target player
setDisplayEntityItemSets the item component of ITEM_DISPLAY entities.
SetLeashHolderChanges the holder of a mobs lead
SetLevelChanges the casting mob's level
SetMaterialCooldownSets a cooldown for usable materials like ender pearls, chorus fruit, etc
SetMaxHealthSets the max health of the target entity
SetMobColorChanges the color of the target if it is a colorable mob
SetMobScoreSets a scoreboard value on the casting mob
SetNameChanges the caster entity's name
setRaiderCanJoinRaidSets if the target raider entity can join a raid or not
SetRaiderPatrolBlockSets the target raider to patrol a location
SetRaiderPatrolLeaderSets the raider patrol leader
SetFactionChanges the target entity's faction
SetFlyingSets whether the target player is flying
SetNoDamageTicksSets the nodamageticks of the target
SetOwnerMakes the target the owner of the casting mob
SetParentMakes the target the parent of the casting mob
SetPathfindingMalusSets the pathfinding malus of a mob for given terrain types
SetPitchSets the head pitch of the target entity
SetPoseSets the entity's pose
SetRotationSets the rotation of the target
SetTargetSets the caster's target
SetTargetScoreSets the score of the target
SetTextDisplaySets the text component of target Text Display entity
SetTongueTargetSets the tongue target for a frog caster to the target entity
SetScoreSets the scoreboard value of a dummy player
SetSpeedSets the target entity's speed attribute
SetStanceSets the stance of the target mob
ShieldApplies an absorb shield to the target entity
ShieldBreakForces the player to lower their shield and puts it on cooldown
ShieldPercentApplies an absorb shield to the target entity for a percentage of their max health
ShootFireballShoots a fireball at the target
ShootPotionThrows a potion at the target
ShootSkullShoots a wither skull at the target
ShootShulkerBulletShoots a shulker bullet at the target entity
ShowEntityShows the hidden caster to the targeted players
SignalSends a signal to a mob
SkyboxAlters the target player's skybox
SmokeCreates a puff of smoke
SmokeSwirlCreates a persistent "swirl" of smoke
SoundPlays a sound effect from both vanilla Minecraft and resource packs
StealItemSteals an item from the target and puts it in the mob's hand
StopSoundStops a sound effect from playing
SpeakCauses the mob to speak in chat, with options for speech bubbles
SpinCauses the target to spin
SpringCreates a temporary spring of liquid at the target
StunApplies an aura that stuns the target entity
StopUsingItemStops the targeted entity from using an item
SuicideCauses the caster to die
SummonSummons other mobs at the target
SummonAreaEffectCloudSummons a cloud of particles at the target
SummonFallingBlockSummons a falling block
SummonPassengerSummons a mob to ride the target.
SwapSwaps locations with the target
SwingOffhandMakes the casting player swing their offhand
AddTagAdds a scoreboard tag to the target
RemoveTagRemoves a scoreboard tag from the target
TakeItemRemoves an item from the targeted player's inventory
TauntModifies the threat level that the caster holds with the target entities
TeleportTeleports to the target
TeleportYTeleports the caster vertically
TeleportInTeleports the target relative to the caster's yaw
TeleportToTeleports the target to a specified location
TimeChanges the time
ThreatModifies the mob's threat towards the target
ThrowThrows the target entity
ThunderLevelCreates a client-side, per-player rainless storm
ToggleLeverToggles a lever at the target location
TogglePistonToggles a piston at the target location
ToggleSittingToggles the sitting state for cats, dogs, foxes, and parrots.
TotemOfUndyingPlays the effect of a player resurrecting
TrackLocationSets the mob's tracked location to the targeted location
UndoPasteUndoes a previously made paste
VelocityModifies the velocity of the target entity(s)
WeatherModifies the weather in the target world
WolfSitForces a targeted wolf to sit.
WorldEditReplaceReplaces blocks in a region using WorldEdit
πŸ“Œ Addon mechanics

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:

MechanicDescription
SkillExecutes a meta-skill. The butter for your bread.
VariableSkillExecutes a meta-skill. Supports placeholders.
AuraApplies an aura to the targeted entity, allowing for skills to be run onStart/onTick/onEnd/Etc which all originate from the target.
BeamCreates a beam of a material between the caster and the target
CancelEventCancels the Event that triggered the current skill-tree. Only works for certain triggers.
CancelSkillCancels the execution of the Metaskill when triggered.
CastApplies an aura that "Casts" a meta-skill using various advanced options.
ChainChains a skill between multiple targets that are near each other.
ChainMissileA missile that chains between entities. Premium-Only mechanic!
DelayDelays execution of the current skill list by a set number of ticks.
DetermineConditionDetermines the outcome of a Metaskill that is used as a Condition via the MetaskillCondition condition
EndProjectileTerminates the projectile. Only usable in projectile mechanics.
ForEachExecutes a metaskill once for each target of the mechanic
ForEachValueExecutes a metaskill once for each entry or key-value pair in the specified value
ForEachPinExecutes a metaskill once for each pin of a multi-pin
GlobalCooldownSets the caster's Global Cooldown timer
MissileFires a homing projectile towards the target.
ModifyProjectileModifying the projectile / missile / orbital
OnAttackApplies an aura to the target that triggers skills when they attack
OnDamagedApplies an aura to the target that triggers skills when they take damage
OnShootApplies an aura to the target that triggers skills when they shoot a bow
OnBlockBreakApplies an aura to the target that triggers skills when they break a block
OnBlockPlaceApplies an aura to the target that triggers skills when they place a block
OnChatApplies an aura to the target that triggers skills when they chat
OnSwingApplies an aura to the target that triggers skills when they swing / left click
OnInteractApplies 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)
OnJumpApplies an aura to the target that triggers a skill when they jump (PAPER ONLY MECHANIC)
OnDeathApplies an aura to the target that triggers a skill when they die
OrbitalApplies an aura that causes a projectile to orbit around the target
FollowPathApplies an aura that causes the mob to follow a path
FormLineApplies an aura that causes the mob to follow a straight path
PolygonCreates a highly-customizable polygon-shaped pattern that can execute metaskills.
ProjectileFires a highly-customizable projectile towards the target
ProjectileVelocityModifies the velocity of the calling Projectile or Missile
RandomSkillExecutes a random skill from a list
SetSkillCooldownSets the given metakill's cooldown to the given value
SetProjectileDirectionSets the calling projectile's movement direction to the given target
SetProjectileBulletModelSets the model of the projectile. (DISPLAY bullets only)
ShootShoots a item-projectile at the target, similar to arrows/eggs/snowballs.
SlashCreates a highly-customizable slash pattern that can execute metaskills.
SudoSkillMakes the target execute a skill
SwitchActs as a switch/case
StatAuraApplies an aura to the target that applies a specific stat to them
TotemCreates a static "totem" at a location that can execute other skills
TerminableCreates an aura that cancels the execution of its onStart metaskill is some conditions are met
VolleyShoots a volley of projectile-items at the target with various options
VariableAddAdds an amount to a numeric variable
VariableMathPerforms math on a numeric variable
SetVariableSets the value of a variable
SetVariableLocationSets a variable to the target location
VariableUnsetUnsets the variable
VariableSubtractSubtracts an amount from a numeric variable
VariableMoveMoves an already created variable across names and/or registries
WaitPuts the metaskill on hold until a set of conditions is met
CinematicCameraPlays a cinematic camera path for the target player
CinematicCancelCancels an active cinematic for the target player
CloseDialogCloses any open dialog for the target player
OnKeyPressApplies an aura that triggers a skill when the player presses a key
OnKeyReleaseApplies 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:

TargeterShorthandDescription
@Self@Caster / @Boss / @MobTargets the caster of the mechanic
@Target@TTargets the caster's target
@NearestPlayerTargets the nearest player in radius
@WolfOwnerTargets the owner of the wolf
@OwnerTargets the owner of the mob
@Parent@summonerTargets the parent of the mob
@MountTargets the caster's original mount
@Father@dad / @daddyTargets the father of the casting mob.
@Mother@mom / @mommyTargets the mother of the casting mob.
@PassengerTargets the rider of the casting mob.
@PlayerByName@specificplayerTargets a specific player by name. Supports placeholders.
@UniqueIdentifier@UUIDTargets a specific entity by their UUID, supports placeholders
@VehicleTargets the caster's vehicle
@InteractionLastAttacker@lastAttackerTargets the last entity that attacked the casting INTERACTION entity
@InteractionLastInteract@lastInteractTargets the last entity that interacted with the casting INTERACTION entity
@OwnerLocationTargets the position of the owner of the mob
@ParentLocation@summonerlocationTargets the position of the parent of the mob
@LivingInCone@entitiesInCone / @livingEntitiesInCone / @LEIC / @EICTargets all living entities in cone with a specified angle, length and rotation relative to facing direction
@LivingInWorld@EIWTargets all living entities in the caster's world
@NotLivingNearOrigin@nonLivingNearOrigin / @NLNOTargets all non living entities in a radius near the origin
@PlayersInRadius@PIRTargets all players in the given radius
@MobsInRadius@MIRTargets all mythicmobs or vanilla overrides of the given type in a radius
@EntitiesInRadius@livingEntitiesInRadius / @livingInRadius / @allInRadius / @EIRTargets all entities in the given radius.
@EntitiesInRing@EIRRTargets all entities in the given ring.
@EntitiesInRingNearOrigin@ERNOTargets all entities in the given ring around the origin.
@PlayersInWorld@WorldTargets all players in the current world.
@PlayersOnServer@Server / @EveryoneTargets all players in the server.
@PlayersInRingTarget all players between the specified min and max radius.
@PlayersNearOrigin@PNOTargets players near the origin of a meta-skill.
@TrackedPlayers@trackedTargets players that are within the render distance of the caster
@MobsNearOriginTargets all MythicMobs or vanilla overrides of the given type(s) in a radius around the origin
@EntitiesNearOrigin@ENOTargets all entities near the origin of a meta-skill
@Children@child / @summonsTargets any child entities summoned by the caster.
@Siblings@sibling / @brothers / @sistersTargets any mobs that share the same parent as the caster.
@ItemsNearOriginTargets item drops near the origin of a meta-skill.
@ItemsInRadius@IIRTargets all item drops in the given radius
@ThreatTable@TTTargets every entity on the casting mob's threat table
@ThreatTablePlayersTargets all the players on the casting mob's threat table
@RandomThreatTarget@RTTTargets a random entity on the casting mob's threat table
@RandomThreatTargetLocation@RTTLTargets the location of a random entity on the casting mob's threat table
@SelfLocation@casterLocation / @bossLocation / @mobLocationTargets the caster's location
@SelfEyeLocation@eyeDirection / @casterEyeLocation / @bossEyeLocation / @mobEyeLocationTargets the caster's eye location
@ForwardTargets a location in front of caster's facing direction
@ProjectileForwardTargets a location in front of the casting projectile, relative to its direction
@TargetLocation@targetloc / @TLTargets the caster's target's location
@TargetPredictedLocation@targetPredictedLoc / @TPL / @PredictedTargetLocationTargets 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
@TriggerLocationTargets the location of the entity that triggered the skill
@SpawnLocationTargets the world's spawn location.
@CasterSpawnLocationTargets the location the caster spawned at.
@LocationTargets the specified coordinates in the caster's world.
@Origin@sourceTargets 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).
@ObstructingBlockTries to target the block in front of the caster that is obstructing it
@TargetBlockTargets the block the casting player is looking at.
@TrackedLocationTargets the mob's tracked location
@NearestStructureTargets the nearest structure of the specified type within a radius in the caster's world
@VariableLocation@varLocationTargets the location stored in the specified variable
@HighestBlockTargets the highest block at the skill origin
@PlayerLocationByNameTargets a specific player's location by their name
@EscapeLocationTargets a nearby safe escape location like how an Enderman would choose its teleport destination
@ForwardWallTargets a plane in front of the caster
@PlayerLocationsInRadius@PLIRTargets all player locations in the given radius
@PinTargets the location(s) of a pin.
@RingTarget points to form a ring of locations
@RandomRingPointTargets random points in a ring around the caster
@ConeReturns the # of points target locations that comprise a cone (Note: Cone is fixed on the y-axis, and cannot be rotated up or down)
@SphereTargets points in a sphere around the caster
@Rectangle@cube / @cuboidReturns the # of points target locations that comprise a rectangle
@RandomLocationsNearCaster@randomLocations / @RLNCTargets random locations near the caster.
@RandomLocationsNearOrigin@RLO / @randomLocationsOrigin / @RLNOTargets random locations near the origin of a skill.
@BlocksNearOrigin@BNOTargets all blocks in a radius around the origin of the metaskill.
@RingAroundOrigin@ringOrigin / @RAOTargets locations in a specified ring around the origin.
@SpawnersTargets the location of the specified spawners.
@BlocksInPinRegionTargets the blocks in a region delimited by two pins
@ChunksInWERegion@chunksInWGRegionTargets the 0,0 chunk corners of the chunks in a specified WorldGuard region
@LivingInLine@entitiesInLine / @livingEntitiesInLine / @LEIL / @EILTargets any entities in a line between the inherited target and the casting mob.
@LivingNearTargetLocation@LNTL / @ENTL / @ENTTargets all living entities near the inherited target.
@PlayersNearTargetLocations@playersNearTargetLocation / @PNTLTargets all players near the inherited targets.
@TargetedTarget@TargetedTargets the inherited targeted entities.
@LineTargets locations between the mob and the inherited targets.
@RandomLocationsNearTargets@randomLocationsNearTarget / @randomLocationsNearTargetEntities / @randomLocationsNearTargetLocations / @RLNT / @RLNTE / @RLNTLTargets random locations around the inherited targets.
@FloorOfTargets@FOT / @floorsOfTargetTargets the blocks underneath the inherited targets.
@LocationsOfTargets@locationOfTarget / @LOTTargets the location of the inherited target entities.
@TargetedLocation@targetedLocations / @targetedLocTargets the location of the inherited target locations.
@BlocksInRadius@BIRTargets all blocks in a radius of the inherited targets.
@BlocksInChunk@BICTargets all blocks in a chunk relative to the inherited target.
@BlockVein@vein / @bvTarget all adjancent blocks that match the blocktype, starting from the origin of the skill.
@NoneProvides no target. (Useful for mechanics with no target input.)
@RegionSpecial targeter to target a region. Only works with specific mechanics
πŸ’‘ Best practice

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:

TriggerFires when
onCombatDefault
onAttackWhen the mob hits something
onDamagedWhen the mob is damaged
onSpawnWhen the mob spawns
onDespawnWhen the mob is despawned
onReadyTriggered the first time a mob is spawned from a spawner
onLoadWhen the mob is loaded after a server restart
onSpawnOrLoadWhen the mob either spawns or loads
onDeathWhen the mob dies
onTimerEvery \# ticks (where \# is the interval in ticks)
onInteractWhen the mob is right-clicked
onPlayerKillWhen the mob kills a player
onEnterCombatWhen the mob enters combat (requires threat tables be on)
onDropCombatWhen the mob leaves combat (requires threat tables be on)
onChangeTargetWhen the mob changes targets (requires threat tables be on)
onExplodeWhen the mob explodes (typically only used for creepers)
onPrimeWhen the creeper charges up for an explosion
onCreeperChargeWhen the creeper is charged (when lightning hits a creeper)
onTeleportWhen the mob teleports (typically only used for endermen)
onSignalWhen the mob receives a signal
onShootWhen the mob fires a projectile
onBowHitWhen the mob's fired projectile hits an entity
onTameWhen the mob gets tamed
onBreedWhen the mob breeds with another mob.
onTradeWhen the Villager completes a trade. Requires Paper
onChangeWorldWhen the mob changes world
onBucketWhen the cow is milked or an entity is bucketed (axolotl etc.)
onSkillDamageWhen the mob deals damage to other entities via a mechanic
onHearWhen the mob hears a sound, if enabled
onProjectileHitWhen a mob's special projectile hits an entity
onProjectileLandWhen a mob's special projectile hits a block
onDismountedWhen the mob is dismounted from
onCinematicStartWhen a cinematic camera path begins playing on a player
onCinematicEndWhen a cinematic camera path ends on a player (finish, cancel, quit, or death)
onEnterBoundsWhen the mob moves into a defined region
onExitBoundsWhen 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:

BlockChecked against
ConditionsThe caster.
TargetConditionsEach target β€” non-matching targets are filtered out.
TriggerConditionsThe 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:

ActionEffect on a match
trueThe skill runs if the condition is met. (Default.)
falseThe 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.
ConditionTypeDescription
AltitudeEntityTests how far above the ground the target entity is
BiomeLocationTests if the target is within the given list of biomes
BiomeTypeLocationTests for the biome category at a location.
BlockTypeLocationTests the material type present at the target location
BlockTypeInRadiusLocationChecks against the amount of specified blocks in a radius around the target location
BlockingEntityTests if the targeted player is blocking with a shield
BoundingBoxesOverlapCompareChecks if the caster's BoundingBox overlaps with the target's
BowTensionMetaChecks the bow tension of when an entity shoots from a bow
BurningEntityWhether or not the target entity is on fire
ChanceMetaThe chance that the metaskill has to be executed
ChargedEntityChecks if the target creeper is charged
ChildrenEntityTests how many children the caster has
ColorEntityTests the entity's colors
CompareValuesMetaCompares two values based on a specified operation
CrouchingEntityWhether or not the target entity is crouching
CuboidCompareWhether the target is within the given cuboid between location1 x location2
DamageAmountMetaChecks for a range of damage taken
DamageCauseMetaChecks the type of the damage cause
DamageTagMetaChecks the tags of the damage cause
DawnLocationIf the time is dawn, from 22000 to 2000 in-game time
DayLocationIf the time is day, from 2000 to 10000 in-game time
DimensionLocationIf the target location is within a certain dimension
DirectionalVelocityEntityIf the target has a velocity matching the given parameters
DistanceCompareWhether the distance between the caster and target is within the given range
DistanceFromLocationEntityWhether the distance between the target and a specified location is within a certain range
DistanceFromPinLocationChecks if the target is within a certain distance of a specified pin
DistanceFromSpawnLocationWhether the distance from the world's spawn point to the target is within the given range
DistanceFromTrackedLocationLocationWhether the distance from the tracked location to the caster is within the given range
DuskLocationIf the time is dusk, from 14000 to 18000 in-game time.
EnchantingExperienceEntityChecks the target player's experience points
EnchantingLevelEntityChecks the target player's experience level
EnderDragonAliveLocationChecks if there is at least one EnderDragon alive in the world of the targeted location
EnderDragonPhaseEntityChecks if the ender dragon is in a phase or phases
EntityItemIsSimilarEntityTests if the target item entity is similar to another item
EntityItemTypeEntityTests the type of the target item entity
EntityMaterialTypeEntityTests the material of the target item entity
EntityTypeEntityTests the entity type of the target
FactionEntityTests for the targets faction
FallSpeedEntityIf the fall speed of the target is within the given range
FieldOfViewCompareTests if the target is within the given angle from where the caster is looking
FoodLevelEntityChecks if the target has food within the range
FoodSaturationEntityChecks if the target has food within the range
GamemodeEntityChecks if the target player's gamemode is the specified one
GlidingEntityIf the target is gliding
GlobalScoreEntityChecks a global scoreboard value
HasAIEntityChecks if the target entity has its AI enabled
HasAuraEntityChecks if the target entity has the given aura
HasAuraStacksEntityTests if the target has the given range of stacks from an aura
HasAuraTypeEntityChecks if the target entity has the given aura type
HasCurrencyEntityIf the target has the given amount of vault currency
HasDialogOpenEntityChecks if the target player has a dialog open
HasEnchantmentEntityChecks if the target entity's equipped item has an enchantment
HasFreeInventorySlotEntityChecks if the evaluated entity has a free inventory slot
HasGravityEntityTests if the target mob has gravity
HasItemEntityTests if the target player has the given number of given material
HasOffhandEntityChecks if the target entity has something in the offhand
HasOwnerEntityTests if the target mob has an owner
HasParentEntityTests if the target mob has a parent
HasPassengerEntityChecks if the target entity has a passenger
HasPermissionEntityTests if the target player has a permission
HasPotionEffectEntityTests if the target entity has a potion effect
HasTagEntityTests if the target has a scoreboard tag
HealthEntityMatches the target's health
HealthPercentEntityMatches the target's health percentage or multiplier
HeightLocationChecks if the target's Y location is within a range
HeightAboveLocationChecks if the target's Y location is above a value
HeightBelowLocationChecks if the target's Y location is below a given value
HoldingEntityChecks if the target is holding a given material(support MythicMobs and MMOItems)
inBoundsCompareTests whether the target is inside an axis-aligned bounds box between two corners
inClaimLocationChecks if the target location is inside a claim
InCombatEntityChecks if the target mob is considered in combat
InPinRegionLocationChecks if the target location is within a region delimited by two pins
IsInvulnerableEntityChecks whether the target entity is invulnerable
IsInSurvivalModeEntityChecks if the target player is in survival mode
InsideLocationChecks if the target has a block over their head
isBabyEntityChecks if the target entity is a baby
isCancelledMetaChecks if the triggering event is cancelled
isCasterEntityChecks if the target is the caster
isChildEntityChecks if the target is a child of the caster
isClimbingEntityChecks if the target entity is climbing
IsCreeperPrimedEntityChecks if the target creeper is primed to explode
isFlyingEntityChecks if the target player is flying
isFrozenEntityChecks if the target entity is frozen
isInCinematicEntityChecks if the target player is in an active cinematic
isLeashedEntityChecks if the target has been leashed
isLivingEntityChecks if the target is a living entity
isMonsterEntityChecks if the target is a monster
isMythicMobEntityChecks if the target is a MythicMob
IsParentAliveEntityChecks if the parent of the target entity is still alive
IsParentCompareChecks if the target entity is the parent of the caster
isPlayerEntityChecks if the target is a player
isRaiderPatrolLeaderEntityChecks if the target entity is the captain of a pillager group
isSaddledEntityChecks if the target entity is saddled
IsSiblingCompareWhether the target entity is a sibling of the caster
isSkillMetaChecks whether the specified metaskill exists
isTamedEntityChecks if the target entity is tamed
IsUsingSpyglassEntityChecks if the target player is using a spyglass
ItemGroupOnCooldownEntityChecks whether the target player has the specified item group on cooldown
ItemIsSimilarEntityChecks that targeted player's inventory slot if it's similar to an item
ItemRechargingEntityChecks if the target's weapon is recharging
ItemTypeMetaChecks against the material of the item that triggered the skill
LastDamageCauseEntityChecks the target's last damage cause
LastSignalEntityMatches the last signal received by the target mob
LevelEntityChecks the target MythicMob's level
LightLevelLocationTests the light level at the target location
LightLevelFromBlocksLocationTests the light level originating from light-emitting blocks at the target location
SkyLightLevelLocationTests the sky light level at the target location
LineOfSightCompareTests if the target is within line of sight of the caster
LineOfSightFromOriginCompareTests if the target is within line of sight of the caster
LivingInRadiusLocationMatches a range to how many living entities are in the given radius
LocalDifficultyLocationTests the difficulty scale at the target location
LookingAtEntityChecks if the player is looking at something
LunarPhaseLocationChecks the target world's lunar phase
MaterialisOnCooldownEntityChecks if the target player's specified material is on cooldown
MetaskillConditionMetaCasts a Metaskill that will determine if the condition should check or not
MobsInChunkLocationMatches a range to how many mobs are in the target location's chunk
MobsInRadiusLocationChecks how many mobs are in a given radius
MobsInWorldLocationMatches a range to how many mobs are in the target world
MobsNearOriginMetaMatches a range to how many mobs are in the given radius around the origin
MobSizeEntityChecks the size of an entity that can have its size changed
MoistLocationChecks if the target block of farmland is hydrated
MoistureLevelLocationChecks if the target block of farmland has the specified level of hydratation
MotionXEntityChecks the X motion of the target entity against a range.
MotionYEntityChecks the Y motion of the target entity against a range.
MotionZEntityChecks the Z motion of the target entity against a range.
MountedEntityIf the target entity is riding a mount/vehicle
MovingEntityIf the target has a velocity greater than zero
MythicMobTypeEntityChecks the MythicMob type of the target mob
MythicPackMetaChecks for the presence of Pack
MythicPackVersionMetaChecks if a pack has a specified version
MythicPackVersionGreaterMetaChecks if a pack has a version greater or equal the specified one
NearClaimLocationIf the target location is near any GriefPrevention claims
NightLocationIf the time is night, from 14000 to 22000 in-game time
NotInRegionLocationIf the target location is not within the given WorldGuard region
OffGCDEntityChecks if the target mob has an active Global Cooldown
OnBlockLocationMatches the block the target entity is standing on
OnGroundEntityIf the target entity is standing on solid ground
OriginDistanceFromPinLocationChecks if the origin is within a certain distance of a specified pin
OriginLocationMetaChecks if the origin is at a given location
OutsideLocationIf the target has open sky above them
OwnerCompareChecks if the target entity is the owner of the caster
OwnerIsOnlineEntityChecks if the owner of the target mob is online, if the owner is a player
PitchEntityChecks if the pitch of the target entity is within a range
PlayerKillsEntityMatches how many players the target mob has killed
PlayerNotWithinLocationChecks if any players are within a radius of the target
PlayerWithinLocationChecks if any players are within a radius of the target
PlayersInRadiusEntityChecks how many players are in a radius
PlayersInWorldMetaMatches the number of players in the caster's world
PlayersOnlineMetaMatches the number of players online
PluginMetaChecks if the specified plugin is running on the server
PremiumMetaChecks if MythicMobs Premium is running on the server
ProjectileHasEndedMetaChecks if the calling projectile has ended
RainingLocationIf it's raining in the target world
RegionLocationIf the target is within the given WorldGuard region
SameFactionEntityTests if the caster and target are in the same faction
ScoreEntityChecks a scoreboard value of the target entity
ServerIsPaperMetaChecks whether the server is running a fork of paper.
ServerNmsVersionMetaChecks if the server is running the specified minecraft NMS version.
ServerVersionMetaChecks if the server is running the specified minecraft version.
ServerVersionAfterOrEqualMetaChecks whether the server is after or equal to a specific version
ServerVersionBeforeMetaChecks whether the server is before a specific version
SizeEntityChecks the size of the target entity
SkillOnCooldownEntityChecks if the given skill is in cooldown for the target
SpawnReasonEntityChecks against the spawn reason of the target
SprintingEntityChecks if the target Player is sprinting
StanceEntityChecks the stance of the target mob
StatDamageModifierMetaUsed in stat triggers to check the increased damage (as a multiplier).
StringEmptyMetaChecks if the provided string is empty
StringNotEmptyMetaChecks if the provided string is not empty
StringEqualsMetaChecks if value1 equals value2. Both values can use variables and placeholders.
StructureLocationMatches if the target location is inside of a structure
SunnyLocationIf the weather is sunny in the target world.
TargetInLineOfSightEntityTests if the target has line of sight to their target
TargetNotInLineOfSightEntityTests if the target doesn't have line of sight to their target
TargetWithinEntityTests if the target's target is within a certain distance
TargetNotWithinEntityTests if the target's target is not within a certain distance
TargetsMetaTests if the number of inherited targets from the parent skilltree matches the given range.
TemplateTypeEntityChecks if the target mob extends the specified Template
ThunderingLocationIf it's thundering in the target world
TriggerBlockTypeMetaChecks against the material type that triggered the skill
TriggerItemTypeMetaChecks against the item material type that triggered the skill
VariableContainsMetaChecks if the given variable contains a certain value
VariableEqualsMetaChecks if the given variable has a particular value.
VariableInRangeMetaChecks if the given numeric variable is within a certain range.
VariableIsSetMetaChecks if the given variable is set.
VehicleIsDeadEntityChecks if the casters mounted vehicle is dead.
VelocityEntityChecks the velocity of the target entity against a range.
WearingEntityTests what the target entity has equipped.
WorldLocationChecks the name of the target world.
WorldTimeLocationMatches a range against the target location's world's time.
YawEntityChecks the yaw of the target entity against a range.
xDiffEntityChecks the difference in X between the targeted entity and the caster.
yDiffEntityChecks the difference in Y between the targeted entity and the caster.
zDiffEntityChecks 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
πŸ“Œ Premium β€” dynamic chances

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
🚧 Workaround

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.

⚠ Version differences
  • 5.13.0 Spawners gained Chance, RandomRotation and UseWorldScaling.
  • 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.

πŸ“Œ Premium

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:

VersionNotable changes
5.13.0Cinematics 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.1Maintenance release on the 5.12 line.
5.12.0Large feature release (the master changelog's second-biggest section).
5.11.0Feature release.
5.10.0First entry in the current master changelog.
≤ 5.9.xDocumented 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).
πŸ“Œ Note

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

Sources