The Ralsei Bot can be configured in order to fit your server needs, and also to make life with the bot a bit easier.
Please note that configuration-modifying commands will only work in servers and not in direct messages.
Alerts are informational Ralsei boxes that appear under certain conditions. There are a total of 4 alert channels:
no-accessalerts appear if the given user doesn't have access to a command, as specified in your permissions configuration.
blockedalerts appear if the given command is the server's command blocklist.
unknownalerts appear if a message was sent with the correct prefix but with an unknown command.
lewdalerts appear if Ralsei's name is placed in the vicinity of a lewd word.
You have can use
disable to enable/disable specific alerts, or
disableall to enable/disable all alerts.
Autodeletion allows a command to be deleted as soon as it is sent. If you run a roleplay server, you most likely want this to be on. This is a simple
Since autodeletion has its downsides (e.g. someone could send profane words through the bot), you might want to limit autodeletion to specific users. You can do that using the permissions system.
Block specific commands from running. Use this if you don't want any user to run a given command. If you want to restrict commands to specific users or roles, consider using the permissions system instead.
addremoves a command from the list.
removeremoves a command from the list.
clearclears your block list.
listlists all commads in the block list.
There is only one unblockable command: the configuration command. Attempting to block it will result in an error.
Permissions restrict certain actions to specific roles, users, or permissions only. This allows you to limit the amount of users using a certain command, or give them specific capabilities based on each command.
listwill list all set permissions.
setwill set the required permissions for a given command.
unsetwill unset the required permissions for a given command, essentially restoring it to default.
resetwill reset all required permissions to the defaults.
A comprehensive tutorial on how to write permissions can be found in the tutorials under "Tutorials / Permissions".
Meta configuration commands aren't really used to configure your configuration, but are instead used in order to export and import the configuration of your server.
To export your configuration, simply run
!ralsei cfg meta export. To import an existing configuration, run
!ralsei cfg meta import with the configuration file sent to you attached.
Imports are hard-locked at 16 kB. If your configuration seem to exceed that, consider removing some quick responses first or ask for help from the support server.
The prefix is what you use to call for the bot. The prefix needs to go before any command for the bot to recognize it as a valid command.
To change the prefix, you have to send
!ralsei cfg prefix <new prefix> <with spaces?>.
<with spaces?> determines whether or not a space should appear after the prefix. Prefixes are limited to 14 characters, but it's not like you'll get to use up all of that.
Used to be called "quicksays", quick responses can be used to create custom commands. They work exactly like
!ralsei say, so using them is straightforward if you know how to make boxes.
listlists all quick responses.
clearwill clear all set quick responses.
addwill add a quick response to the list.
editwill edit an existing quick response.
removewill remove a quick response.