🔤 Placeholders
Type %something% and it magically becomes real data. Works in aliases, events, scoreboards, cooldown messages — everywhere.
New in v4.0 — No config file needed. Just use
%placeholders% anywhere.
How They Work
Remember ${player} and ${x}? These are like those, but they give you a lot more info. Same vibe, but with % instead of ${}.
// Old school
say Hello ${player}!
// New hotness
say %player% has %player_health% HP and is level %player_xp_level%
The Full List
| Placeholder | What you get | Example output |
|---|---|---|
%player% | Player name | Steve |
%player_uuid% | Player UUID | a1b2c3d4-... |
%player_health% | Current HP | 18.5 |
%player_max_health% | Max HP | 20.0 |
%player_xp% | Total XP points | 247 |
%player_xp_level% | XP level | 12 |
%player_food% | Hunger bar (0-20) | 16 |
%player_world% | Dimension they're in | minecraft:overworld |
%player_gamemode% | Game mode | survival |
%player_ping% | Connection latency | 42 |
%server_online% | Players online | 8 |
%server_max% | Max slots | 20 |
%server_tps% | Server TPS | 20.0 |
%var_name% | Custom variable | Whatever you set |
%cooldown_alias% | Cooldown remaining | 12 |
They Work Everywhere
- Alias commands —
"status": "say %player% is at %player_health% HP" - Event triggers —
"say %player% joined from %player_world%" - Scoreboard lines — automatically update with live data
- Cooldown messages —
"&c%cooldown_home%s until you can /home again"
For Developers
Got a mod that wants to add its own placeholders? Easy:
PlaceholderManager.registerCustomPlaceholder("myplugin_balance", ctx -> {
return String.valueOf(getBalance(ctx.player));
});
Placeholder API Integration (Fabric)
Command Maker now integrates with Patbox's Placeholder API mod. If you have it installed:
- Our placeholders become available to other mods — other Fabric mods that use Placeholder API can see
%cmdmaker:player_health%,%cmdmaker:server_online%, etc. - Other mods' placeholders work in your aliases — any placeholder registered with Placeholder API can be used in Command Maker commands, events, and scoreboards.
The integration is optional — Command Maker works fine without it. If Placeholder API is installed, we automatically hook into it.
🔮 Coming to Paper/Bukkit: On the Paper version, we'll bridge to real PlaceholderAPI. Same placeholder names, same syntax — all your PAPI placeholders from other plugins will just work in Command Maker aliases.