Cmdibuzz Configuration

config.json Structure

The main configuration file controls global settings, economy, and database options.

{
  "general": {
    "debug": false,
    "prefix": "<gold>[Cmdibuzz]<reset>",
    "default_permission": true,
    "text_format": "legacy"
  },
  "economy": {
    "provider": "none",
    "initial_balance": 100.0,
    "currency_name": "coin",
    "currency_name_plural": "coins"
  },
  "database": {
    "type": "sqlite",
    "host": "localhost",
    "port": 3306,
    "database": "cmdibuzz",
    "username": "",
    "password": ""
  }
}

General Settings

Field	Description
debug	Enables verbose logging
prefix	Prefix shown before mod messages (supports MiniMessage)
default_permission	Whether commands without a permission field are allowed by default
text_format	"legacy" (default) supports & color codes. "minimessage" supports tags like <red>, gradients, hex colors, and converted legacy codes.

Economy Settings

Field	Description
provider	"none" (disabled), "impactor" (requires Impactor mod), or "mock" (built-in SQLite)
initial_balance	Starting balance for new players (mock economy)
currency_name	Singular currency name
currency_name_plural	Plural currency name

Database Settings

Field	Description
type	"sqlite" (default, no setup needed) or "mysql"
host	MySQL host (only for MySQL)
port	MySQL port
database	Database name
username	MySQL username
password	MySQL password

Reloading

After making changes to the config, run:

/cmdibuzz reload

This reloads all command files and re-registers commands without restarting the server. It does not reset SQLite balances, cooldowns, one-time-use records, or PlayerData values.

Command File Rules

• Use valid JSON: double quotes are required, comments are not allowed, and trailing commas are not allowed.
• Put one command object in each file under commands/; arrays of command objects are not supported.
• Commands can be stored in subfolders. The filename without .json becomes the command ID when id is omitted.
• Event commands must have register: true (the default) to run. If command is omitted or empty, Cmdibuzz falls back to the command id.
• A command with register: false is ignored by both command registration and event dispatch.

If runcmd is omitted, null, or empty, the type field runs using the value of command. Always provide runcmd for multi-action and roulette commands.