Configuration

Server Role

When you add AwesomeBot to a server, we recommend that you give it a role with the following basic permissions:

• Read Messages so he can recognize commands
• Send Messages for responses to commands
• Embed Links to fetch info from around the web

There are also a few extra permissions for additional functionality:

• Read Message History to use the archive and clean options in the admin console
• Kick Members for automatic spam and NSFW regulation (if enabled)
• Manage Roles to assign custom roles and colors to users

Here's an example of the recommended permission set for AwesomeBot:

Admin Console

The AwesomeBot admin console allows you to configure the bot's settings for usage on any server where you are one of his admins. By default, anyone with permission to ban users is added as an admin. To access the configuration page, use the command config <server name>.

In this section, we'll examine each section of the admin console and explain how to use it.

Header

The header is pretty simple; it shows how long ago the bot was added to the server and gives you an option to remove the bot from the server.

Bot Admins

Here you can add/remove bot admins (you can't remove yourself or the server owner). Admins can configure the bot on the server, clear stats, close polls/trivia games, and use the strikes system.

Blocked Members

Users who are on the blocked list cannot interact with AwesomeBot at all on the server. This is a great way to prevent bot spam from abusive people. Members are automatically blocked for a second-time spam/NSFW violation (if enabled), and those identified with (global) have been blocked throughout AwesomeBot by the maintainer.

Strikes

In the past, server mods have had to either remember which members have violated the rules or keep track with a spreadsheet - but those solutions are cumbersome and often ineffective. AwesomeBot provides a strikes system for admins to easily keep track of who's breaking the rules in a semi-private way. Strikes are automatically added for spam/NSFW violations (if enabled) and are shown in each member's profile. You can add/remove a strike in the main chat by using @user strike+ or @user strike-, or use the buttons in the web interface:

Command Settings

Here you can enable/disable any commands that you don't want to be used. You can also choose custom presets, which keep AwesomeBot's core commands but removes bulk.

RSS Feeds

Here you can add custom RSS feeds that can be used in chat to fetch the latest posts from RSS Feeds. Here is a great place to find custom feeds

Management

This is where you can enable the bot to act like a server moderator, enable messages when people join/leave the server, allow the spam filter to limit spam automatically by blocking users who spam commands, stop people from fetching NSFW content via the bot, allows you to clear a whole channel of messages or archive them.

Trivia Sets

You can add custom trivia questions to be played in the AwesomeTrivia games. 2 'Trivia Packs' are already loaded and ready to play. For a custom set you need to provide a JSON file with a "name" and "stream", the latter being an array of objects, each with a "category", "question", and "answer".

Extensions

You can add custom functionality to the bot without having to host your own bot or modifying the core code. Click here for more info

Footer

Here you can refresh the server settings, change the config panels theme and also securely log out.