Explore

Advertise

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Detox

Detox

1

0

Invite

Vote (1)

Detox aims to assist moderators who deal with toxicity and profanity by using Perspective API and blacklists, many customisable options.


Detox

Toxicity and profanity filter for Discord. This bot makes use of the Perspective API. Add exemptions to specific roles and channels and customise percentages per server to log, warn or delete messages. Detox also supports a blacklist system implemented with Regular Expressions.

This bot was made in a rush and should be considered unstable for production use. As the days go past I will attempt to improve it.

Invite Link

If you'd like to use the bot how it is, without customising it feel free to click here to invite it to your server.

It requires several permissions, the biggest being managing messages. You are free to remove any that you think are too dangerous. Note that the bot will not be able to function entirely if you do remove them.

Installation

  • Install mongodb server community edition
  • Clone repo
  • Copy example.env to .env and supply a Perspective API key, along with Discord Bot Token
  • Install node modules - npm install
  • Run typescript compiler - tsc
  • Start with node - node ./dist/index.js

Usage

When the bot joins a server you'll need to set the log channel before anything can happen. All commands are case insensitive. Arguments to them are not.

All commands excluding !SetToxChannel and !RemoveTox must be executed from the log channel.

Blacklist System

Detox also features a blacklist system that uses regular expressions with the global and case-insensitive flags enabled. First the blacklist is checked then profanity is checked.

If a regular expression has a match on the message then the message is deleted and no warning or log is sent to the tox channel or user.

The profanity filter is not run against the message if a match from the blacklist checker is found.

It is important to note that exempt channels and exempt roles are still considered by the blacklist checker so if someone has a role that is exempt they are also exempt from triggering the blacklist checker.

Blacklist channels are the list of channels that are monitored for blacklisted messages. By default a channel does not get checked against the blacklist.


Command Reference

!SetToxChannel

Description

Sets the logging channel (and command channel) to use. Only an ADMINISTRATOR can execute this command. It may be executed from any channel. Use by mentioning a channel.

Arguments

  • Channel mention

Example

User> !settoxchannel #event_log

Bot> Set the log channel to 123456789


!RemoveTox

Description

Removes all data related to the current server Detox is in. Detox will then attempt to leave the server by itself. Only an ADMINISTRATOR can execute this command. It may be executed from any channel.

Arguments

  • none

Example

User> !removetox


!ExemptChannels

Description

Get a list of exempt channels that the bot will not inspect.

Arguments

  • None

Example

User> !exemptchannels

Bot> Exempt Channels:

test1 - ID: 6934300518562
test2 - ID: 6934300518563

!AddExemptChannels

Description

Add a list of exempt channels by mentioning channels.

Arguments

  • Channel mentions.

Example

User> !addexemptchannels #test1 #test2 #test3

Bot> Successfully added 3 channel(s) to be exempted.


!RemoveExemptChannels

Description

Remove a list of exempt channels by mentioning channels.

Arguments

  • Channel mentions.

Example

User> !removeexemptchannels #test1 #test2 #test3

Bot> Successfully removed 3 channel(s) from being exempt.


!ExemptRoles

Description

Get a list of exempt roles. A user with an exempt role will be unfiltered.

Arguments

  • None

Example

User> !exemptroles

Bot> Exempt Roles:

Unfiltered - ID: 6934300518562
RudePerson - ID: 6934300518563

!AddExemptRoles

Description

Add a list of exempt roles by mentioning roles.

Arguments

  • Role mentions.

Example

User> !addexemptroles @test @test2

Bot> Successfully added 3 roles(s) to be exempted.


!RemoveExemptRoles

Description

Remove a list of exempt roles by mentioning roles.

Arguments

  • Role mentions.

Example

User> !removeexemptroles @test @test2

Bot> Successfully removed 3 roles(s) from being exempt.


!ConfigSummary

Description

Show a summary of the config for the current server.

Arguments

  • None

Example

User> !configsummary

Bot> Server Config Summary:

Warn in Channel Percentage: 85%
Delete Message Percentage: 90%
Log Percentage: 75%

Delete Message on Detect: false
DM User on Detect: false
Profanity Check: true
Toxicity Check: true
Exempt: 3 channel(s), 1 role(s)

!SetLogPercentage, !SetWarnPercentage, !SetDeletePercentage

Description

Set the percentage for an action:

  • Log - Logs a message to the tox log channel
  • Warn - Alerts the user with a message in the message the channel was sent in
  • Delete - The percentage at which a message will be deleted if delete message is on

Note that the bot will not warn if the delete percentage is reached, it will still log if the log percentage has been reached.

Arguments

  • Percentage, 0 to 100, decimals accepted.

Example

User> !setlogpercentage 85

Bot> Successfully set the log percentage to 85%


!SetToxicityCheck, !SetProfanityCheck

Description

Set whether the toxicity or profanity check will occur.

Arguments

  • true or yes will turn it on, anything else will disable the check.

Example

User> !setprofanitycheck no thanks

Bot> Successfully set profanity check to false


!SetDeleteMessage

Description

Whether or not to delete the message if it exceeds the delete percentage. Deleting will log a message to the tox channel.

Arguments

  • true or yes will turn it on, anything else will disable the check.

Example

User> !setdeletemessage true

Bot> Successfully set delete message to true


!SetDmUser

Description

Whether or not to DM the user when the message has been deleted. Requires delete message to be triggered in order to send a DM.

Arguments

  • true or yes will turn it on, anything else will disable the check.

Example

User> !setdmuser no

Bot> Successfully set DM user to false


!Blacklist

Description

Displays the blacklist.

Arguments

  • none

Example

User> !blacklist

Bot> Blacklisted Words/Regex:

bad[\w\s]+word

!AddBlacklist

Description

Adds a regular expression (regex) to the blacklist. Regular expressions have the G and I flags when tested against messages.

Arguments

  • the regular expression

Example

User> !addblacklist bad[\w\s]+word

Bot> Successfully added the blacklisted word.


!RemoveBlacklist

Description

Removes a regular expression (regex) from the blacklist.

Arguments

  • the regular expression

Example

User> !removeblacklist bad[\w\s]+word

Bot> Successfully removed blacklisted word.


!BlacklistChannels

Description

Displays blacklist-enabled channels. Channels in this list are monitored by the blacklist checker.

Arguments

  • none

Example

User> !blacklistchannels

Bot> Blacklist Check Channels:

test123 - ID: 43525733337933
test1234 - ID: 693717688633334

!AddBlacklistChannels

Description

Adds a list of channels to be monitored for blacklisted words/regexes.

Arguments

  • Channel mentions.

Example

User> !addblacklistchannels #test123 #test345

Bot> Successfully added 2 channel(s) to be blacklist checked.


!RemoveBlacklistChannels

Description

Removes a list of channels from blacklist monitoring.

Arguments

  • Channel mentions.

Example

User> !removeblacklistchannels #test123 #test345

Bot> Successfully removed 2 channel(s) from being blacklist checked.


Ratings & Reviews


1

1 review

Reviews can be left only by registered users. All reviews are moderated by top.gg admins. Please make sure to check our guidelines before posting.

5 stars

0

4 stars

0

3 stars

0

2 stars

0

1 star

1


pauu
pauu

9 months ago

ok

0


Details

Prefix

!

Socials

GitHub

Tags

    Moderation

    Customizable Behavior

    Utility

Creators

El

El