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 the hotbar. If any required item is unavailable, the command is cancelled and nothing is consumed.

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. MiniMessage color codes are rendered automatically. Omit display_name to match by material only.

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.

Storage Notes

SQLite is bundled and stores data in <world>/cmdibuzz.db. MySQL support requires a MySQL JDBC driver to be available to the server; it is not bundled by the default build.