Built-in placeholders
This is an exhaustive list of all placeholders provided by UnderscoreEnchants as of v2.2. You are expected to be familiar with the syntax of placeholders and how to work with them, as outlined in the tips & tricks.
air
Info
Evaluates to the air ticks that the entity has left (1 tick = 0.05 seconds).
Aliases: air-level
This placeholder is marked as stable as of 2.2.
attr
Info
Evaluates to the value of the respective attribute of the entity.
Aliases: attribute, attrvalue, attributevalue, attrval, attributeval, attr-value, attribute-value, attr-val, attribute-val
Arguments:
type- the attribute name
This placeholder is marked as stable as of 2.2.
block-type
Info
Evaluates to the type of the block affected in the event.
Aliases: block-material, blockmaterial, material-block, materialblock, blocktype, type-block, typeblock
This placeholder is marked as stable as of 2.2.
block-x
Info
Evaluates to the X coordinate of the block affected in the event.
Aliases: blockx, x-block, xblock
This placeholder is marked as stable as of 2.2.
block-y
Info
Evaluates to the Y coordinate of the block affected in the event.
Aliases: blocky, y-block, yblock
This placeholder is marked as stable as of 2.2.
block-z
Info
Evaluates to the Z coordinate of the block affected in the event.
Aliases: blockz, z-block, zblock
This placeholder is marked as stable as of 2.2.
closest-entity
Info
Evaluates to the name of the closest entity.
Aliases: closest-entity-name, closestentity, closestentityname
Arguments:
max-distance- the distance in which to look for entities
This placeholder is marked as stable as of 2.2.
closest-player
Info
Evaluates to the name of the closest player.
Aliases: closest-player-name, closestplayer, closestplayername
Arguments:
max-distance- the distance in which to look for players
This placeholder is marked as stable as of 2.2.
damage
Info
Evaluates to the damage dealt in the event.
Aliases: dmg, dmg-dealt, damage-dealt, damag, hurt, hurtdmg, hurtdamage
This placeholder is marked as stable as of 2.2.
fire
Info
Evaluates to the fire ticks remaining for the entity (1 tick = 0.05 seconds).
Aliases: fire-ticks, fire-ticks-remaining
This placeholder is marked as stable as of 2.2.
food
Info
Evaluates to the food level of the player.
Aliases: food-level
This placeholder is marked as stable as of 2.2.
force
Info
Evaluates to the force with which an arrow has been shot.
Aliases: bowforce, bow-force, shootforce, shoot-force
This placeholder is marked as stable as of 2.2.
from-type
Info
Evaluates to the name of the block from which the player has moved.
Aliases: from-material, frommaterial, material-from, materialfrom, fromtype, type-from, typefrom
This placeholder is marked as stable as of 2.2.
from-pitch
Info
Evaluates to the pitch from which the player has moved.
Aliases: from-pitch, frompitch, pitch-from, pitchfrom
This placeholder is marked as stable as of 2.2.
from-x
Info
Evaluates to the X coordinate of the block from which the player has moved.
Aliases: from-x, fromx, x-from, xfrom
This placeholder is marked as stable as of 2.2.
from-yaw
Info
Evaluates to the yaw from which the player has moved.
Aliases: from-yaw, fromyaw, yaw-from, yawfrom
This placeholder is marked as stable as of 2.2.
from-y
Info
Evaluates to the Y coordinate of the block from which the player has moved.
Aliases: from-y, fromy, y-from, yfrom
This placeholder is marked as stable as of 2.2.
from-z
Info
Evaluates to the Z coordinate of the block from which the player has moved.
Aliases: from-z, fromz, z-from, zfrom
This placeholder is marked as stable as of 2.2.
gamemode
Info
Evaluates to the player's gamemode.
Aliases: gm, mode
This placeholder is marked as stable as of 2.2.
hp
Info
Evaluates to the entity's health.
Aliases: health
This placeholder is marked as stable as of 2.2.
highest-block-at
Info
Evaluates to the Y coordinate of the highest block at the specified X and Z coordinates.
Aliases: highest-block-at, highestblockat, highest-block, highestblock, highest-block-y, highestblocky, highest-block-y-at, highestblockyat,
top-block-at, topblockat, top-block, topblock, top-block-y, topblocky, top-block-y-at, topblockyat, highest-block-at-y, highestblockaty,
top-block-at-y, topblockaty
Arguments:
x- the X coordinatez- the Z coordinateworld- the world name
This placeholder is marked as stable as of 2.2.
int-x
Info
Evaluates to the block X coordinate of the location (instead of returning a fractional value like 396.2787623, returns a precise value 396).
Aliases: int-loc-x, int-location-x
This placeholder is marked as stable as of 2.2.
int-y
Info
Evaluates to the block Y coordinate of the location (instead of returning a fractional value like 396.2787623, returns a precise value 396).
Aliases: int-loc-y, int-location-y
This placeholder is marked as stable as of 2.2.
int-z
Info
Evaluates to the block Z coordinate of the location (instead of returning a fractional value like 396.2787623, returns a precise value 396).
Aliases: int-loc-z, int-location-z
This placeholder is marked as stable as of 2.2.
ip
Info
Evaluates to the IP address of the player.
Aliases: ip-address, address
This placeholder is marked as stable as of 2.2.
item-name
Info
Evaluates to the type of the item involved in the event.
Aliases: itemname, item-type, itemtype
This placeholder is marked as stable as of 2.2.
level
Info
Evaluates to the player's level.
Aliases: lvl
This placeholder is marked as stable as of 2.2.
max-air
Info
Evaluates to the maximum air ticks of the entity (1 tick = 0.05 seconds).
Aliases: maximum-air
This placeholder is marked as stable as of 2.2.
max-hp
Info
Evaluates to the maximum health of the entity.
Aliases: maximum-hp, max-health, maximum-health
This placeholder is marked as stable as of 2.2.
money
Info
Evaluates to the player's balance, either using Treasury's or Vault's economy (whichever is present, with Treasury taking the priority if both are). If none of them are present, silently fails.
Aliases: balance, bal
This placeholder is marked as stable as of 2.2.
name
Info
Evaluates to the player's name.
Aliases: player, nickname, nick, username
This placeholder is marked as stable as of 2.2.
ping
Info
Evaluates to the player's latency.
Aliases: latency, ping-ms, ms
This placeholder is marked as stable as of 2.2.
pitch
Info
Evaluates to the entity's pitch.
Aliases: loc-pitch, location-pitch
This placeholder is marked as stable as of 2.2.
random-double
Info
Evaluates to a random double in bounds.
Aliases: randomdouble, rnd-double, rnddouble, random-dbl, randomdbl, rnd-dbl, rnddbl, double-random, doublerandom, dbl-random, dblrandom,
dbl-rnd, dblrnd, double-rnd, doublernd
Arguments:
lowerBound- the lower boundupperBound- the upper bound
This placeholder is marked as stable as of 2.2.
random-int
Info
Evaluates to a random integer in bounds.
Aliases: randomint, rnd-int, rndint, random-int, randomint, rnd-int, rndint, int-random, intrandom, int-random, intrandom, int-rnd,
intrnd, int-rnd, intrnd
Arguments:
lowerBound- the lower boundupperBound- the upper bound
This placeholder is marked as stable as of 2.2.
random-negative-effect
Info
Evaluates to a random negative effect name.
Aliases: random-negative-effect, random-negative-potion, random-negative-effect, random-negative, random-neg-potion, random-neg-effect, random-neg,
random-debuff, random-debuff-effect, random-debuff-potion, random-debuff-effect, debuff, negative
This placeholder is marked as stable as of 2.2.
random-positive-effect
Info
Evaluates to a random positive effect name.
Aliases: random-positive-potion, random-positive-effect, random-positive, random-pos-potion, random-pos-effect, random-pos, random-buff,
random-buff-effect, random-buff-potion, random-buff-effect, buff, positive
This placeholder is marked as stable as of 2.2.
statistic
Info
Evaluates to the value of the respective statistic of the player.
Aliases: stat, stat-value, statistic-value, statvalue, statisticvalue, stat-val, statistic-val, statval, statisticval
Arguments:
type- the statistic name
This placeholder is marked as stable as of 2.2.
to-type
Info
Evaluates to the name of the block to which the player has moved.
Aliases: to-material, tomaterial, material-to, materialto, totype, type-to, typeto
This placeholder is marked as stable as of 2.2.
to-pitch
Info
Evaluates to the pitch to which the player has moved.
Aliases: to-pitch, topitch, pitch-to, pitchto
This placeholder is marked as stable as of 2.2.
to-x
Info
Evaluates to the X coordinate of the block to which the player has moved.
Aliases: to-x, tox, x-to, xto
This placeholder is marked as stable as of 2.2.
to-yaw
Info
Evaluates to the yaw to which the player has moved.
Aliases: to-yaw, toyaw, yaw-to, yawto
This placeholder is marked as stable as of 2.2.
to-y
Info
Evaluates to the Y coordinate of the block to which the player has moved.
Aliases: to-y, toy, y-to, yto
This placeholder is marked as stable as of 2.2.
to-z
Info
Evaluates to the Z coordinate of the block to which the player has moved.
Aliases: to-z, toz, z-to, zto
This placeholder is marked as stable as of 2.2.
uuid
Info
Evaluates to the entity's unique ID.
Aliases: id, unique-id, uniqueid
This placeholder is marked as stable as of 2.2.
world
Info
Evaluates to the entity's world name.
Aliases: world-name
This placeholder is marked as stable as of 2.2.
x
Info
Evaluates to the entity's X coordinate.
Aliases: loc-x, location-x
This placeholder is marked as stable as of 2.2.
xp
Info
Evaluates to the total experience of the player.
Aliases: total-xp, total-exp, exp
This placeholder is marked as stable as of 2.2.
yaw
Info
Evaluates to the entity's yaw.
Aliases: loc-yaw, location-yaw
This placeholder is marked as stable as of 2.2.
y
Info
Evaluates to the entity's Y coordinate.
Aliases: loc-y, location-y
This placeholder is marked as stable as of 2.2.
z
Info
Evaluates to the entity's Z coordinate.
Aliases: loc-z, location-z
This placeholder is marked as stable as of 2.2.