Cmdibuzz Arguments & Placeholders

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)
• word stops at whitespace, string accepts one quoted or unquoted string, and greedy consumes the rest of the command line.
• Optional arguments allow the command to execute without that argument. Use %target_provided% to check whether an optional player argument was supplied.

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
%target_provided%	true when an optional player argument was supplied; otherwise false

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