Default Placeholders

Placeholders dynamically resolve contextual data (such as player statistics or server information) into text. Below is a list of all default placeholders included in AbyssalLib and their required syntax.

Data Placeholders

These placeholders retrieve specific values from the game, the player, or the server.

Placeholder ID	Syntax	Description
`abyssallib:player_name`	`<placeholder:abyssallib:player_name>`	Returns the player's username.
`abyssallib:player_uuid`	`<placeholder:abyssallib:player_uuid>`	Returns the player's UUID as a string.
`abyssallib:player_world`	`<placeholder:abyssallib:player_world>`	Returns the namespace key of the player's current world.
`abyssallib:player_gamemode`	`<placeholder:abyssallib:player_gamemode>`	Returns the name of the player's current gamemode.
`abyssallib:player_locale`	`<placeholder:abyssallib:player_locale>`	Returns the player's client language locale setting.
`abyssallib:player_ping`	`<placeholder:abyssallib:player_ping>`	Returns the player's current connection ping in milliseconds.
`abyssallib:player_health`	`<placeholder:abyssallib:player_health>`	Returns the player's current health.
`abyssallib:player_max_health`	`<placeholder:abyssallib:player_max_health>`	Returns the player's maximum health attribute value.
`abyssallib:player_food`	`<placeholder:abyssallib:player_food>`	Returns the player's current food/hunger level.
`abyssallib:player_saturation`	`<placeholder:abyssallib:player_saturation>`	Returns the player's current hidden saturation level.
`abyssallib:player_level`	`<placeholder:abyssallib:player_level>`	Returns the player's current experience level.
`abyssallib:player_x`	`<placeholder:abyssallib:player_x>`	Returns the player's exact X coordinate.
`abyssallib:player_y`	`<placeholder:abyssallib:player_y>`	Returns the player's exact Y coordinate.
`abyssallib:player_z`	`<placeholder:abyssallib:player_z>`	Returns the player's exact Z coordinate.
`abyssallib:server_tps`	`<placeholder:abyssallib:server_tps>`	Returns the server's current 1-minute TPS (Ticks Per Second).
`abyssallib:server_online`	`<placeholder:abyssallib:server_online>`	Returns the current total number of online players.
`abyssallib:server_max_players`	`<placeholder:abyssallib:server_max_players>`	Returns the server's configured maximum player capacity.
`abyssallib:is_sneaking`	`<placeholder:abyssallib:is_sneaking>`	Returns true if the player is currently sneaking.
`abyssallib:is_sprinting`	`<placeholder:abyssallib:is_sprinting>`	Returns true if the player is currently sprinting.
`abyssallib:is_flying`	`<placeholder:abyssallib:is_flying>`	Returns true if the player is currently flying.
`abyssallib:is_op`	`<placeholder:abyssallib:is_op>`	Returns true if the player is a server operator.
`abyssallib:attribute`	`<placeholder:abyssallib:attribute:<id>:[type]:[mod_key]>`	Returns the value of a vanilla entity attribute. `<id>` is required. `[type]` can be "base", "modifier", or omitted (defaults to final value). `[mod_key]` is only required if querying a specific modifier.
`abyssallib:statistic`	`<placeholder:abyssallib:statistic:<id>>`	Returns the integer value of a vanilla server statistic. `<id>` must match the Bukkit Statistic enum exact name.
`abyssallib:custom_attribute`	`<placeholder:abyssallib:custom_attribute:<id>:[type]:[mod_key]>`	Returns the value of a custom AbyssalLib entity attribute. Syntax rules map identically to the vanilla attribute placeholder.
`abyssallib:custom_statistic`	`<placeholder:abyssallib:custom_statistic:<id>>`	Returns the value of a custom AbyssalLib player statistic.

Expression Operators

These placeholders act as mathematical and logical operators. They require a target Expressionable placeholder (such as abyssallib:player_health) to evaluate against.

Where [argument] is specified, it denotes the value you are applying against the target placeholder (e.g., <placeholder:abyssallib:add:abyssallib:player_health:5>).

