Skip to content

Instantly share code, notes, and snippets.

@ThatTonybo
Last active June 18, 2020 19:33
Show Gist options
  • Star 1 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save ThatTonybo/98eb1a8919ff0be181d26adcb9fa3b51 to your computer and use it in GitHub Desktop.
Save ThatTonybo/98eb1a8919ff0be181d26adcb9fa3b51 to your computer and use it in GitHub Desktop.
How to get started with Game Roles.

About

Game Roles is a bot that automatically adds, removes and manages roles when users start or stop playing specific games. It checks their Discord activity and rich presence to see, then gives and removes the roles that you define.

Getting started

If you haven't invited the bot yet, click here to do so. Game Roles only needs one permission, Manage Roles, any others are a waste.

Please note that due to Discord limitations, the bot can only add roles below it's highest role, so make sure to move it's highest role above your game roles.

Adding roles

To add a role, use the !add ["game name"] [@role] command.

It takes 2 parameters:

  • "game name" (String): The name of the game, wrapped in quotes.
  • @role (String): The @mentioned role that you want to be applied for this game.

For example, to give Fortnite players a "@Llama" role, you'd use !add "Fortnite" @Llama. To give people watching YouTube the "@Web Surfers" role, you'd use !add "YouTube" @Web Surfers.

Listing roles

To view a list of all your active roles in the server, use !list. You'll find each game there, with their linked role and an ID.

Removing roles

To remove a role, use the !remove [id] command.

It takes 1 parameter:

  • id (String): The ID found in the !list command.

For example, to stop users watching YouTube from getting the "@Web Surfers" role, use !list to find it's ID, such as vhdU1XUB, then run !remove vhdU1XUB.

Any questions?

You can ask questions at the support server.

Notes

  • Guide written by ThatTonybo#0001
  • The bot only needs the Manage Roles permission, any others aren't needed in a normally set-up Discord server.
  • For re-reference: Please note that due to Discord limitations, the bot can only add roles below it's highest role, so make sure to move it's highest role above your game roles.
@mtnz0r
Copy link

mtnz0r commented Jan 29, 2020

please when quit game bot removed role fixed :>

@Psystec
Copy link

Psystec commented Jun 18, 2020

Good and easy to use bot. The only issue i have is that the roles are not persistent. I need the roles to stay after it has been assigned and the player quits the game. Would that be possible?

A better option is to make it so that it automatically removes the role after a time period like a month or week if the user chooses it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment