Guide - Settings

Settings are divided into multiple categories in this guide. The categories are roles, pings, and utility. Settings are saved on a per-Discord basis, so if you add the bot to multiple servers, you will need to configure the bot on all the different guilds you administrate.

The adminRole (Administrator role) setting is used to control which users have access to certain commands. The Administrators can change settings for you whenever they want.

By default, the setting is set to the @Administrator role. Additionally, any user with the Administrator permission will be detected as an administrator of the bot. This role may not be available within your Discord server. If this is the case, the !settings command will display this setting as being set to "an invalid role". This also means that no user will be assigned the permissions that come with it for safety.

To change this setting to your own role, you can simply use the !settings set adminRole @YourRole command. This will set the Administrator role to the role of your choosing. You can check whether the setting was changed successfully at any time using !settings. If at any point you want to reset a setting to the default role, you are able to use the !settings reset adminRole command for the Administrator role.

The utility settings, specifically language and prefix will allow you to tweak how the bot behaves. The language setting changes the language, and the prefix setting changes the command prefix for that Discord server. For details about the language setting, check out the "Basics" guide, and to change the prefix of the bot within your Discord server, use !settings set prefix ?, where ? is the prefix you want it to have. It can be as or short as you want.

If you want to reset these settings to their defaults, use the !settings reset prefix and !settings reset language to reset the settings back to ! and en respectively.

The settings below can be used to customize the behavior of the bot. It allows you to toggle certain features of the bot on (1) or off (0), depending on your preference. To use these options, select the setting you want to change, then type either 0 or 1. An example would be !settings set forceLanguage 1, which would enable the forceLanguage setting.

Note, available for Premium guilds only.

The events, status, news, and patches settings can be used to ping a certain channel when an event is about to start, when the Rockstar Games Service Status changes, when Rockstar publishes a new article, or when the game is updated and the patch notes are available. This means that you can have a #freeroam-events channel where a message gets posted by the bot 10 minutes before a certain event starts, or a #service-status channel that will be notified when the Rockstar servers are experiencing issues and when those are resolved.

By default, nothing will be pinged, so you'll need to manually change the settings before you'll start receiving pings. To set it up, use the !settings set events command. You can find the different options for all the ping settings in detail below.

If at any point you decide you no longer want to receive pings in a channel, you can use the !settings remove events all #channel or !settings remove status #channel commands for these settings. This will will disable the bot pinging the channels.