Skip to content

@config

Commands for viewing and managing bot configuration settings. Settings follow a channel → network → global → code default hierarchy.

@config get <key>

Permission: PLAY

Show the current value of a single setting along with its scope indicator (C=channel, N=network, G=global) and the resolved value at each level.

Example: @config get game.hintDelay

@config set <key> <value>

Permission: MODERATE (admin-only settings require ADMIN)

Set a configuration value at channel scope. Boolean values accept true/false, yes/no, 1/0, on/off (case-insensitive). Admin-only settings (scoring.timezone, permissions.*, debug.verbose) require ADMIN permission.

Example: @config set game.hintDelay 20 or @config set scoring.minPoints 25

@config reset <key>

Permission: MODERATE

Remove the channel or network-level override for a setting, causing it to fall back to the next level in the hierarchy (channel → network → global → code default).

Example: @config reset game.hintDelay

@config export

Permission: MODERATE

Export the current channel/network settings as a compact JSON string. If the output exceeds 400 characters it is sent as a private notice to avoid flooding the channel.

Example: @config export

@config import <json>

Permission: ADMIN

Import settings from a JSON string previously exported with @config export. All settings are validated before any changes are applied; invalid settings block the entire import.

Example: @config import {"game.hintDelay":"20","game.questionTimeout":"90"}

@config list [namespace]

Permission: PLAY

List all settings with their current values and scope indicators. Optionally filter by namespace: game, scoring, kaos, scramble, permissions, debug.

Example: @config list or @config list scoring

@config set-default <key> <value>

Permission: ADMIN

Set the global default value for a setting. Affects all networks and channels that do not have an explicit override. Does not overwrite existing network or channel overrides.

Example: @config set-default game.questionDelay 15