Add bot to your guild (for testing only, subject to downtime)
This bot allows to conduct Secret Santa events in Discord guilds! It is specifically optimized for digital presents, such as game codes, gift cards etc., which the bot can send anonymously via direct messages.
Key features:
- Perfect for digital presents (ex. game codes, gift cards) or any other textual gifts.
- Anonymous: no postal addresses or e-mails required, gifts are sent via Discord direct messages.
- Personal: users can specify their wishes (preferred gaming platform or game genre, for example).
This is a complete rewrite of the older Santabot: the idea remained the same, but no code was reused.
Copy the config.example.py configuration file to config.py in the same directory and edit the resulting file in your favourite editor.
The only required change is the Discord token (DISCORD_TOKEN), which you have to obtain yourself through the Discord Developer Portal.
Required bot permissions:
- Read Text Channels & See Voice Channels / View Channels (to receive commands)
- Send Messages (to reply to commands)
- Manage Messages (to delete
wishandgiftcommands for secrecy reasons)
Permission integer for API: 11264.
In this configuration file you can also change the command prefix (for example if it conflicts with another bot in your guild, default is s!) or the back-end database (SQLite is used by default, which is only acceptable when used in a few small guilds).
Make sure you've configured your bot first! See the section above.
Prerequisites:
- Docker Engine >= 1.13.0 (tested on 18.09.7)
- Docker Compose >= 1.10.0 (tested on 1.24.0)
Step 1. Run Docker Composer:
$ docker-compose up -d
That's it! It will automatically build a santabot2:latest image, spin up a new container and pass through the configuration file you created as a volume.
Prerequisites:
- Python >= 3.5.3 (tested on 3.7.3) with pip and virtual environment support
Step 1. Set up a virtual environment:
$ python3 -m venv venv
$ ./venv/bin/pip3 install -r requirements.txt
Step 2. Run the bot:
$ ./venv/bin/python3 santabot2.py
To stop the bot, press Ctrl+C. It may take up to 10 seconds to stop gracefully.
For more information and extra commands refer to the s!help command. Note that help contents depend on the user running the command and current status of the Secret Santa event.
-
To join the event, type:
s!join -
To submit your wish, type:
s!wish I would like a big penguin plushie, please! -
To submit the gift for your secret recipient, type:
s!gift Your redeem code for 5 candies on SuperGameStore is XXXXX-XXXXX-XXXXX
-
To start the event (with an optional comment), type:
s!start Budget is 10 candies -
To assign everyone their secret recipients, type:
s!assign -
To distribute everyone their gifts, type:
s!distribute
- discord.py: an API wrapper for Discord written in Python.
- Pony ORM: a Python Object-Relational Mapper with beautiful query syntax
- Discord, hosting the Community Hack Week 🎉
- Secret Santa icon for test bot based on Futurama - Robot Santa by 1bigslug (not part of this bot project, no ownership claimed, for testing purposes only)
Created for Discord Community Hack Week 2019 by Forst#8128
