Conditions

A condition is a yes/no question about an entity or a place: is it night, is the player holding a bow, are there fewer than five minions left. The same conditions work everywhere a question can be asked:

Where	Written as	Asks about
A skill’s gate	`conditions:` on the skill	the caster
A skill’s target filter	`target-conditions:`	each target
A skill’s trigger filter	`trigger-conditions:`	the trigger entity
One line	`?isNight`, `?~isPlayer` (see Line Options)	the caster, or the trigger with `~`
A branch	`if{cond=…;then=…}`, `while{cond=…}` (see Flow Control)	the line’s first target
A targeter	`@playersInRadius{r=10;conditions=[ - sneaking ]}`	each candidate
A spawn rule	`cond:` (see Natural Spawns)	the candidate spot
A dialog	`conditions:` on a node or choice (see Dialog Conditions)	the talking player

The entity being asked about is the subject. Place questions (isBiome, lightLevel) ask about the subject’s position, or about the spot itself when there is no entity, as in a spawn rule.

Writing one

A condition is a name, optionally with options in braces: isNight, health{h=<50}, mobsInRadius{r=24;a=1to5;types=crypt_minion}. Names are case-insensitive and every MythicMobs name and alias is understood. Ranges take MythicMobs’ shapes: >5, >=2, <10, <=3, 1to10, an exact 4, and percentages where they make sense: healthpercent{p=<50%}.

Combining them

In cond= and cond:, conditions combine like code:

- if{cond=isNight && var.phase >= 2;then=night_ambush}
- if{cond=!(moving) || health <= 20;then=rest}

&& (and) binds tighter than || (or). ! negates, (…) groups.
Comparisons: >= <= > < == !=, between numbers, variables (var.x, target.var.x, global.var.x, world.var.x, skill.var.x), and the keywords random (a fresh 0–1 roll), health and maxhealth (the caster’s), time (world ticks since creation), plus the place numbers light, blocklight, skylight, y, daytime, moonphase and spawndistance.
Two numbers compare as numbers; anything else compares as case-insensitive text with == and != only. An unset variable counts as 0 or empty.
A lone value with no comparison is true when it is set and not zero: if{cond=var.enraged;then=…}.

Quote a condition that starts with !. YAML reads a leading ! as a tag: - "!raining".

Lists

A conditions: list must all pass. MythicMobs’ list syntax works as written, with an action after each entry saying what to do with the answer:

penguin_step:
  conditions:
  - moving true
  - mobsInRadius{types=penguin;r=8} false
  effects:
  - sound{s=entity.polar_bear.step} @self

Action	Meaning
`true`	Must pass. The default when no action is written.
`false`	Must fail.
`cast <skill>`	Runs that skill when it passes, and carries on.
`castinstead <skill>`	Runs that skill instead when it passes.
`orElseCast <skill>`	Runs that skill instead when it fails.
`power <n>`	Multiplies the skill’s power when it passes.
`cancel`	Stops the skill when it passes.

Gating a skill

A skill written as a section takes a gate, checked against the caster before anything runs:

check_minions:
  conditions:
  - "mobsInRadius{types=crypt_minion;a=1to20;r=24}"
  conditions-else: no_minions_left   # MythicMobs' orElseCast
  effects:
  - actionbar{m=&7The minions are up} @playersRadius[24]

The gate applies however the skill is called: skill, an if or loop body, repeat, an aura, the addon API.
conditions-else names a skill to run instead. Chains are followed up to 8 deep, so two skills naming each other can’t loop forever.
A gate that doesn’t parse is reported by /le debug and dropped, so the skill still runs. A silently disabled ability is harder to trace than one that fires when it shouldn’t.

Every condition

All MythicMobs conditions plus a few of LodeEntities’ own (moving, isBiome, isWorldType, isSpawnable and the other place checks). Where the example shows an option, that is the main one; the MythicMobs aliases for it work too.

Time and weather

