Skip to main content

Role Gating (Whitelisting/Blacklisting)

First, we need to define what is means to whitelist or blacklist a role from a tournament, in our case. Whitelisting a role means that only users with that role can register for the tournament. Blacklisting a role means that users with that role cannot register for the tournament. It is also good to note that you cannot have whitelisted and blacklisted roles at the same time as they effective serve the same purpose. It is recommended to use whitelisting over blacklisting as it is more secure.

Setup and Enabling​

All of the setup required for this feature will need to be completed via your tournament's admin channel once it has been created. The only way to setup role gating at this time to to use the /roles command. This command has two subcommands, whitelist and blacklist.

The syntax for the command is as follows:

  • /roles whitelist @role
  • /roles blacklist @role

Once you have either whitelisted or blacklisted a role, you will see a message in the tournament's admin channel confirming that the role has been added to the chosen list.

Removing a Role and Resetting​

If you need to remove a role from the whitelist or blacklist, you can use the /roles command again with the same syntax as before. If you need to reset the role gating for your tournament, you can use the /roles reset command. This will remove all roles from whichever gating list you created for your event.

Example​

First we will whitelist the role @Tournament Participant:

  • /roles whitelist @Tournament Participant

Next, we will remove the role @Tournament Participant from the whitelist:

  • /roles whitelist @Tournament Participant

Finally, we will reset the role gating for our tournament:

  • /roles reset

Conclusion​

That is all you need to know about role gating for your tournament. Short, sweet and simple! If you have any questions or need further assistance, please feel free to join our Discord Server and let us know. We are always happy to help!