Cmdibuzz Action Types

Overview

Each entry in runcmd (or the type field itself) uses one of these action formats.

The type field is only the fallback action when runcmd is absent. Actions such as roulette:, particle:, clear_title:, and toggle_fly: should be written in runcmd.

Available Actions

Action	Format	Description
`text:`	`text: Hello <green>$player_name`	Sends a message to the command executor
`broadcast_text:`	`broadcast_text: $player_name just did something!`	Broadcasts to all players
`run_command:`	`run_command: /say Hi`	Executes as the player
`run_console:`	`run_console: /ban $player_name`	Executes as the server console
`teleport:`	`teleport: 100 64 -200`	Teleports the player to coordinates
`actionbar:`	`actionbar: <yellow>Welcome!`	Sends an action bar message
`title:`	`title: 10 70 20 <gold>Hello`	Shows a title (fadeIn stay fadeOut text)
`title: subtitle:`	`title: 10 70 20 subtitle:<gray>Welcome`	Shows a subtitle
`clear_title:`	`clear_title:`	Clears any displayed title
`sound:`	`sound: minecraft:entity.experience_orb.pickup 1.0 1.0`	Plays a sound (sound, volume, pitch)
`bossbar:`	See below	Manages boss bars
`give_item:`	`give_item: minecraft:diamond 5`	Gives items to the player
`take_item:`	`take_item: minecraft:stick 1`	Removes items from inventory
`particle:`	`particle: minecraft:happy_villager 10 0.3`	Spawns particles (id, count, speed)
`roulette:`	`roulette:`	Picks a random weighted command from `roulette_commands`
`toggle_fly:`	`toggle_fly:`	Toggles the player's flight mode
`delay:`	`delay: 20`	Waits N ticks before the next action

Player-Only Actions

Actions that require a player context (teleport:, actionbar:, title:, clear_title:, bossbar:, sound:, give_item:, take_item:, particle:, toggle_fly:) will fail with an error if run from the server console.

BossBar Sub-actions

bossbar: <id> create <name> [color] [style]
bossbar: <id> remove
bossbar: <id> name <new_name>
bossbar: <id> progress <0-100>
bossbar: <id> color <COLOR>
bossbar: <id> style <STYLE>
bossbar: <id> show           # Show to the executing player
bossbar: <id> hide           # Hide from the executing player
bossbar: <id> showall
bossbar: <id> hideall

Colors: BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW

Styles: PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, NOTCHED_20

Roulette — Weighted Random Commands

The roulette action picks one command from a weighted list and runs it via the console. Each entry's weight represents its share of the total chance. Cmdibuzz adds all positive weights, then calculates each entry's probability as:

entry probability = entry weight / total positive weight

Weights do not need to add up to 100. For example, weights of 30, 20, and 60 have a total of 110, resulting in probabilities of approximately 27.27%, 18.18%, and 54.55%. Multiplying every weight by the same number does not change the odds. Entries with weight 0 or less are skipped.

{
  "id": "birthday",
  "command": "birthday",
  "cooldown_seconds": 86400,
  "roulette_commands": [
    { "command": "say Happy Birthday %player_name%!", "weight": 50 },
    { "command": "give %player_name% minecraft:cake 1", "weight": 40 },
    { "command": "give %player_name% minecraft:diamond 1", "weight": 10 }
  ],
  "runcmd": [
    "text: <gold>✨ Spinning the birthday wheel...",
    "delay: 20",
    "roulette:",
    "text: <green>Enjoy your surprise!"
  ]
}

To use it, add a roulette_commands array to your command definition and place roulette: in the runcmd chain. Without the roulette: action, the entries are never selected. The picked command supports all standard placeholders plus {player} as a convenience alias for the player name. For a command with a target argument, use $target in the entry and invoke the command with that argument, for example /birthday <player>. Roulette entries are console commands, so use Minecraft command syntax such as give or tell; action strings such as give_item: and text: are not valid roulette entries.

The picked command supports all standard placeholders plus {player} as a convenience alias for the player name. For a target argument, use $target in the roulette entry and invoke the command with that argument.

bossbar: <id> create reads the name as one token. Use underscores for spaces, or create a short name and then use the name sub-action. A newly created bar must be shown with show or showall before players can see it. There is no update sub-action; update name, progress, color, and style separately.