Cmdibuzz Arguments & Placeholders
Defining command arguments and using placeholders in actions
Updated July 21, 2026
Command Arguments
Define arguments in the command using <name> syntax in the command string:
{
"command": "giveitem <player> <item> <amount>",
"arguments": [
{ "name": "player", "type": "player" },
{ "name": "item", "type": "string" },
{ "name": "amount", "type": "integer", "optional": true }
],
"runcmd": [
"run_command: /give $arg1 $arg2 $arg3"
]
}
- Use
$arg1,$arg2, etc. to reference arguments by position - Use
$<name>to reference by name (e.g.,$player,$item)
Argument Types
| Type | Description |
|---|---|
| word | A single word (no spaces) |
| string | A single word or quoted string |
| greedy | All remaining arguments (for messages, etc.) |
| integer / int | Whole numbers |
| float / double | Decimal numbers |
| player | Player name (with tab completion) |
Placeholders
Available in any action string:
Player Placeholders
| Placeholder | Description |
|---|---|
| %player_name% | The player's username |
| %player_uuid% | The player's UUID |
| %player_world% | The player's current world |
| %player_x%, %player_y%, %player_z% | The player's coordinates |
| %player_health% | Current health |
| %player_food% | Food level |
| %player_ping% | Latency in ms |
| %player_gamemode% | Current gamemode |
| %player_level% | XP level |
Shortcut Syntax
| Shortcut | Equivalent |
|---|---|
| $player.name | %player_name% |
| $player.uuid | %player_uuid% |
| $player.gamemode | %player_gamemode% |
| $player.x, $player.y, $player.z | Coordinates |
| $player.health | %player_health% |
| $player.food | %player_food% |
| $player.ping | %player_ping% |
| $player.level | %player_level% |
| $player.world | %player_world% |
Server Placeholders
| Placeholder | Description |
|---|---|
| %server_online% | Current player count |
| %server_max_players% | Max player slots |
| %server_time% | Current time (HH:mm:ss) |
| %server_date% | Current date (yyyy-MM-dd) |
| %online_players% | Comma-separated list of online players |
| %random% | Random number 0–99 |
Custom Variables
| Placeholder | Description |
|---|---|
| %PlayerData%$<varname> | Value of a custom variable for the executing player |
Event-Specific Placeholders
When a command is triggered by an event, additional placeholders are available (see Event Triggers).