Watch

Mirror of https://codeberg.org/aquova/bouncer

Python 99.9%
Dockerfile 0.1%

Find a file

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
aquova b4be23f717 Replace jank adding users to thread with individual silent pings instead		2026-08-09 20:37:44 -05:00
scripts	Fix typo	2026-04-23 12:40:46 +02:00
src	Replace jank adding users to thread with individual silent pings instead	2026-08-09 20:37:44 -05:00
.dockerignore	Ignore additional files when building Docker image	2024-10-11 20:01:34 -05:00
.gitignore	Switch from using json for config files to yaml	2023-12-16 11:14:03 -06:00
.python-version	Switch from using pip to uv	2024-10-03 11:36:56 -05:00
config.example.yaml	Add honeypot channel support	2026-06-01 07:24:29 -05:00
docker-compose.yml	Change default name of docker image back to latest	2024-10-03 11:44:17 -05:00
Dockerfile	Remove unused libraries from Docker image	2025-06-27 14:13:54 -05:00
LICENSE	Created License	2020-03-25 11:53:42 -05:00
pyproject.toml	Add local util function to remove humanize external library	2025-06-27 10:09:15 -05:00
README.md	Update copyright date	2026-02-05 15:36:18 -06:00
uv.lock	Update Python libraries	2025-08-24 18:52:26 -05:00

README.md

Bouncer

A Discord moderator bot, designed to be used with the Stardew Valley server

Written by aquova, et. al, 2018-2026

https://codeberg.org/aquova/bouncer

https://discord.gg/stardewvalley

Overview

This bot was originally written to assist with moderation on the SDV Discord server, but it can be used on any server that requires more advanced moderation logging.

My personal hosting of the bot will be private, but users are free to host a version of the bot themselves. Over time, the bot has become more and more specific to the SDV server, so this repo is here more as an example rather than a resource to be directly used by others.

Features

The bot has several moderation features:

Logging of user warnings
- Moderators can log user warnings alongside an explanitory message.
- Warnings are saved both in a Discord channel specified in config.yaml, as well as saved to a local database.
- In addition to warnings; bans, kicks, spammers, and unbannings can all be noted.
Storing moderation notes
- Notes about users are stored privately, for moderators to review later
User searching
- The database can be searched by specifying a server member. The bot will then post any noted infractions, as well as their timestamp and stored message
Removal
- Everybody makes mistakes. Individual user logs can be specified and deleted.
DM forwarding
- Private messages sent to the bot will be automatically forwarded to the channel specified in config.yaml.
- Each member will have their messages sent to a unique thread, making it easier to follow.
- Moderators can also DM a user via the bot, allowing for collaborative viewing of direct messages.
- DMs from unruly users can be blocked and unblocked as desired.
Answering Machine
- A list of unreplied users users can be viewed, to avoid accidentally overlooking a message.
- The list is automatically pruned after the message gets too old, or if they are replied to.
User DMing
- Upon being banned or warned, there is the option to DM a user with their log and helpful information. This can be disabled in the config.yaml file.
System logs
- The bot will also monitor all channels, threads, and post server-wide changes in users.
- These include nickname changes, joining, leaving, kicked, banned, joining/leaving VC, and logging of all deleted and modified messages.
Watchlist
- Possibly problematic users can be added to a 'watchlist', where all their messages are posted for easy viewing.
- Makes it easy to quickly see if a possibly troll is continuing to post, rather than relying on Discord search.

All interactions with the bot are available as slash commands, allowing any administrator the ability to limit any command to specific roles or channels.