Discord Role Rotation Bot

This is a simple Python bot for Discord that automatically manages rotating a role.

It is built using discord.py and builtin discord commands

Setup & Installation

Prereqs:

• Python 3.12 or newer
• A Discord Bot Token (create one at the Discord Developer Portal)
• guild id (server id) for the server you will run the bot in
• role id for the role that you want to rotate around

Configure Bot Intents: In the Discord Developer Portal, go to your bot's "Bot" tab and enable the Server Members Intent. This is required for the bot to find and manage users. When adding the bot to the server, make sure to allow app_commands in the oauth section

Downloading and running:

git clone https://github.com/HackUCF/Role-Rotate-Bot
cd role-rotate-bot
pip install -r requirements.txt

# To run the server you pass secrets as environment variables
python3 DISCORD_TOKEN=your_token_here GUILD_ID=id_of_your_server main.py

When it first starts, it will make other default files: users.txt and conf.json. You can use /reload to reload the config live.

Available Commands

• /reload: Reloads conf.json and users.txt. Use this after any manual edit.
• /force_rotate: Manually advances the role to the next person in the list.
• /add_member [member]: Adds a member to the end of the rotation list.
• /remove_member [member]: Removes a member from the rotation list.
• /debug: Prints the bot's current loaded configuration to the console.

TODO

• /info
• /move_member
• Sync commands should be cli argument
• update debug
• Add easter egg (plinksauce?)
• Set up proper logging files
• backups
• Add permission checks to commands (e.g., admin-only) using @app_commands.checks.has_permissions().
• get working with docker