Condition	Example	True when
`dawn`	`dawn`	It is dawn (22000–1999).
`dusk`	`dusk`	It is dusk (14000–17999).
`isday` _{also day}	`isDay`	It is day (2000–9999).
`isnight` _{also night}	`isNight`	It is night (14000–21999).
`istime` _{also timeofday}	`isTime{night}`	The time of day is one of `dawn`, `day`, `dusk`, `night`.
`isweather` _{also weather}	`isWeather{rain}`	The weather is `clear`, `rain` or `thunder`.
`lunarPhase` _{also moonphase}	`lunarPhase{p=0}`	The moon phase (0–7) is in a range.
`raining` _{also israining}	`raining`	It is raining.
`stormy` _{also isstormy}	`stormy`	There is a thunderstorm.
`sunny` _{also issunny}	`sunny`	It is not raining.
`thundering` _{also isthundering}	`thundering`	There is a thunderstorm.
`worldtime`	`worldtime{t=13000to23000}`	The world time is in a range.

Place

Condition	Example	True when
`altitude` _{also heightfromsurface}	`altitude{h=>5}`	Blocks above the ground is in a range.
`biometype` _{also biomecategory}	`biometype{t=ocean}`	The biome is of one of these categories.
`blockType` _{also inblock, insideblock}	`blockType{t=lava}`	The block at the subject’s position is one of these.
`blockTypeInRadius`	`blockTypeInRadius{t=chest;r=5;a=>0}`	How many blocks of these types are within `r`.
`cuboid` _{also incuboid}	`cuboid{a=0,60,0;b=20,80,20}`	The subject is inside a box between two corners.
`dimension` _{also environment}	`dimension{d=nether}`	The world is a `normal`, `nether` or `the_end` dimension.
`distanceFromLocation`	`distanceFromLocation{location=0,64,0;d=<50}`	Distance from a location is in a range.
`distanceFromPin`	`distanceFromPin{pin=altar;d=<10}`	Distance from a pin is in a range.
`distanceFromSpawn`	`distanceFromSpawn{d=>1000}`	Distance from world spawn is in a range.
`distanceFromTrackedLocation` _{also distanceFromTL}	`distanceFromTrackedLocation{d=>20}`	Distance from the caster’s tracked location is in a range.
`enderdragonalive` _{also isdragonalive, dragonalive}	`enderdragonalive`	An ender dragon is alive in the world.
`height`	`height{h=40to80}`	The Y coordinate is in a range.
`heightAbove`	`heightAbove{h=100}`	The Y coordinate is above a value.
`heightBelow`	`heightBelow{h=0}`	The Y coordinate is below a value.
`inClaim`	`inClaim`	Inside a land claim. Needs GriefPrevention.
`inPinRegion`	`inPinRegion{p1=a;p2=b}`	Inside the box between two pins.
`inside`	`inside`	There is a block above the subject.
`isbiome` _{also biome}	`isBiome{desert, badlands}`	The biome is one of these. A bare name matches any namespace; `mygen:frozen_wastes` matches one.
`isblock` _{also block}	`isBlock{water}`	The block at the spot is one of these.
`isblockbelow` _{also blockbelow, ison, onblock}	`isBlockBelow{sand}`	The block underneath is one of these.
`isflat` _{also flatworld}	`isFlat`	The world is superflat.
`isground` _{also onground}	`isGround`	The block below is solid.
`ismoist` _{also moist}	`ismoist`	The farmland at the spot is wet.
`isspawnable` _{also spawnable}	`isSpawnable`	Two passable blocks: room for something to stand.
`isworld` _{also world}	`isWorld{world_nether}`	The world is one of these.
`isworldtype` _{also worldtype}	`isWorldType{flat, amplified}`	The world was generated as `normal`, `flat`, `large_biomes` or `amplified`. Biome checks can’t tell you this: superflat plains look like plains.
`lightLevel`	`lightLevel{l=<8}`	Total light level at the spot is in a range.
`lightLevelfromblocks` _{also blocklightlevel}	`lightLevelFromBlocks{l=>10}`	Light from blocks alone is in a range.
`localdifficulty`	`localdifficulty{d=>2}`	The regional difficulty is in a range.
`moisturelevel` _{also moistness, moistureness}	`moisturelevel{l=7}`	The farmland moisture is in a range.
`nearClaim` _{also nearClaims}	`nearClaim{r=16}`	A land claim is within `r`. Needs GriefPrevention.
`notInRegion`	`notInRegion{r=spawn}`	Not inside a WorldGuard region. Needs WorldGuard.
`originDistanceFromPin`	`originDistanceFromPin{pin=altar;d=<10}`	The skill origin’s distance from a pin is in a range.
`originLocation`	`originLocation{l=0,64,0}`	The skill’s origin is at a location.
`outside`	`outside`	Open sky above the subject.
`region` _{also inregion}	`region{r=spawn}`	Inside a WorldGuard region. Needs WorldGuard.
`structure`	`structure{s=village_plains}`	Inside one of these structures.

