UniBot

A Discord bot intended for the use on student-run university severs.

Features

Moderation

• Log messages that were deleted by moderators

Useful

• Reaction Roles - Allow users to self-assign roles by clicking on reactions under predefined messages
• RSS Reader - Monitor RSS feeds for new entries and send them into an associated channel, optionally pinging a certain role

Wanted Features

General

• Sync commands with all servers, get rid of hard coded server ids
• Only show commands to eligible users
• Ship bot in docker container

Moderation

• Extent logging of mod activities
  • Removal of reactions
  • Kicks
  • Bans
  • Timeouts
  • Voice channel mutes
• Log certain users deleting their own messages
• Check if link points to valid RSS feed before adding it
• Prevent users from escaping certain roles by rejoining

Useful

• Equivalent to isISIS.online

Known Issues

• If an admin deletes multiple messages of the same user, only the first one will be logged
• If there are multiple new entries in an RSS feed, only the latest one will be posted
• Bot crashes if it lacks permissions to send RSS entries into a channel

Building & running docker image

Insert your discord bot token into the .env file. Make sure the bot has the required permissions.

docker build -t nilsdeckert/unibot:latest .
docker run -e DISCORD_TOKEN=<YOUR TOKEN> nilsdeckert/unibot:latest

# Pushing to dockerhub (only for Admin)
docker push nilsdeckert/unibot:latest

How to run without docker

mkdir data
python -m venv env

# MacOS/Linux
source env/bin/activate
# Windows
env\Scripts\python.exe

# MacOS/Linux
pip install -r requirements.txt
# Windows
env\Scripts\python.exe -m pip install -r requirements.txt

# MacOS/Linux
python main.py
# Windows
env\Scripts\python.exe main.py