discord-image submission
A robust bot for submitting images as a team via discord.
All based on slash commands and the private chat.
Useful for image hunts where people are tasked to find things and submit images from the findings.
The bot supports live reload of the submission module without restarting.
All stored data is persistent and will be reloaded after restart.
Images that are submitted during downtime are loaded afterward from all actively competing teams.
Setup
Setup a venv (optional, but recommend)
python3 -m venv venv
source venv/bin/activate
Using pip to install the bot as editable package:
python3 -m pip install -e .
export TOKEN="your-key"
discord-bot
Or using the launch script:
pip install -r requirements.txt
export TOKEN="your-key"
python3 ~/git/discord-bot/launcher.py
Intents
The bot uses all intents by default, those are required for such simple things like 'display member-count at startup'.
You need to enable those intents in the discord developers portal
under *YourApplication*/Bot/Privileged Gateway Intents.
It's possible reconfigure the requested intents in main.py if you don't need them.
But I'd suggest using them all for the beginning, especially if you're relatively new to discord.py.
This will only be an issue if your bot reaches more than 100 servers, then you've got to apply for those intents.
Optional env variables
| parameter | description |
|---|---|
PREFIX="b!" |
Command prefix |
OWNER_NAME="unknwon" |
Name of the bot owner |
OWNER_ID="100000000000000000" |
ID of the bot owner |
ACTIVITY_NAME=f"{PREFIX}help" |
Activity bot plays |
BASE_GUILD="760421261649248296" |
The guild needed to register a team |
The shown values are the default values that will be loaded if nothing else is specified.
Expressions like {PREFIX} will be replaced by during loading the variable and can be used in specified env variables.
Set those variables using env-variables (suggested):
export PREFIX="b!"
Or use a json-file expected at: ./data/config.json like:
{
"TOKEN": "[your-token]",
"PREFIX": "b!"
}If a variable is set using env and json the environment-variable replaces the json!
documentation
In order to render this documentation, just call doxygen