The subject

Condition	Example	True when
`children`	`children{a=<3}`	How many mobs it has summoned is in a range.
`color` _{also clr}	`color{c=red}`	Its colour (sheep, shulker, …) matches.
`enderdragonPhase` _{also edragonPhase}	`enderdragonPhase{p=circling}`	An ender dragon’s phase is one of these.
`entityType` _{also mobtype}	`entityType{t=zombie,crypt_warden}`	Its vanilla type, or its LodeEntities id, is one of these.
`faction`	`faction{f=undead}`	Its faction matches.
`gamemode` _{also gm}	`gamemode{m=survival}`	A player’s game mode is one of these.
`globalscore` _{also scoreglobal}	`globalscore{o=wave;v=3}`	A server-wide score is in a range.
`hasOwner`	`hasOwner`	It has an owner.
`hasParent`	`hasParent`	It has a parent.
`hasTag` _{also hasScoreboardTag}	`hasTag{t=marked}`	It has a scoreboard tag.
`incombat`	`incombat`	It is in combat.
`isInSurvivalMode` _{also inSurvivalMode}	`isInSurvivalMode`	A player is in survival.
`isliving`	`isLiving`	It is a living entity.
`ismonster`	`isMonster`	It is a hostile mob.
`isMythicMob` _{also isMM}	`isMythicMob`	It is a LodeEntities mob.
`isParentAlive` _{also parentAlive}	`isParentAlive`	Its parent is still alive.
`isplayer`	`isPlayer`	It is a player.
`lastSignal`	`lastSignal{s=ready}`	The last signal it received matches.
`level`	`level{l=>5}`	Its level is in a range.
`mythicMobType` _{also mmType}	`mythicMobType{t=crypt_warden}`	It is one of these LodeEntities mobs.
`name` _{also castername}	`name{n=Bob}`	Its name matches.
`ownerIsOnline`	`ownerIsOnline`	Its player owner is online.
`playerKills`	`playerKills{k=>0}`	How many players it has killed is in a range.
`score`	`score{o=kills;v=>10}`	Its scoreboard score is in a range.
`size` _{also mobSize}	`size{s=>2}`	Its size (slimes, phantoms) is in a range.
`spawnReason`	`spawnReason{r=natural}`	Why it spawned is one of these.
`stance`	`stance{s=enraged}`	Its stance (set with `setstance`) matches.
`templateType` _{also template, instanceOf}	`templateType{t=crypt_warden}`	It is one of these LodeEntities mobs.

State