Operator ID	Syntax	Description
`abyssallib:add`	`<placeholder:abyssallib:add:<target>:<argument>>`	Adds the argument to the target placeholder's value.
`abyssallib:sub`	`<placeholder:abyssallib:sub:<target>:<argument>>`	Subtracts the argument from the target placeholder's value.
`abyssallib:mul`	`<placeholder:abyssallib:mul:<target>:<argument>>`	Multiplies the target placeholder's value by the argument.
`abyssallib:div`	`<placeholder:abyssallib:div:<target>:<argument>>`	Divides the target placeholder's value by the argument.
`abyssallib:mod`	`<placeholder:abyssallib:mod:<target>:<argument>>`	Returns the remainder of dividing the target by the argument.
`abyssallib:pow`	`<placeholder:abyssallib:pow:<target>:<argument>>`	Raises the target placeholder's value to the power of the argument.
`abyssallib:min`	`<placeholder:abyssallib:min:<target>:<argument>>`	Returns the lesser value between the target and the argument.
`abyssallib:max`	`<placeholder:abyssallib:max:<target>:<argument>>`	Returns the greater value between the target and the argument.
`abyssallib:sin`	`<placeholder:abyssallib:sin:<target>>`	Returns the sine of the target placeholder's value.
`abyssallib:cos`	`<placeholder:abyssallib:cos:<target>>`	Returns the cosine of the target placeholder's value.
`abyssallib:tan`	`<placeholder:abyssallib:tan:<target>>`	Returns the tangent of the target placeholder's value.
`abyssallib:asin`	`<placeholder:abyssallib:asin:<target>>`	Returns the arc sine of the target placeholder's value.
`abyssallib:acos`	`<placeholder:abyssallib:acos:<target>>`	Returns the arc cosine of the target placeholder's value.
`abyssallib:atan`	`<placeholder:abyssallib:atan:<target>>`	Returns the arc tangent of the target placeholder's value.
`abyssallib:round`	`<placeholder:abyssallib:round:<target>>`	Rounds the target placeholder's value to the nearest whole number.
`abyssallib:floor`	`<placeholder:abyssallib:floor:<target>>`	Rounds the target placeholder's value down to the nearest whole number.
`abyssallib:ceil`	`<placeholder:abyssallib:ceil:<target>>`	Rounds the target placeholder's value up to the nearest whole number.
`abyssallib:abs`	`<placeholder:abyssallib:abs:<target>>`	Returns the absolute (positive) value of the target placeholder.
`abyssallib:eq`	`<placeholder:abyssallib:eq:<target>:<argument>>`	Returns `true` if the target equals the argument.
`abyssallib:neq`	`<placeholder:abyssallib:neq:<target>:<argument>>`	Returns `true` if the target does not equal the argument.
`abyssallib:gt`	`<placeholder:abyssallib:gt:<target>:<argument>>`	Returns `true` if the target is strictly greater than the argument.
`abyssallib:lt`	`<placeholder:abyssallib:lt:<target>:<argument>>`	Returns `true` if the target is strictly less than the argument.
`abyssallib:gte`	`<placeholder:abyssallib:gte:<target>:<argument>>`	Returns `true` if the target is greater than or equal to the argument.
`abyssallib:lte`	`<placeholder:abyssallib:lte:<target>:<argument>>`	Returns `true` if the target is less than or equal to the argument.
`abyssallib:and`	`<placeholder:abyssallib:and:<target>:<argument>>`	Returns `true` if both the target and the argument evaluate to true.
`abyssallib:or`	`<placeholder:abyssallib:or:<target>:<argument>>`	Returns `true` if either the target or the argument evaluate to true.
`abyssallib:xor`	`<placeholder:abyssallib:xor:<target>:<argument>>`	Returns `true` if exclusively one of the target or argument evaluates to true.
`abyssallib:not`	`<placeholder:abyssallib:not:<target>>`	Inverts the boolean state of the target placeholder.

05 June 2026