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.
| Placeholder | Description |
|---|---|
<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.
| Placeholder | Description |
|---|---|
<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.
| Placeholder | Description |
|---|---|
<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.
| Placeholder | Description |
|---|---|
<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
| Placeholder | Description |
|---|---|
<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 |
PlaceholderAPI (%btcmobs_...%)
When PlaceholderAPI is installed, BTCMobs registers the btcmobs expansion. These resolve in
player context (chat, HUDs, nameplates, BetterHud, Custom-Nameplates):
| Placeholder | Description |
|---|---|
%btcmobs_looking_name% | Display name of the BTCMob the player is looking at |
%btcmobs_looking_type% | Internal type id of the looked-at mob |
%btcmobs_looking_level% | Level of the looked-at mob |
%btcmobs_looking_hp% / _maxhp% / _percent% | Current / max health / health % |
%btcmobs_looking_uuid% | UUID of the looked-at mob |
%btcmobs_caster_name/type/level/hp/maxhp/uuid% | Data when the player itself is a BTCMob |
%btcmobs_var_<name>% | Value of a global BTCMobs variable |
Returns an empty string when the player is not looking at a BTCMob, so display strings degrade cleanly. See the API reference for programmatic access.