Condition	Example	True when
`blocking` _{also isblocking}	`blocking`	It is blocking with a shield.
`burning` _{also isburning, isonfire}	`burning`	It is on fire.
`charged` _{also isCharged, creeperCharged}	`charged`	A creeper is charged.
`crouching` _{also iscrouching}	`crouching`	It is sneaking.
`directionalvelocity` _{also dvelocity}	`directionalvelocity{f=>0.2}`	Its velocity relative to its facing (`x` side, `y` up, `z` forward) is in a range.
`enchantingExperience` _{also enchantingExp, enchantExperience, enchantExp}	`enchantingExperience{a=>100}`	A player’s experience points are in a range.
`enchantingLevel`	`enchantingLevel{l=>30}`	A player’s experience level is in a range.
`fallSpeed` _{also fallingspeed}	`fallSpeed{s=>0.8}`	How fast it is falling is in a range.
`foodlevel` _{also hunger, food, hungerlevel}	`foodlevel{a=<6}`	A player’s hunger is in a range.
`foodSaturation` _{also hungerSaturation}	`foodSaturation{a=0}`	A player’s saturation is in a range.
`gliding` _{also isgliding}	`gliding`	It is gliding with an elytra.
`grounded`	`grounded`	It is standing on solid ground.
`hasAI`	`hasAI`	Its AI is on.
`hasAura` _{also hasbuff, hasdebuff}	`hasAura{name=shield}`	It has an aura with that name.
`hasAuraStacks` _{also hasbuffstacks, hasdebuffstacks, aurastacks, buffstacks, debuffstacks}	`hasAuraStacks{name=bleed;s=>3}`	It has that many stacks of an aura.
`hasAuraType` _{also hasbufftype, hasdebufftype}	`hasAuraType{t=debuff}`	It has an aura of that group.
`hasgravity` _{also gravity}	`hasgravity`	Gravity applies to it.
`haspassenger`	`haspassenger`	Something is riding it.
`hasPotionEffect` _{also hasPotion}	`hasPotionEffect{t=poison}`	It has a potion effect, optionally at a `level` or `duration` range.
`health` _{also hp}	`health{h=<50}`	Its health is in a range.
`healthpercent` _{also hppercent}	`healthpercent{p=<0.5}`	Its health as a fraction of max is in a range.
`isBaby`	`isBaby`	It is a baby.
`isClimbing` _{also climbing}	`isClimbing`	It is on a ladder or vine.
`isCreeperPrimed`	`isCreeperPrimed`	A creeper is about to explode.
`isflying` _{also flying}	`isFlying`	A player is flying.
`isFrozen`	`isFrozen`	It is fully frozen in powder snow.
`isInvulnerable` _{also isInvincible}	`isInvulnerable`	It is invulnerable.
`isLeashed`	`isLeashed`	It is on a lead.
`isRaiderPatrolLeader` _{also isPatrolLeader}	`isRaiderPatrolLeader`	It leads a pillager patrol.
`isSaddled` _{also saddled}	`isSaddled`	It has a saddle.
`isTamed`	`isTamed`	It is tamed.
`isUsingSpyglass` _{also isScoping}	`isUsingSpyglass`	A player is looking through a spyglass.
`lastDamageCause`	`lastDamageCause{damagecause=fall}`	What last hurt it is one of these causes.
`motionx` _{also motx}	`motionx{v=>0}`	Its X motion is in a range.
`motiony` _{also moty}	`motiony{v=<0}`	Its Y motion is in a range.
`motionz` _{also motz}	`motionz{v=>0}`	Its Z motion is in a range.
`mounted`	`mounted`	It is riding something.
`moving` _{also ismoving}	`moving`	It is walking. Horizontal speed only, so jumping and falling don’t count; set the threshold with `moving{speed=0.05}`.
`offGCD`	`offGCD`	Its global cooldown (`gcd`) has run out.
`pitch`	`pitch{p=<-45}`	Its head pitch is in a range.
`skillOnCooldown`	`skillOnCooldown{s=fireball}`	A skill is still on cooldown for it.
`sneaking` _{also issneaking}	`sneaking`	It is sneaking.
`sprinting` _{also issprinting}	`sprinting`	A player is sprinting.
`vehicleisdead`	`vehicleisdead`	What it was riding has died.
`velocity`	`velocity{v=>0.5}`	Its speed is in a range.
`yaw`	`yaw{y=0to90}`	Its yaw is in a range.

