Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/socksthewolf/antiscambot
A Discord bot that shares ban lists of scammers across multiple Discord servers
https://github.com/socksthewolf/antiscambot
antiscam antiscambot bot commission discord discord-bot discord-py discordapp furry safety scamblock scamblocker security-tools sqllite3
Last synced: about 1 month ago
JSON representation
A Discord bot that shares ban lists of scammers across multiple Discord servers
- Host: GitHub
- URL: https://github.com/socksthewolf/antiscambot
- Owner: SocksTheWolf
- License: mit
- Created: 2023-09-25T22:43:07.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-09-03T22:49:32.000Z (2 months ago)
- Last Synced: 2024-10-13T01:41:14.879Z (about 1 month ago)
- Topics: antiscam, antiscambot, bot, commission, discord, discord-bot, discord-py, discordapp, furry, safety, scamblock, scamblocker, security-tools, sqllite3
- Language: Python
- Homepage: https://scamguard.app/
- Size: 1.66 MB
- Stars: 6
- Watchers: 4
- Forks: 3
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# ScamGuard AntiScam Bot
This is a Discord bot that bans scammers who offer unsolicited commissions to users of a discord server.
These scammers are a scourge on our Discord communities. Unfortunately, unless they are banned in all relative servers, they’ll hop onto the next server and then attempt to scam people from there next.
To stop this from happening, this bot shares a ban list of known scammers to any servers it is activated in such that the scammers are unable to contact anyone.
This bot is powered via community reporting, trusted verification, and complete transparency in all actions.
You can read more on [the website here](https://scamguard.app/)!
---
## Configurations to Run the Bot
### Environment Vars
To start the bot locally, create a .env file in the current directory with the following environment variables:
```
DISCORD_TOKEN="your discord bot token"
DATABASE_FILE="a path to your sql file"
CONFIG_FILE="a path to your config file"
API_KEYS="a path to the file with api keys for subinstance bots to spin up"
BACKUP_LOCATION="a path to a directory to store your backup sql file"
DEVELOPMENT_MODE="true if you want to test without banning, false to ban people"
```
Here is an example of a .env file.
```
DISCORD_TOKEN="0"
DATABASE_FILE="database.db"
CONFIG_FILE="config.json"
API_KEYS="apikeys.json"
BACKUP_LOCATION="backup/"
DEVELOPMENT_MODE="true"
```
You can also have these environment variables set directly
### Config.json
By default, the config.json file is preconfigured with IDs specifically for the TAG server.
To test the bot on your own Discord server for debugging purposes, here's how you can get the IDs for the server, roles, and channels
- Server ID: Right click your server icon and click on Copy Server ID
- Role ID: Go to your Server Settings -> Roles -> "..." button for the role -> Copy Role ID
- Channel ID: Right click the channel and click on Copy Channel ID
---
If you want to have a publicly accessible API endpoint for your bot instance, you can [clone this project](https://github.com/SocksTheWolf/AntiScamBotAPI).