Admin commands

Admin commands control how Volvox.Bot behaves on your server. They are restricted to members with an admin role or the Discord Administrator permission (see config.permissions.adminRoleIds), with the exception of /reload which is restricted to bot owners.

Configuration

/config

Views, updates, or resets the bot’s live configuration. Settings are stored in the database and take effect immediately — no restart required. Permission: Admin

config view
config set
config reset

Displays the current bot configuration. Optionally scope the output to a single section.

Option	Type	Required	Description
`section`	String	No	Config section to view (e.g. `moderation`, `reputation`). Supports autocomplete. Omit to see all sections

/config view

/config view section:moderation

The full config can exceed Discord’s embed character limit. If it is truncated, use section to inspect individual sections.

Sets a configuration value at any dot-notation path within the current config. Values are automatically coerced to the appropriate type:

Input	Coerced to
`true` / `false`	Boolean
`null`	null
Numeric strings	Number
`"text"` (quoted)	String

Option	Type	Required	Description
`path`	String	Yes	Dot-notation config path (e.g. `ai.enabled`, `moderation.warnings.expiryDays`). Supports autocomplete
`value`	String	Yes	New value. Use `"text"` for literal strings, `true`/`false` for booleans

/config set path:afk.enabled value:true

Paths must exist in the current config. You cannot create new top-level sections via this command. Use the dashboard to manage complex nested structures.

Clears guild-level overrides and reverts to the global defaults in config.json. You can reset a single section or reset everything.

Option	Type	Required	Description
`section`	String	No	Section to reset (e.g. `reputation`). Supports autocomplete. Omit to reset all guild overrides

/config reset section:reputation

/config reset

Common config paths

Moderation

Path	Type	Description
`moderation.enabled`	Boolean	Enable/disable the moderation system
`moderation.dmNotifications.warn`	Boolean	DM users when warned
`moderation.dmNotifications.ban`	Boolean	DM users when banned
`moderation.warnings.expiryDays`	Number	Days before warnings auto-expire (default: 90)
`moderation.warnings.severityPoints.low`	Number	Points for a low severity warning (default: 1)
`moderation.warnings.severityPoints.medium`	Number	Points for a medium severity warning (default: 2)
`moderation.warnings.severityPoints.high`	Number	Points for a high severity warning (default: 3)
`moderation.escalation.enabled`	Boolean	Enable automatic escalation on warning thresholds

Reputation and engagement

Path	Type	Description
`reputation.enabled`	Boolean	Enable the XP/level system
`reputation.xpPerMessage`	Array	`[min, max]` XP range per message (default: `[5, 15]`)
`reputation.xpCooldownSeconds`	Number	Seconds between XP grants per user (default: 60)
`engagement.enabled`	Boolean	Enable engagement tracking (profile stats)

Community features

Path	Type	Description
`afk.enabled`	Boolean	Enable the AFK system
`reminders.enabled`	Boolean	Enable the reminders system
`reminders.maxPerUser`	Number	Max active reminders per user (default: 25)
`tldr.enabled`	Boolean	Enable the /tldr AI summarizer
`tldr.cooldownSeconds`	Number	Per-channel cooldown in seconds (default: 300)
`tldr.defaultMessages`	Number	Messages to summarize when `count` is omitted (default: 50)

Permissions

Path	Type	Description
`permissions.adminRoleIds`	Array	Role IDs granted admin-level command access
`permissions.moderatorRoleIds`	Array	Role IDs granted moderator-level command access
`permissions.botOwners`	Array	User IDs that bypass all permission checks

Command aliases

/alias

Creates, lists, or removes custom command aliases for the server. Aliases are registered with Discord immediately and work exactly like the original command. Permission: Admin

Create an alias

Use /alias add to map a short name to an existing command:

Option	Type	Required	Description
`alias`	String	Yes	The alias name to create (lowercase, letters/numbers/hyphens/underscores, 1–32 chars)
`command`	String	Yes	The existing bot command to alias (e.g. `warn`, `ban`)

/alias add alias:w command:warn

/alias add alias:lb command:leaderboard

List aliases

View all active aliases for this server:

/alias list

Remove an alias

Delete an alias by name:

Option	Type	Required	Description
`alias`	String	Yes	The alias name to remove

/alias remove alias:w

You cannot use a built-in command name as an alias, and you cannot alias the /alias command itself.

Bot management

/reload

Reloads the bot’s config, command definitions, slash command registrations, triage system, and opt-outs — all at runtime without a full restart. Runs five steps in sequence and reports success or failure for each. Permission: Bot owner only

Although /reload has adminOnly: true in its definition, a stricter bot owner check runs inside the command handler. Admin role members who are not listed in config.permissions.botOwners will be denied.

This command takes no options.

/reload

The response embed shows the result of each reload step:

Step	What it does
Config	Reloads configuration from the database
Commands	Clears and re-imports all command files from disk
Register	Re-registers all slash commands with Discord
Triage	Restarts the AI triage engine
Opt-outs	Reloads the user opt-out list

/status

Displays bot health metrics. In basic mode it is available to everyone; passing detailed:true shows extended diagnostics and requires the Discord Administrator permission. Permission: Everyone (detailed mode: Admin)

Options

Option	Type	Required	Description
`detailed`	Boolean	No	Show extended diagnostics (Admin only). Defaults to `false`

Basic mode output

Uptime — how long the bot has been running
Memory — current memory usage
API status — Discord API connection state
Last AI request — relative time since the last AI call

Detailed mode output (admin only)

Everything in basic mode, plus:

Process ID
Platform and Node.js version
Heap used, RSS, external memory, and array buffer memory
Process-level uptime

Examples

/status

/status detailed:true

Get Started

Configuration

Features

Dashboard

Commands

Self-Hosting

Configuration

/config

Common config paths

Command aliases

/alias

Bot management

/reload

/status

Build docs developers (and LLMs) love

Get Started

Configuration

Features

Dashboard

Commands

Self-Hosting

​Configuration

​/config

​Common config paths

​Command aliases

​/alias

​Bot management

​/reload

​/status

Build docs developers (and LLMs) love

Configuration

/config

Common config paths

Command aliases

/alias

Bot management

/reload

/status