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).