Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/commandserver/antispambot
A Discord Bot to protect your server from raids, spam, invitations, fake nitro ads and more written in C++
https://github.com/commandserver/antispambot
anti-raid antispam bot cpp discord discord-bot discord-client discordbot dpp spam-detection spam-protection
Last synced: 2 months ago
JSON representation
A Discord Bot to protect your server from raids, spam, invitations, fake nitro ads and more written in C++
- Host: GitHub
- URL: https://github.com/commandserver/antispambot
- Owner: Commandserver
- License: mit
- Created: 2022-03-17T19:30:54.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-11-22T13:28:37.000Z (2 months ago)
- Last Synced: 2024-11-22T14:29:08.039Z (2 months ago)
- Topics: anti-raid, antispam, bot, cpp, discord, discord-bot, discord-client, discordbot, dpp, spam-detection, spam-protection
- Language: C++
- Homepage:
- Size: 22.5 MB
- Stars: 9
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Antispambot
[](https://www.codacy.com/gh/Commandserver/Antispambot/dashboard?utm_source=github.com&utm_medium=referral&utm_content=Commandserver/Antispambot&utm_campaign=Badge_Grade)
**An efficient Discord Bot to prevent spam** written in C++. Tested on a large discord server and mitigates around 90% of spam. Its well commented and therefor you can easily adapt it according to your needs. Currently, it's designed to only work with one Guild.
## Features
The following is considered as spam and will be deleted by the bot:
* discord invitations
* crossposted messages (repeated messages over too many channels). This also effects fake nitro ads!
* repeated messages
* messages with too many mentions
* bad words (configurable in `bad-words.txt`)
* messages that contains an url of a blacklisted domain (see `domain-blacklist.txt`)
* forbidden file extensions like _.exe_ (configurable in `config.json`)
The bot is using the new Timeout feature of Discord to time out users who spam!
You can configure users and roles that are excluded.
🤖 It also detects raids when large amounts of users joined in a shorter time and notifies you.
🕐 All created threads will have a slow-mode of 3 seconds to prevent mass-pings in them.
The bot creates the following slash commands:
| Slash command | description |
|---------------|----------------------------------------------------------------------------------------------------|
| `/manage` | To configurate excluded roles and users as well as managing the blacklisted domains and bad words. |
| `/info` | Information about the bot |
| `/massban` | Ban command to easily ban suspicious accounts |
| `/masskick` | kick command to easily kick suspicious accounts |
## Dependencies
* [cmake](https://cmake.org/) (version 3.16+)
* [g++](https://gcc.gnu.org) (version 8 or higher)
**Included dependencies (in the `/libs` folder)**
* [DPP](https://github.com/brainboxdotcc/DPP) (version 10.0.21)
* [spdlog](https://github.com/gabime/spdlog)
## Supported Platforms
I run the bot on Linux (ubuntu). But other UNIX-style platforms should build and run the bot fine.
## Building
Compile instructions for Linux:
Go into the project directory and run the following commands.
```bash
mkdir build
cd build
cmake ..
make -j8
```
Replace the number after -j with a number suitable for your setup, usually the same as the number of cores on your machine.
Visit the [D++ library documentation](https://dpp.dev/) for more details.
## Configuration and Running
Rename the `config.json.dist` to `config.json` and configure it. The configuration variables in the file should be self-explanatory.
All bad words are saved line by line in the `bad-words.txt`.
The `bypass-config.txt` can be used to exclude users and roles from getting detected by the bot, just save the user- and role IDs line by line in it.
All forbidden domains are stored in `domain-blacklist.txt`. Used to prevent the sharing of certain websites/urls. You can also add top-level-domains to them.
The bot creates discord slash commands to manage the above three _.txt_-configs, therefor they're stored in extra files.
The bot requires the **message content** and **server members** intent to be enabled!
Add the bot with the `bot` and `applications.commands` scope to your server!
The bot needs at least the following permissions: `VIEW_CHANNEL`, `SEND_MESSAGES`, `MANAGE_MESSAGES`, `MANAGE_THREADS`, `MODERATE_MEMBERS`, `BAN_MEMBERS`, `KICK_MEMBERS`.
I'd recommend running the bot with systemd, to keep the bot always online.
A basic unit file could look like this:
```unit file (systemd)
[Unit]
Description=Antispam Discord Bot
After=network.target
[Service]
ExecStart=/home/PATH_TO_THE_EXECUTABLE
Type=simple
Restart=always
[Install]
WantedBy=multi-user.target
```
## Support me
Be sure to leave a ⭐️ if you like the project :) Thank you! Be sure to contribute, if you're interested!
## FAQ
**Why C++?**
I had pretty much the same bot in python, but I had problems with the message cache when it ran on a bigger discord server. Weird things happened and in the end i had no _real_ control of the cache, so i moved to C++.