Big chungus is a moderation bot with the aim of being efficient and easy to setup.

The entire bot can be configured through the website.

Features

• Raid and nuke protection - Protect your server with automated anti-nuke/raid systems or manual commands.
• Fast auto-moderation - Automatically delete spam, nsfw messages, links, and discord invites.
• Highly configurable strike system - Configure custom punishments for members that trigger on x amount of strikes.
• The best basic moderation commands - Basic moderation commands with heirarchy-based moderation.

Raid and nuke protection

• Webhooks cannot be created, and will be deleted by the bot immediately (unless unsafe mode is enabled).
• Unsafe mode can enabled on with the unsafe command, which will supress all the bot's systems (apart from message filters) for two minutes. Unsafe mode cannnot be enabled if anti raid mode is on.
• All events are logged, and if any event surpasses the rate limit (3 of the same event within 2.5 seconds), the server is put into anti-raid mode.

Running the antiraid command does the following things:
• Ban any new members that try to join while anti-raid mode is enabled, and unban them afterwards.
• Constantly look for any duplicate roles/channels/categories and deletes them.

Fast auto-moderation

You can configure the bot to delete messages that contain links, spam (repeated characters, mention spam, etc), blacklisted words, discord invites.

Highly configurable strike system

Strikes are essentially warnings, and people with the MANAGE_MEMBERS permission can use the strike command to give any amount of strikes to a user. You can configure actions to be performed when a user reaches a certain amount of strikes, currently supported actions are: timeout, kick and ban

Basic Moderation

Big Chungus has a system of hierarchy based moderation, which allows members of higher position to moderate members of (relatively) lower position, even though both members are moderators. The basic moderation commands available in the bot are: ban, unban, kick, timeout, strike, strikes and relax.

Moderators are people who can run moderation commands in a server.

Using the Code

Prequisites

• NodeJS ^1.17.1
• TypeScript - npm install typescript
• Discord.js - npm install discord.js

After installing all the required dependencies, put your bot's token (along with some additional data) in src/config.js.

Running

Go into your terminal and run the following commands:

cd path/to/big-chungus
./run.sh all

Use ./run.sh all if you want to compile and deploy commands before running, ./run.sh compile if you only want to compile, ./run.sh deploy if you only want to deploy, and ./ run.sh if you only want to run.

Resources and Links

• Website - Configure the bot here
• Documentations - All commands in the bt are properly documented here.