Files
contest-assistant/README.md
Xevion 0ee89fc607 Update README to latest project specifications
Still a fair bit more to go, apparently.
2021-02-18 07:51:37 -06:00

50 lines
1.5 KiB
Markdown

# contest-assistant
A somewhat simple but feature concentrated bot to automate photography contests.
## Setup
```
git clone git@github.com:Xevion/contest-assistant.git
cd ./contest-assistant/
# Create a virtual environment if necessary
pip install -r requirements.txt
python main.py
```
## Commands
Default prefix is `$` or by mentioning the bot. Change it with the `prefix` command.
```
advance [duration] [pingback = True]
Advance the state of the current period pertaining to this Guild.
close
Closes the current period.
leaderboard
Prints a leaderboard
prefix <new_prefix>
Changes the bot's saved prefix.
status
Provides the bot's current state in relation to internal config...
submission <channel>
Changes the bot's saved submission channel.
```
## Features
- [X] Customizable prefix
- [X] Ensure 1-2 char length
- [ ] Ensure ASCII
- [X] Adds upvote reactions automatically to the designated submissions channel
- [X] Removes regular messages
- [ ] Remove Videos or Gifs
- [X] Regular Messages
- [X] Deletes user's previous submissions if they upload more than one per period.
- [X] Only tracks submissions per period - previous periods are ignored.
- [ ] Removes user's previous reactions if they vote more than once.
- [X] Ignore/remove reactions added to non-submission message in the channel (preserve)
- [ ] Calculates the winners automatically.
- [X] Handles submission removal
- [ ] Automatically switches between periods if a duration is specified