Caster and target

These compare the caster with the subject.

Condition	Example	True when
`boundingBoxesOverlap` _{also bbsoverlap}	`boundingBoxesOverlap`	Their hitboxes touch.
`distance`	`distance{d=<5}`	Distance between the caster and the subject is in a range.
`fieldOfView` _{also infieldofview, fov}	`fieldOfView{a=90}`	The subject is within `a` degrees of where the caster is looking.
`iscaster`	`iscaster`	The subject is the caster.
`ischild` _{also child}	`ischild`	The subject was summoned by the caster.
`lineOfSight` _{also inlineofsight}	`lineOfSight`	The caster can see the subject.
`lineOfSightFromOrigin` _{also inlineofsightfromorigin}	`lineOfSightFromOrigin`	The skill’s origin can see the subject.
`owner`	`owner`	The subject is the caster’s owner.
`parent` _{also isParent}	`parent`	The subject is the caster’s parent.
`samefaction` _{also factionsame}	`samefaction`	The subject is in the caster’s faction.
`targetInLineOfSight`	`targetInLineOfSight`	The subject can see its own target.
`targetNotInLineOfSight`	`targetNotInLineOfSight`	The subject can’t see its own target.
`targetNotWithin`	`targetNotWithin{d=10}`	The subject’s own target is further than `d` blocks.
`targets`	`targets{a=>2}`	How many targets the calling line handed down is in a range.
`targetWithin`	`targetWithin{d=10}`	The subject’s own target is within `d` blocks.
`ydiff`	`ydiff{d=>3}`	The height difference between them is in a range.

Counts

Condition	Example	True when
`chance`	`chance{c=0.25}`	A random roll: `0.25` passes a quarter of the time.
`livinginradius`	`livinginradius{r=10;a=>3}`	How many living entities are within `r`.
`mobsinchunk`	`mobsinchunk{a=<20}`	How many mobs are in the chunk.
`mobsinradius` _{also mir, mobinradius, entitiesinradius, eir}	`mobsInRadius{r=24;a=1to5;types=my_minion}`	How many non-player living entities are within `r`, optionally only these types (mob ids or vanilla types).
`mobsinworld`	`mobsinworld{a=<500}`	How many mobs are in the world.
`playerNotWithin` _{also playersnotwithin}	`playerNotWithin{d=10}`	No player is within `d` blocks.
`playersinradius` _{also pir, playerinradius}	`playersInRadius{r=16;a=>0}`	How many players are within `r`. `a` is a range; omitted means at least one.
`playersInWorld`	`playersInWorld{a=>5}`	How many players are in the world.
`playersOnline` _{also onlinePlayerCount, onlinePlayers}	`playersOnline{a=>10}`	How many players are online.
`playerWithin` _{also playerswithin}	`playerWithin{d=10}`	Any player is within `d` blocks.

The event

Condition	Example	True when
`bowTension` _{also bowshoottension}	`bowTension{f=>0.9}`	How far the bow was drawn, for `+onShoot`.
`DamageAmount`	`DamageAmount{a=>10}`	The damage that fired the skill is in a range. For `+onHurt` and damage auras.
`DamageCause`	`DamageCause{damagecause=fire}`	The cause of the damage that fired the skill.
`damageTag` _{also damageHasTag}	`damageTag{t=fire}`	The damage that fired the skill carries a tag.
`itemType` _{also triggerItemType, triggeringItemType}	`itemType{t=diamond_sword}`	The item that fired the skill is one of these.
`triggerBlockType` _{also triggeringBlockType}	`triggerBlockType{t=stone}`	The block that fired the skill is one of these.

Items

