Add readme

This commit is contained in:
Sam W 2023-05-11 14:36:15 +01:00
parent 83c753add8
commit 70317a1372
1 changed files with 19 additions and 0 deletions

19
readme.md Normal file
View File

@ -0,0 +1,19 @@
# Rolebot
Rolebot is a minimal discord bot that allows server members to manage their own roles.
You might want to use this for general, non-permission-granting roles that anyone should
be able to freely assign themselves like
- pronouns
- players of a particular game
- favorite biscuit
## Use
- [Create a Discord application](https://discord.com/developers/applications)
- Copy the bot token, and make it available under the env var `DISCORD_TOKEN`
- Go to oauth -> URL generator
- Tick bot, then "manage roles" in the bot permissions.
- Copy the URL into the menu bar and authorise the bot to join your server
- This will automatically make a role with the same name as the bot. **Rolebot will
allow users to add or remove themselves from any role lower than this one in the
order**. Please make sure no permission-giving roles are lower than it!
- Run the bot. That's it!