Raptor Bot Documentation
Home
Guide
Commands
Home
Guide
Commands
  • Getting Started

    • Getting Started with Raptor
    • Permission System
    • Server Setup Guide

Server Setup Guide

This guide walks through the reccomended setup for Raptor. The things reccomended here are not required, however they're highly suggested. You can also use these as a way to familiarise yourself with the dashboard and some of Raptor's features. Raptor has many features, and this guide won't go over all of them, but it will go over some important features not all.

We reccomend going through and playing with the features, seeing what is avaliable and what best fits your needs.

Configuring moderation roles

Set up the logging and notification channels:

  1. Select your server on the dashboard
  2. Go to "Core Settings"
  3. Under "Administrative roles" select the role for Admin Role, Moderator Role, Trial Moderator, and Muted

Info

You can configure who has access to the dashboard in Overview by clicking "Manage Access" at the top right of the Overview page

Configuring message log and action log channels

Set up the logging and notification channels:

  1. Select your server on the dashboard
  2. Go to "Logging Settings"
  3. Setup Log channels (Ensure the "Enable logging module" switch is enabled)
    • "Message logs" is the default channel for logging information. It is where message deletes and edits are sent. If you do not have some other channels setup, some other logging may have gone there.
    • Mod Actions Log is where moderation actions are sent (such as kick, bans, warnings, mutes, so on)
    • Automod Logs is where automod flags are sent, automod actions, and logs for automod related features.
    • Master Log is where admin-only information is sent. This can include if moderators trigger filters.
    • Join/Leave logs is where new user joins and users leaving your server are sent
    • Modmail logs is where modmail archive links are sent to, when someone closes a modmail ticket.

Automod configuration

  1. Select your server on the dashboard
  2. Go to "Automod & Filters"

Smart Filter

It is reccomended you enable Adult Content Filter (if applicable to your Discord server), Malware Filter, Phishing Filter, Gambling Filter, Zalgo Text Filter, Third party clients & Client modifications.

  1. Adult Content Filter - Filters messages that contain links to known adult websites.
  2. Malware Filter - Filters messages that contain links to known malware websites.
  3. Phishing Filter - Filters messages that contain links to known phishing websites.
  4. Gambling Filter - Filters messages that contain links to known gambling and casino websites.
  5. Zalgo Text Filter - Filters messages that contain zalgo text.
  6. Third party clients & Client modifications - Filters messages that contain links to known third party clients & client modifications.

Invite Filter

This is reccomended to be enabled but not required with "Seperator protection" and "URL Decoding protection". This blocks invite links from being sent in chat. If you have specific Discord servers you wish people to be able to send invites to, you can add the server IDs in the whitelist.


Mention prevention

This is reccomended to be enabled but not required. What we reccomend enabling is "Prevent @everyone and @here. This blocks people from sending @everyone and @here mentions.


Word Filter

This is where you most likely will spent most your time. It is reccomended to be enabled but not required. This allows you to block certain words or phrases from being said in chat. You can add words to the whitelist, blacklist, or both.

You have three severities: Low, Medium, High:

  • Low - Raptor will only flag the message to admins in mod logs, no action will be taken
  • Medium - Raptor will flag the message to admins in mod logs and take action (depending on your configuration)
  • High - Raptor will flag the message to admins in mod logs and take action (depending on your configuration)

We reccomend enabling all sub-settings except "Workaround detection", as that might cause the scunthorpe problem.

Tips

If you require adding a lot of words at once, we reccomend creating a TXT file with each word on a new line, and importing the text file using the "import" button. This is useful if you've been given a huge list to import, or have hundreads you wish to import right away.


Automatic Actions

  1. Select your server on the dashboard
  2. Go to "Automod & Filters"
  3. Click "Setup auto-actions"

These allow you to configure to take action on users who are repeat offenders in amount of time. You can configure it to either apply the muted role, or timeout for mute-related actions.

This is useful if someone keeps violating rules, like triggering word filters or sending bad invites.

We reccomend setting a action for Invite link only, with action of "Mute User" a threshold of 3, time window of 2 and duration of 120 minutes. Set a scaling multiplier to 2.0 with re-offense window of 240.

Tips

This will auto-mute users who start spamming invite links within a short period of time. You can use automatic actions to help automate stuff you'd apply yourself, anyways.

Prev
Permission System