🧩 Placeholders — Complete Reference
NxMenu has its own built-in placeholders plus full PlaceholderAPI integration. You can use placeholders in:
- Menu Title
- Item Name and Lore
- Item Amount
- Action arguments (commands, messages)
- Conditions (require, state)
Built-in Player Placeholders
| Placeholder | Returns |
|---|---|
%player% / %player_name% | The viewer's username |
%player_level% | XP level (integer) |
%player_health% | Current HP, rounded to integer |
%player_ping% | Network latency in ms |
%player_empty_slots% | Number of free inventory slots (0–36) |
Boolean/Permission Placeholders
| Placeholder | Returns |
|---|---|
%isonline_<name>% | true or false |
%hasperm_<node>% | yes or no |
Example: %hasperm_essentials.fly% returns yes or no.
Custom Variables (Meta System)
| Placeholder | Returns |
|---|---|
%nxmenu_meta_<key>% | Your custom variable's value (defaults to 0 if unset) |
Command Argument Placeholders
| Placeholder | Returns |
|---|---|
%args_count% | Total number of args passed to the menu command |
%arg1%, %arg2%, ... | Specific argument by position |
%args% | All args joined by spaces |
If no args are passed, %arg1% defaults to the player's own name. This means a self-profile menu works whether the player runs /profile or /profile Notch.
🔥 Target Placeholders (Advanced)
This is one of NxMenu's most powerful features. You can resolve any placeholder against a different player using the colon-target syntax.
Syntax:
<target>:<placeholder>
Where <target> can be:
- A literal username (e.g.
Notch:%vault_eco_balance%) - An arg placeholder (e.g.
%arg1%:%player_level%)
Use Case: Player Profile Menu
You build a /whois <player> menu. The viewer runs /whois Notch. In the menu:
- Item Name:
&b%arg1%'s Profile→ "Notch's Profile" - Lore line 1:
&7Money: &a$%arg1%:%vault_eco_balance%→ Notch's actual balance - Lore line 2:
&7Level: &e%arg1%:%player_level%→ Notch's actual level - Lore line 3:
&7Online: &a%isonline_%arg1%%→ "true" if Notch is online - Material:
HEAD-%arg1%→ Notch's actual skull
One menu config now works for any player.
Special Placeholders
| Placeholder | Context |
|---|---|
%input% | Player's chat response after a [input] action |
%time% | Formatted remaining cooldown (used in [cooldown] deny msg) |
PlaceholderAPI
If PlaceholderAPI is installed on your server, any PAPI placeholder works automatically. Examples:
%vault_eco_balance%— Vault economy balance- Anything from any expansion you've installed.