Core Commands
This content is for v1.0.0. Switch to the latest version for up-to-date documentation.
The core_commands plugin provides essential bot lifecycle management, help system, alias registration, and command history. These commands are always loaded and form the backbone of bot administration.
Commands
Section titled “Commands”| Command | Description | Roles | Aliases |
|---|---|---|---|
stopplugin <name> |
Stop a running plugin | admin | — |
startplugin <name> |
Start a stopped plugin | admin | — |
restartplugin <name> |
Restart a plugin | admin | — |
restartplugins |
Restart all plugins | admin | — |
sleep <seconds> |
Sleep the command thread | user | — |
version |
Show bot version | user | — |
about |
Show bot information | user | — |
uptime |
Show bot uptime | user | — |
exit |
Shut down the bot | admin | quit |
restart |
Restart the bot | admin | — |
saferestart |
Restart in safe mode | admin | — |
setcomment <text> |
Set the bot’s user comment | admin | — |
resetcomment |
Reset the bot’s user comment | admin | — |
pguistresstest [lines] |
PGUI stress test | admin | — |
help [plugin] |
List plugins, or list a plugin’s commands | user | — |
refreshaliases |
Refresh aliases (auto-persisted, rarely needed) | admin | — |
importaliases <url> |
Import aliases from a CSV URL | admin | — |
setalias <name> <command> |
Register an alias | admin | — |
aliases |
List registered aliases | user | — |
removealias <name> |
Remove an alias | admin | — |
clearaliases |
Clear all aliases | admin | — |
clearhistory |
Clear command history | moderator | — |
history |
Show command history | moderator | — |
- Plugin management:
stopplugin,startplugin, andrestartpluginoperate on individual plugins by name.restartpluginsrestarts all loaded plugins at once. - Lifecycle:
exitshuts down the bot gracefully.restartrestarts it normally.saferestartrestarts with only the plugins listed insafe_mode_pluginsfrom the config. - Help:
helpwith no arguments lists all loaded plugins.help <plugin>lists all commands registered by that plugin. - Aliases: Aliases are automatically persisted to the database.
refreshaliasesforces a reload from the database and is rarely needed.importaliasesaccepts a URL pointing to a CSV file with alias definitions. - History:
historydisplays recent command usage.clearhistorywipes the history buffer. Both are gated tomoderator. - Roles:
admincommands require theadminrole.moderatorcommands requiremoderatoror higher. Commands with no role restriction are available to all non-blacklisted users.