Bot Commands
This content is for v1.0.0. Switch to the latest version for up-to-date documentation.
The bot_commands plugin provides user management, channel manipulation, messaging, and search utilities. It is the primary interface for server administration and user interaction through the bot.
Commands
Section titled “Commands”| Command | Description | Roles | Aliases |
|---|---|---|---|
echo <message> |
Echo a message in chat | user | — |
msg <user> <message> |
Private message a user anonymously | user | — |
kickuser <user> <reason> |
Kick a user from the server | admin | — |
banuser <user> <reason> |
Ban a user from the server | admin | — |
muteuser <user> |
Mute a user | admin | — |
unmuteuser <user> |
Unmute a user | admin | — |
deafenuser <user> |
Deafen a user | admin | — |
undeafenuser <user> |
Undeafen a user | admin | — |
log <message> |
Manually log a message | admin | — |
showplugins |
Display all loaded plugins | moderator | — |
aliassearch <query> |
Search for an alias | user | — |
cmdsearch <query> |
Search for a command | user | — |
move <channel> |
Move bot to a channel | user | — |
makechannel <name> |
Create a temporary channel | admin | — |
makepermanentchannel <name> |
Create a permanent channel | admin | — |
leave |
Return to the default channel | user | — |
removechannel <name> |
Remove a channel | admin | — |
renamechannel <old> <new> |
Rename a channel | admin | — |
joinme |
Join the caller’s channel | user | — |
joinuser <user> |
Join a user’s channel | user | — |
moveuser <user> <channel> |
Move a user to a channel | admin | — |
role add <user> <role> |
Grant a role to a user | admin | — |
role remove <user> <role> |
Revoke a role from a user | admin | — |
role list <user> |
List a user’s assigned roles | admin | — |
roles |
Display all defined roles | admin | — |
- Messaging:
msgsends an anonymous private message — the recipient will not see the sender’s identity. - Channel management: Temporary channels created with
makechannelare removed when the bot restarts. Usemakepermanentchannelfor persistent channels. - Role management: The
rolecommand supports three sub-commands:addto grant a role,removeto revoke a role, andlistto show a user’s current roles.roleslists all roles defined in the configuration. - Search:
aliassearchandcmdsearchperform case-insensitive substring matching across all registered aliases and commands. - Roles: Commands gated to
adminrequire theadminrole.moderatorcommands requiremoderatoror higher. Commands with no role restriction are available to all non-blacklisted users.