Discord bot for game server management
Go to file
calamity 8a38babeaa
forgot a fix for declines
2022-12-31 19:45:11 +05:00
docs split cogs and config docs into separate md files 2022-12-25 19:38:32 +05:00
puffer forgot a fix for declines 2022-12-31 19:45:11 +05:00
.env.example actually, that's funnier 2022-12-24 23:00:52 +05:00
.gitignore implement vc renaming & auth 2022-11-13 19:00:52 +05:00
LICENSE Initial commit 2022-11-12 11:20:47 +01:00
README.md split cogs and config docs into separate md files 2022-12-25 19:38:32 +05:00
mypy.ini minor prikols 2022-11-13 14:59:04 +09:00
poetry.lock add types-redis to dev dependencies 2022-11-20 21:39:58 +09:00
pyproject.toml bugfixes 2022-12-31 19:28:01 +05:00



Puffer is a Discord bot for game server management. It contains features of moderation, trade announcements, voice chat management, as well as a member gateway using Discord's UI forms (WIP).

There is not a universal instance of Puffer, because the bot is made to be customizable for each server. So you're going to have to create and host your instance if you want the bot for your server.


Puffer has several steps to installing on your server. Prerequisites:

First, you need Python 3.10+ and PIP (comes with Python).
Second, you need to install Poetry for Python. Do it using pip install poetry.
Third, you'll need to have a Redis database running somewhere, that you can connect to if you've enabled DB-using cogs.

Now you can install the bot:

  1. Head over to the Discord Developers page, create a bot and grab it's token. You'll find a plenty of instructions on how to do it online. Don't forget to disable invites not-by-owner.
  2. Invite your bot to the server, where you're going to use it. As well, don't forget to create required channels, if the cogs you'll be using require any. Remember, one instance covers one server.
  3. Clone the repository to your hosting computer.
  4. Copy (don't move/rename, copy) the .env.example file to .env and edit it with your values. There are short explanations for the environment variables in the example file, but the long descriptions can be read in the Config documentation.
  5. Proceed to launch the bot with the following commands:
poetry install # Install dependencies
poetry shell # Activate the shell environment
python -m puffer # Start the bot
  1. Puffer should be up and running, if you did everything correctly!

If your members can't use commands - make sure they have the Connect permission. We recommend removing this permission from the default (@everyone) role, especially if you're using Verification features.

Cogs and Configuration

You can read about what each cog does and what each entry in the .env file is in Cogs documentation and Config documentation.

NOTE: Currently you cannot customize the fields for the verification modal, as well as the placeholder text for the greeting message. This should be fixed by the 1.0.0 release.