Moderation Logs
🙋 For quick setup, simply run the
logcommand in the channel you would like to be a mod log. This will display an interactive Discord message allowing you to choose and activate loggers.
"Logging" channels are channels that FBK will post a message in when chosen events occur. You can edit which events are posted in each channel with the log command.
🔒 If the bot does not have permissions to send messages in a log channel, the feature will be automatically disabled and can be manually re-enabled.
The log command works the same as other Configuration commands. For example, log list will view current channel settings without editing.
🔐 Modifying or creating a log channel will receive and log events from the entire Discord server, and requires the
Manage Serverpermission.
❓ All loggers are naturally
togglesettings and aredisabledby default.
| Setting | Description |
|---|---|
| join | If enabled, members joining your server will be logged in this channel. 🔓 This is suitable for use in a public channel. |
| leave | If enabled, members leaving your server will be logged in this channel. |
| avatars | If enabled, your member's Discord avatar changes will be logged in this channel, allowing you to find inappropriate images. |
| usernames | If enabled, your member's Discord username changes will be logged in this channel. |
| voice | If enabled, users joining or leaving voice channels in your server will be logged in this channel. 🔓 This is suitable for use in a public channel. |
| roles | If enabled, users being assigned or removed from any role will be logged in this channel. |
| edit | If enabled, edited messages by any user will be logged in this channel. 🔑* |
| delete | If enabled, deleted messages by any user will be logged in this channel. 🔑* |
If the edit or delete logs are enabled in any channel in your server, your server's messages will be logged in FBK's internal database. This is encrpyted as required by Discord, and will not be viewed for any reason by the developers. However, it is understandable if you are uncomfortable with this. This is required because when a message is edited or deleted, Discord notifies bots but does not provide any information on what the message contained. This is not specific to FBK, and any Discord bot providing a deleted messages log with the "old" message content displayed keeps a copy of your messages on their server. If neither edit nor delete logs are enabled in your server, FBK will not keep a record of your messages at all.
It may be unwanted to have locked/staff channels have message deletions logged. Channels can be excluded from message delete/edit logs by running the channel logged false command in the channel you would like to not be logged.
| Setting | Description | Type | Default Value |
|---|---|---|---|
| bots | If enabled, bot actions will be included in this channel's avatar, username, and/or voice logs. |
toggle | true |
| joinMessage | Modifies the message sent in this channel when a join event is logged. See usable variables for configuring this message below. |
string |
See below |
| leaveMessage | Modifies the message sent in this channel when a leave event is logged. See usable variables for configuring this message below. |
string |
See below |
If you wish to customize the message sent on join or leave log events, FBK provides a configuration property to do so.
❗ Most people do not need to touch this configuration. You may wish to if creating a public
joinlog or wish to include the invite code used into the join log message.
If you wish to change the message to say simply "@Jack joined the server.", FBK needs to know where to place the actual username into the message - in this case at the very beginning. The format string for this would be simply &mention joined the server. A single command to set this would be log joinmessage &mention joined the server.
The default value for joinMessage is **&name&discrim** joined the server. (&mention)&new. This value can also be restored by using log joinmessage reset.
The default value for leaveMessage is **&name&discrim** left the server. (&mention). This value can also be restored by using log leavemessage reset.
| Variable Name | Associated Content |
|---|---|
| &name | Placeholder for the username of the member joining or leaving. |
| &mention | Placeholder for a mention (@user) of the member joining or leaving. It is not recommended to exclusively use a mention for logging, as your Discord clent will stop displaying the member's username if they no longer share any servers with you. |
| &id | Placeholder for the Discord snowflake/ID of the member joining or leaving. |
| &discrim | Placeholder for the discriminator (#0001) of the member joining or leaving. |
| &avatar | If specified, the avatar of the member joining or leaving will be displayed below each logged message. |
| Variable Name | Associated Content |
|---|---|
| &invite | Placeholder for the invite code used by the member to join your server. FBK requires the Manage Server permission to view and track invites. |
| &new | Placeholder for a message that will be displayed containing the member's account age in days if it is below a certain threshold. By default this will warn if a member's account is less than 7 days old. |
| &new=30 | Same functionality as the &new variable above, but the warning will display if the account is less than 30 days old. 30 may be set to any number. |
| Variable Name | Associated Content |
|---|---|
| &roles | Placeholder for a list of roles the member had in your server before leaving. |
| &joinDate | Placeholder for the date the member joined your server. |
| &joinDuration | Placeholder for how long the member was in your server, displayed in 120d7h format. |