Design
Placeholders
Built-in values, PlaceholderAPI and how unresolved values behave.
A placeholder is a token between percent signs. Use placeholders in text, bar values, player head sources, item materials and conditions.
Built in
| Placeholder | Value |
|---|---|
%player_name% | Player name |
%player_health%, %player_max_health% | Health and maximum health |
%player_food%, %player_armor% | Food level and armor points |
%player_level%, %player_exp_progress% | Level and progress from 0 to 1 |
%player_ping% | Latency in milliseconds |
%player_world%, %player_biome% | World name and biome |
%player_x%, %player_y%, %player_z% | Block coordinates |
%player_yaw%, %player_direction% | Compass heading in degrees (0 is north) and its name |
%player_cps% | Arm swings in the last second |
%player_effects% | Up to two active effects with remaining time |
%player_in_combat% | true for a configurable time after dealing or taking damage from an entity |
%player_gamemode% | Game mode |
%player_cooldown% | Cooldown of the held item in seconds |
%player_item_in_hand%, %player_armor_helmet% and the other armor slots | Item key, or air |
%server_name% | server-name from the plugin configuration |
%server_online%, %server_max_players% | Player counts |
%server_tps% | Ticks per second, one-minute average |
%server_time%, %server_date% | Server clock and date |
PlaceholderAPI
When PlaceholderAPI is installed, any token that is not built in is passed to it. Results are cached per player for hud.placeholder-cache-ticks. PlaceholderAPI is called on the server thread, as its expansions expect; composing the HUD happens on a separate thread.
Unresolved values
A token nobody resolves is an empty string in game. In a condition it compares equal to "". The editor shows unresolved tokens as written so you can spot them.