Configuration

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

Alerts are informational Ralsei boxes that appear under certain conditions. There are a total of 4 alert channels: no-access, blocked, unknown, and lewd.

• no-access alerts appear if the given user doesn't have access to a command, as specified in your permissions configuration.
• blocked alerts appear if the given command is the server's command blocklist.
• unknown alerts appear if a message was sent with the correct prefix but with an unknown command.
• lewd alerts appear if Ralsei's name is placed in the vicinity of a lewd word.

You have can use enable or disable to enable/disable specific alerts, or enableall or disableall to enable/disable all alerts.

Allow Autodeletion

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 on/off property.

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.

Blocklist

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.

• add removes a command from the list.
• remove removes a command from the list.
• clear clears your block list.
• list lists 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

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.

• list will list all set permissions.
• set will set the required permissions for a given command.
• unset will unset the required permissions for a given command, essentially restoring it to default.
• reset will 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

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.

Prefix

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.

Quick Responses

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.

• list lists all quick responses.
• clear will clear all set quick responses.
• add will add a quick response to the list.
• edit will edit an existing quick response.
• remove will remove a quick response.