a super simple bot for setting roles on discord.
- Go 100%
| .gitignore | Initial commit. | |
| config.go | List available guilds and roles on startup. | |
| go.mod | Initial commit. | |
| go.sum | Initial commit. | |
| interaction.go | Refactor role setting logic. | |
| LICENSE | Initial commit. | |
| main.go | roles list is now a prettier content component. | |
| README.md | Update README.md | |
| rolebot.service | Add systemd service. | |
| roleslist.go | roles list is now a prettier content component. | |
Rolebot
a super simple bot for setting roles on discord. meant to be self hosted and used on directly managed servers only.
Build and install
build the go module with go build and then install the binary to /usr/local/bin/rolebot for the included systemd service (rolebot.service) to work. the service should be installed into /etc/systemd/system/rolebot.service or wherever and then enabled with systemctl enable --now rolebot.
Config
the default config directory is /etc/rolebot/. the environment variable CONFIG_DIR can be set for an alternate directory.
config directory structure:
/etc/rolebot/
|- token (contains the discord bot token)
|- appid (contains the application ID)
-- guilds/ (contains per-guild config)
- <guild_id>.toml (detailed below)
guilds/<guild_id>.toml
per-guild configuration as a list of role groups. example config:
# /etc/rolebot/guilds/1234.toml
[[RoleGroups]]
Heading = "Group 1"
Description = "Some group of roles"
Multiple = false # allow multiple roles from this group?
Roles = [
"1234", # role IDs must be strings
"5678",
]
[[RoleGroups]]
Heading = "Group 2"
Description = "Some other group"
Multiple = true
Roles = [
"7890",
"0987",
]