Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.borntocraftstudio.net/llms.txt

Use this file to discover all available pages before exploring further.

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