• Python 86.5%
  • PHP 8.5%
  • Hack 1.9%
  • CSS 1.9%
  • JavaScript 0.6%
  • Other 0.6%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-13 19:25:22 -06:00
bot Fix duplicate tag errors 2026-11-13 19:25:22 -06:00
web Fix level.php crash when no database matches 2026-11-01 12:29:27 -06:00
.gitignore Merge governor into bouncer 2026-10-20 19:14:17 -05:00
docker-compose.yml Prevent possible security issues 2026-10-29 10:47:21 -05:00
LICENSE Merge governor into bouncer 2026-10-20 19:14:17 -05:00
README.md Update the readme 2026-10-22 10:02:06 -05:00

Bouncer

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

Written by aquova, et. al, 2018-2026

https://codeberg.org/aquova/bouncer

https://stardew.chat

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.

What happened to Governor?

Governor was a separate bot which handled the more user-facing aspects of a server, such as custom commands as XP granting. In 2026, Discord required that bot developers submit bots with over 100 users to apply for certain API privileges, where Discord administrators would determine whether your bot's functionality really couldn't be done without those functionalities. Bouncer passed the application without problem, while Governor did not (twice). This led to changes such as removing automatic SMAPI log parsing, an inability to update the user leaderboard, and a return of bugs that had been fixed years prior. Rather than live with these rough edges (or attempt to again apply to Discord, a process that must be done yearly), the two bots were merged, so that both could continue to enjoy the functionality they originally were developed with.

Features

The bot has several useful server features:

  • XP and role management
    • Users receive XP per server message, which will grant additional roles upon hitting customizable thresholds.
    • XP can be turned off per-channel, to avoid users gaming the system.
    • Users can request a personalized image of their server progress.
  • Custom commands
    • Users can set custom responses for the bot, useful for standardizing replies to common queries.
  • Free game posting
    • The bot will post free game giveaways daily, either via an automated system for Epic Games Store, or manually submitted for other storefronts.
  • Logging of user warnings
    • Moderators can log user warnings alongside an explanatory 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.
  • Forum archiving
    • The bot can easily mark forum posts as closed and archived, all with a single command.
  • 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.