Cmdibuzz Economy & Cooldowns

Economy

Provider Options

Set economy.provider in config.json:

| Value | Description | |---|---| | "none" | Economy disabled. Money costs are silently ignored. | | "impactor" | Uses Impactor as the economy backend. | | "mock" | Built-in SQLite-backed economy for testing. |

Money Costs

Set cost_money on any command:

{
  "id": "fly",
  "command": "fly",
  "cost_money": 50.0,
  "runcmd": ["run_command: /fly"]
}

Item Costs

{
  "id": "rankup",
  "command": "rankup",
  "cost_items": [
    { "material": "minecraft:emerald", "amount": 32 },
    { "material": "minecraft:diamond", "amount": 16 }
  ],
  "runcmd": [
    "text: <green>You ranked up!",
    "run_console: /lp user %player_name% group set vip"
  ]
}

Items are checked and consumed from the player's entire inventory (including hotbar).

Display Name Filtering

Filter item costs by custom display name:

{
  "cost_items": [
    { "material": "minecraft:paper", "amount": 1, "display_name": "<green>Token of Thanks" }
  ]
}

Only items whose CUSTOM_NAME matches are counted and consumed.

Cooldowns

Set cooldown_seconds on any command to prevent spam:

{
  "id": "heal",
  "command": "heal",
  "cooldown_seconds": 120,
  "runcmd": ["run_command: /effect give %player_name% minecraft:instant_health 1 1"]
}

• Cooldowns are per-player, per-command-ID
• Persisted to SQLite — survive disconnects and restarts
• Remaining time is shown in the error message
• Admins can clear cooldowns with /cmdibuzz cooldown clear <player>

One-Time Use

Set "onetime_use": true to allow each player to use a command only once ever:

{
  "id": "kit_starter",
  "command": "kit starter",
  "onetime_use": true,
  "runcmd": [
    "text: <green>You received the starter kit!",
    "give_item: minecraft:stone_sword 1",
    "give_item: minecraft:bread 16"
  ]
}

• Stored in SQLite — persists across restarts
• Players with cmdibuzz.bypass.onetimeuse permission (or OP level 4) bypass the restriction

Item-Attached Commands

Attach a command directly to an item using /cmdibuzz attachcmd:

1. Hold the item in your main hand
2. Run: /cmdibuzz attachcmd /summon fireball ~ ~1 ~ {Motion:[0.0,0.0,1.0]} cooldown:60 onetimeuse:false
3. Right-click with the item to execute the attached command

Flags (parsed from the end of the string):

• cooldown:<seconds> — per-player cooldown
• onetimeuse:<true/false> — whether the item can only be used once

The command is executed using execute at <player> run, so relative coordinates (~) resolve at the player's position. The command and flags are stored in the item's NBT data.