Condition	Example	True when
`entityitemissimilar`	`entityitemissimilar{item=diamond}`	A dropped item matches.
`entityItemType` _{also entityMaterialType}	`entityItemType{m=diamond}`	A dropped item is one of these types.
`hasCurrency` _{also hasmoney}	`hasCurrency{a=100}`	A player has at least that much money. Needs Vault.
`hasEnchantment` _{also hasEnchant}	`hasEnchantment{e=sharpness;l=>3}`	Its equipment has an enchantment.
`hasInventorySpace`	`hasInventorySpace`	A player has a free inventory slot.
`hasitem` _{also has}	`hasItem{item=diamond;amount=2}`	A player carries the item (at least `amount`).
`hasoffhand` _{also offhand}	`hasoffhand`	It has something in its off hand.
`haspermission` _{also hasperm, permission}	`hasPermission{perm=my.node}`	A player has a permission.
`holding`	`holding{item=bow}`	It is holding the item.
`itemissimilar` _{also issimilar, similarto}	`itemissimilar{slot=hand;item=diamond_sword}`	The item in a slot matches.
`itemRecharging`	`itemRecharging`	A player’s attack is still recharging.
`lookingAt`	`lookingAt{b=chest;d=5}`	A player is looking at a block or entity type within `d`.
`materialIsOnCooldown` _{also materialCooldown, matCooldown}	`materialIsOnCooldown{m=ender_pearl}`	An item type is on cooldown for a player.
`wearing` _{also iswearing, wielding, iswielding}	`wearing{slot=head;item=diamond_helmet}`	It has the item in that equipment slot.

Variables

Condition	Example	True when
`stringEmpty` _{also isEmpty}	`stringEmpty{v=<caster.var.name>}`	A placeholder resolves to nothing.
`stringEquals` _{also stringEq}	`stringEquals{v1=<target.name>;v2=Steve}`	Two values are equal; both may use placeholders.
`stringNotEmpty` _{also notEmpty}	`stringNotEmpty{v=<caster.var.name>}`	A placeholder resolves to something.
`variableEquals` _{also variableeq, varequals, vareq}	`variableEquals{var=caster.phase;value=2}`	A variable equals a value.
`variableInRange` _{also varinrange, varrange}	`variableInRange{var=caster.hits;value=>5}`	A numeric variable is in a range.
`variableIsSet` _{also varisset, varset}	`variableIsSet{var=target.marked}`	A variable is set.

Server

Condition	Example	True when
`plugin` _{also pluginexists, hasplugin}	`plugin{p=WorldGuard}`	A plugin is installed.
`serverversion` _{also server, version}	`serverversion{v=1.21.4}`	The server runs that Minecraft version.
`servernmsversion` _{also servernms, nmsversion}	`servernmsversion{v=v1_21_R3}`	The server runs that internal version.
`premium` _{also ispremium, iscool}	`premium`	Always passes. Accepted for compatibility.
`mythicpack` _{also pack, haspack}	`mythicpack{pack=x}`	Accepted for compatibility; packs aren’t supported, so it never passes.
`packversion` _{also mythicpackversion, packversionis}	`packversion{pack=x;v=1}`	Accepted for compatibility; never passes.
`packversiongreater` _{also mythicpackversiongreater, packversionisgreater}	`packversiongreater{pack=x;v=1}`	Accepted for compatibility; never passes.
`MythicKeyId` _{also keyid, ariKeyId}	`MythicKeyId{key=x}`	Accepted for compatibility; key presses need a client mod and never fire.

Region and claim conditions need WorldGuard or GriefPrevention; without the plugin they answer “no”. Addons can register more conditions; see Extending the Effect Language.

Getting Started

Mobs

Spawning

Commands

Effects

Models

Compatibility

NPCs

Pets

Configuration

API

Writing one

Combining them

Lists

Gating a skill

Every condition

Time and weather

Place

The subject

State

Caster and target

Counts

The event

Items

Variables

Server

​Writing one

​Combining them

​Lists

​Gating a skill

​Every condition

​Time and weather

​Place

​The subject

​State

​Caster and target

​Counts

​The event

​Items

​Variables

​Server

Writing one

Combining them

Lists

Gating a skill

Every condition

Time and weather

Place

The subject

State

Caster and target

Counts

The event

Items

Variables

Server