https://github.com/kartonrad/activityrole-bot
A bot for discord that will assign Roles based on the Games that the Servers Members currently play.
https://github.com/kartonrad/activityrole-bot
bot discord games
Last synced: about 1 month ago
JSON representation
A bot for discord that will assign Roles based on the Games that the Servers Members currently play.
- Host: GitHub
- URL: https://github.com/kartonrad/activityrole-bot
- Owner: kartonrad
- Created: 2020-04-16T16:56:57.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2026-04-10T03:33:19.000Z (2 months ago)
- Last Synced: 2026-05-13T13:55:46.164Z (about 1 month ago)
- Topics: bot, discord, games
- Language: JavaScript
- Homepage:
- Size: 71.3 KB
- Stars: 10
- Watchers: 1
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# activityrole-bot
A Discord Bot that will assign roles based on the Games that a Member is currently playing.
Roles are assigned to a member when a Game is opened, closed or refreshes it's Presence on Discord.
Players that we're already playing when the bot looged in won't be assigned a role (yet).
The Bot needs the MANAGE_ROLES Permission on your Server, and only Members with Roles that are **lower** in the [Hierarchy](https://support.discordapp.com/hc/en-us/articles/214836687-Role-Management-101) will be assigned Activity-Roles(tm).
## Security Considerations and Quirks
There are a few quirks too be considered:
- Games that are not registered as a [Discord Application](https://discordapp.com/developers/docs/intro) are ignored by the bot (most of the are dw)
- this prevents members from giving themselves arbritrary roles by manipulating `Settings>Game Activity`
- The Bot will assign any role matching the Name of the Activity
- Make sure no important Admin/Moderator Role has a name matching **any** game registered with Discord
- If you have a role that should **never** be tampered with by the bot, make sure that it's above the Bot's Role in the [Hierarchy](https://support.discordapp.com/hc/en-us/articles/214836687-Role-Management-101)
- Some Games (annoyingly) register both their Launcher AND the actual Game with Discord, resulting in multiple roles being created and assigned to the ones playing it.
- You can instruct the bot to use a specific **alias** instead of the default name, by editing `.config/default.json`
- This way you can prevent Games from showing up twice and use creative Rolenames
- the config file is already preconfigured to rename Rainbow Six Siege and it's annoying duplicate
## Optaining a Discord API token
You will need a token to run the bot.
1. Create a Discord [Application](https://discordapp.com/developers/applications)
2. Navigate to the `Bot` Tab on the right side.
3. Select "add Bot" and confirm.
4. And finally: Reveal and copy the token!
## Brief Setup Guide
1. Provide a Discord API access token in `.config/default.json`
2. Install dependencies `npm install`
3. Run the bot with `npm start`
Alternatively, run using docker compose:
1. Edit `.config/default.json`
2. Run `ACCESS_TOKEN="..." docker compose up` in Bash or `$env:ACCESS_TOKEN=".." docker compose up` in Powershell
If you want to run this thing with docker, independantly from compose,
that the Volume `/home/node/.config` is bound to a `.config` folder, containing your configuration.
Otherwise, the Docker Container will run using the default configuration.