Quick Start Guide
Are you interested in keeping your server members safe from hackers and compromised bots? You're in the right place! This guide will walk you through setting up Good Knight in your Discord server
- 1.Add Good Knight to your server
- 2.Drag its role above any active role
- 3.Remove dangerous permissions from all active roles/users
- 4.Server owner runs /setup and follows the walkthrough
- 5.Server owner sets their password with /password-manage
- 6.Create moderators with /manage-mods
Note: For the rest of this Quick Start Guide, it is assumed that Good Knight was given
When added to your server, Good Knight will create its own role. This role should be dragged up towards the top of the role list. Just below any cold admin roles. Good Knight is your last line of defense against hackers and compromised bots. Its role should be above any other security or moderation bots (Wick, Dyno, Beemo, Security, etc.).
The Good Knight Permissions Wizard has the power to grant temporary permissions to your moderators. If this feature is activated, it is recommended to remove dangerous permissions from all active users in the server. Be sure to check for both role and channel overwrite permissions. Instead, admins and mods can be safely granted temporary permissions through the Permissions Wizard!
For a sample role setup, see below
Below shows a discord server theoretical role hierarchy.
- Cold Admins are at the top and are an important security mechanism for any discord server. They should have the ability to kick Good Knight. Users with the Cold Admin role are the only users that should have the
- Good Knight bot is next, above the other bots
- Other security and moderation bots are 3rd. These bots may require
Administratorpermissions.If any bot is above Good Knight, there's a risk that a hacker could use the bot to kick the Good Knight!⚠
- Staff and Moderators follow. These are active team accounts that should not have
Administratoror other dangerous permissions but may have access to security and moderation features through bot commands
- The general server Members follow and should have the minimum permissions needed
- Other Bots are last. The bots in this category have specialized use cases like memeing, website feeds, games, etc. In most cases, it is best practice not to create a special role for these bots. Instead, add them to the Members role and address their permissions individually.
/setup, Good Knight will ask the user whether they would like Good Knight to automatically or manually setup the admin channels. Select "Auto-create Admin Channels". The Good Knight will create the
#good-knight-admin- Logs important Good Knight events and receives important bot and security notifications
#good-knight-logs- Most Good Knight actions will be posted here, including deleted links/webhooks and temporary permission access
Next, the Good Knight will ask the server owner to choose users to be the Good Knight admins. These users will be able to use potentially dangerous features like registering channels so that they allow any link, giving Good Knight mod permissions to other users, and modifying the Good Knight setup. Select Good Knight admins that you trust. It is recommended for the server owner to select their second, "active" account as a Good Knight admin.
The following options allow you to select how Good Knight will operate in your server. This includes the Good Knight updates feed, Permissions Wizard, Panic Mode, anti-link, and anti-webhook.
Other bots that block webhooks may affect updates feed setup. You may need to whitelist Good Knight or the webhook with that bot.
Once setup is complete, the owner and Good Knight admins can set their password and begin selecting users as Good Knight mods who can help manage the server.
When anti-link is active, Good Knight will delete any message including an unapproved link. Link and channel registration is a key feature that allows you to customize which links are trusted. The link registration list is managed using:
and can be viewed using:
When anti-webhook is active, Good Knight will delete any messages sent by an unapproved webhook, unless that webhook is registered, and remove unregistered webhooks from your server. It also moderates any webhooks including Open webhooks, Channel Follows, and Closed Webhooks. Webhook moderation is managed using:
and can be viewed using the manager or: