Placeholders

This is an old version of this page. You can view the most recent version or browse the history.

These are all of the placeholders and special characters you can use in skills and mechanics that use strings.

Examples

This will make a mob (name in teal (&b)) send a message to all players in a radius of 20 blocks around in itself, stating that it was slain by player x (<trigger.name> in green (&a))

Skills:
- message{m="&b<mob.name>&r was slain by the warrior skills of &a<trigger.name>&r"} @PIR{r=20} ~onDeath

Skill Placeholders

Mob Placeholder	Function
Some placeholders may not function properly if they don't apply to the caster (e.g. the caster is a player). Pre 4.6.0 versions use "mob" instead of "caster"
<caster.uuid>	Returns the UUID of the caster
<caster.level>	Returns the level of the caster
<caster.name>	Returns the name of the caster
<caster.hp>	Returns current hp of the caster
<caster.mhp>	Returns the max hp of the caster
<caster.php>	Returns the percent hp of the caster
<caster.thp>	Returns the full number hp of the caster
<caster.tt.top>	Returns the name of the top threat holder of the caster
<caster.l.w>	Returns the world name the caster is in
<caster.l.x>	Returns the X coordinate of the caster
<caster.l.x.#>	Returns the X coordinate of the caster +- random number between #
<caster.l.y>	Returns the Y coordinate of the caster
<caster.l.y.#>	Returns the Y coordinate of the caster +- random number between #
<caster.l.z>	Returns the Z coordinate of the caster
<caster.l.z.#>	Returns the Z coordinate of the caster +- random number between #
<caster.l.yaw>	Returns the yaw of the caster
<caster.l.pitch>	Returns the pitch of the caster
<caster.stance>	Returns the current stance of the caster
<caster.owner.name>	Returns the name of the wolf's owner
<caster.owner.uuid>	Returns the uuid of the wolf's owner

Variable Placeholders (v4.6)	Function
<caster.var.[name]>	Returns the value of the variable [name] on the caster.
<skill.var.[name]>	Returns the value of the variable [name] on the current skill tree.
<skill.var.damage-amount>	Returns the amount of damage taken in the onDamaged trigger
<skill.var.damage-type>	Returns the type of damage taken as specified in a mechanic, aura, etc.

Target Placeholders	Function
These placeholders will return whatever targetselector has been used. For instance <target.name> + @NearestPlayer will return the name of the player closest to the casting mob.
<target.uuid>	Returns the UUID of the target
<target.name>	Returns the name of the target
<target.hp>	Returns the current hp of the target
<target.threat>	Returns the threat level of the target
<target.l.w>	Returns the world name the target is in
<target.l.x>	Returns the X coordinate of the target
<target.l.x.#>	Returns the X coordinate of the target +- random number between #
<target.l.y>	Returns the Y coordinate of the target
<target.l.y.#>	Returns the Y coordinate of the target +- random number between #
<target.l.z>	Returns the Z coordinate of the target
<target.l.z.#>	Returns the Z coordinate of the target +- random number between #

Trigger Placeholders	Function
<trigger.uuid>	Returns the UUID of the person triggering the skill
<trigger.name>	Returns the name of the person triggering the skill
<trigger.hp>	Returns the current hp of the person triggering the skill
<trigger.threat>	Returns the threat level of the person triggering the skill
<trigger.l.w>	Returns the world name of the person triggering the skill
<trigger.l.x>	Returns the X coordinate of the person triggering the skill
<trigger.l.x.#>	Returns the X coordinate of the person triggering the skill +- random number between #
<trigger.l.y>	Returns the Y coordinate of the person triggering the skill
<trigger.l.y.#>	Returns the Y coordinate of the person triggering the skill +- random number between #
<trigger.l.z>	Returns the Z coordinate of the person triggering the skill
<trigger.l.z.#>	Returns the Z coordinate of the person triggering the skill +- random number between #

Misc Placeholders

Placeholder	Function
Misc Placeholders
<drops.xp>	Returns the xp dropped via Heroes or SkillAPI mods
<drops.money>	Returns the money dropped through the vault plug-in

Special Placeholders

Placeholder	Function
<caster.score.objective>	Returns the score of the caster from "objective" (2.3)
<target.score.objective>	Returns the targeters score from "objective" (2.3)
<trigger.score.objective>	Returns the score of the trigger from "objective" (2.3)
<global.score.objective>	Returns the global score from "objective" (2.3)
<score.objective.dummyname>	Returns the score of "dummyname" (fake player) from "objective" (2.3)
<random.#-#> ^(v4.6)	Returns a random number in the specified range

Special Characters

Placeholder	Function
<&co>	Returns a colon (:)
<&sq>	Returns an apostrophe (')
<&da>	Returns a dash (-)
<&bs>	Returns a backslash (\)
<&fs>	Returns a forward slash (/)
<&sp>	Returns a space
<&cm>	Returns a comma (,)
<&sc>	Returns a semicolon (;)
<&eq>	Returns an equals symbol [=]
<&ss>	Returns a section symbol (ยง)
<&dq>	Returns double quotes (")
<&rb>	Returns a right bracket (])
<&lb>	Returns a left bracket ([)
<&rc>	Returns a right curly bracket (})
<&lc>	Returns a left curly bracket ({)
<&nl>	Forces a new line
<&heart>	Returns a heart (2.1.7)
<&skull>	Returns a skull and bones (2.1.7)

Color Codes

These color codes work anywhere in mob- and skill-files. They will even properly format tellraw-commands used in command skills!

Code	Color	Code	Color
&0	Black	&B	Aqua
&1	Dark Blue	&C	Red
&2	Dark Green	&D	Light Purple
&3	Dark Aqua	&E	Yellow
&4	Dark Red	&F	White
&5	Dark Purple	&K	Magic
&6	Gold	&L	Bold
&7	Gray	&M	Strike through
&8	Dark Gray	&N	Underline
&9	Blue	&O	Italic
&A	Green	&R	Reset