Appearance
Placeholders Reference
Placeholders are dynamic values that get replaced at runtime. Use them in any input field that shows the {} icon.
Syntax
Wrap placeholder names in percent signs: %placeholder_name%
Universal Placeholders
These are available in all flows regardless of trigger type.
Player
| Placeholder | Description |
|---|---|
%player% | Player username |
%player_uuid% | Player UUID |
%player_displayname% | Display name |
%player_ip% | Player IP address |
%player_prefix% | Player prefix (Text before username) |
%player_suffix% | Player suffix (Text after username) |
%player_group% | Permission group name |
Location
| Placeholder | Description |
|---|---|
%world% | Current world name |
%x% | X position |
%y% | Y position |
%z% | Z position |
%yaw% | Yaw rotation (Angle of "left or right") |
%pitch% | Pitch rotation (Angle of "up or down") |
%biome% | Current biome |
Player Stats
| Placeholder | Description |
|---|---|
%health% | Current health (0–20) |
%max_health% | Maximum health |
%food% | Food/hunger level (0–20) |
%level% | XP level |
%exp% | Raw XP points |
%gamemode% | Current gamemode |
%ping% | Player ping (ms) |
Server
| Placeholder | Description |
|---|---|
%online% | Number of online players |
%max_players% | Max player slots |
%server_name% | Server name |
%tps% | Server TPS (ticks per second) |
%time% | World time (ticks) |
Context-Specific Placeholders
These are only available when using specific trigger types.
Command Placeholders
Available when using a Command Trigger:
| Placeholder | Description |
|---|---|
%command% | The command name |
%command_label% | The exact command label used |
%args% | All arguments as a string |
%args_count% | Number of arguments |
%arg_1% | First argument |
%arg_2% | Second argument |
%arg_3% | Third argument |
%arg_4% | Fourth argument |
%arg_5% | Fifth argument |
%subcommand% | Synonym for %arg_1% |
How Arguments Work
- Commands are split based on
(space), each chunk becomes an argument. - Example: command "/teleport to player TheVoidNexus"
| Placeholder | Value |
|---|---|
%arg_1% | "to" |
%arg_2% | "player" |
%arg_3% | "TheVoidNexus" |
Event Placeholders
Available when using an Event Trigger:
| Placeholder | Description |
|---|---|
%event% | Event name |
%event_cancelled% | Whether the event is cancelled (true/false) |
Block Placeholders
Available for block events (block_break, block_place, sign_change):
| Placeholder | Description |
|---|---|
%block_type% | Block type/material |
%block_x% | Block X coordinate |
%block_y% | Block Y coordinate |
%block_z% | Block Z coordinate |
Item Placeholders
Available for item events (item_pickup, item_drop, item_craft, item_consume, item_enchant):
| Placeholder | Description |
|---|---|
%item% | Item type/material |
%item_name% | Item display name |
%item_amount% | Stack amount |
Damage Placeholders
Available for damage events (player_damage, player_damage_entity, player_death):
| Placeholder | Description |
|---|---|
%damage% | Damage amount |
%damage_cause% | Damage cause |
%attacker% | Attacker name |
Chat Placeholders
Available for the player_chat event:
| Placeholder | Description |
|---|---|
%message% | Full chat message |
%message_stripped% | Message without color codes |
Custom Placeholders
Variables created with the Set Variable node are accessible as placeholders using their name:
%my_variable%This allows you to store data and use it later in any placeholder-supported field.
Custom placeholders can be created with different scopes:
- Local: Only available within the current function or flow and will be deleted after execution.
- Global: Available across all flows and functions.
- Player: Tied to a specific player, accessible only when a player context exists.