go-discord-modtools

Discord moderation bot written in Go

Configuration

Set some environment variables before launching, or add a .env file.

If database environment variables are provided, the bot will save stats to an external database. Otherwise, it will save stats to a local sqlite database at /var/go-discord-modtools/local.db

Variable	Value(s)
DB_TYPE	`mysql`, `postgres` or unset for sqlite
DB_NAME	Database name for database
DB_HOST	Hostname for database
DB_PASSWORD	Password for database user
DB_USER	Username for database user
LOG_LEVEL	`trace`, `debug`, `info`, `warn`, `error`
TOKEN	The Discord token the bot should use

PostgreSQL requires SSL to be enabled for your database.

Usage

In the Discord app, right click (Desktop) or long press (mobile) a message or user to see the available options.

Commands

Configure the bot (Highly recommended to do so only people in a specific role can use the moderation commands):

/settings

Get reputation for a user:

/query

Add a custom command (simply posts your desired block of text, Markdown formatting enabled)

/addcommand

Remove a custom command

/deletecommand

Get this help message:

/help

Development

Create a .env file with your configuration, at the bare minimum you need a Discord token for TOKEN.

You can either docker compose up --build to run with a mysql database, or just go run main.go to run with a sqlite database.

Self-hosting

Create a bot here: https://discord.com/developers/applications
Go to "Bot" -> Copy token, it should be set as the TOKEN environment variable
Go to Oauth2 -> save your Client ID to your notes
Add it to your server by visiting https://discord.com/oauth2/authorize?client_id=CLIENT_ID&permissions=277025507392&scope=bot, replacing CLIENT_ID with your client ID.

tyzbit / go-discord-modtools