Skip to main content

Placeholders

Placeholders allow you to dynamically insert values into skills, messages, and configurations. They are enclosed in angle brackets < >.

Standard Placeholders

These placeholders provide information about the mob, caster, or target.
PlaceholderDescription
<mob.name>The display name of the mob
<mob.id>The internal ID of the mob
<mob.uuid>The UUID of the mob entity
<mob.level>The current level of the mob
<mob.hp> / <mob.health>Current health of the mob
<mob.mhp> / <mob.max_health>Maximum health of the mob
<mob.php> / <mob.hp.percent>Health percentage (0-100)
<mob.score.OBJECTIVE>Scoreboard value for a specific objective
<mob.threat>Current threat value
<mob.stance>Current stance of the mob
<mob.l.x>X coordinate of the mob’s location
<mob.l.y>Y coordinate of the mob’s location
<mob.l.z>Z coordinate of the mob’s location
<mob.l.w>World name of the mob’s location
<mob.l.p>Pitch of the mob’s location
<mob.l.yaw>Yaw of the mob’s location

Caster & Target Placeholders

You can also explicitly reference keys for the caster (the one using the skill) or target.
PlaceholderDescription
<caster.name>Name of the caster
<caster.uuid>UUID of the caster
<caster.damage>Last damage taken by the caster
<caster.threat>Current threat value of the caster
<caster.faction>Faction of the caster (from scoreboard tags)
<caster.type>Entity type of the caster (e.g. minecraft:zombie)
<caster.l.x>Caster’s X coordinate
<caster.l.y>Caster’s Y coordinate
<caster.l.z>Caster’s Z coordinate
<caster.l.w>Caster’s World name
<target.name>Name of the target
<target.uuid>UUID of the target
<target.threat>Current threat value of the target
<target.faction>Faction of the target
<target.type>Entity type of the target
<target.l.x>Target’s X coordinate
<target.l.y>Target’s Y coordinate
<target.l.z>Target’s Z coordinate
<target.l.w>Target’s World name
<target.hp>Target’s current health
<target.mhp>Target’s maximum health
<target.php>Target’s health percentage
<target.score.OBJECTIVE>Target’s scoreboard value
<target.dist>Distance between caster and target

Variable Placeholders

Access variables stored on the mob, target, or globally.
PlaceholderDescription
<mob.var.VARNAME>Value of a variable stored on the mob
<var.global.VARNAME>Value of a global variable
<var.caster.VARNAME>Value of a variable on the caster
<var.target.VARNAME>Value of a variable on the target
<var.skill.VARNAME>Value of a variable local to the current skill chain

Trigger Placeholders

Available when a skill is triggered by an event.
PlaceholderDescription
<trigger.name>Name of the entity that triggered the skill
<trigger.uuid>UUID of the triggering entity
<trigger.arg>Argument passed with the trigger (if any)

Miscellaneous

PlaceholderDescription
<random.0-1>A random decimal between 0 and 1
<random.#to#>A random number between two values (e.g. <random.5to10>)
<world.time>Current time in the world