rolebot/readme.md

20 lines
884 B
Markdown

# 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!