PermRoles allow you to set starboard-related permissions for roles.


PermRoles work very similarly to Discord's role permissions system. For each PermRole, you can change their "permissions". Each permission can either be True (enabled), False (disabled), or None (default). If a permission is None, it simply carries from the last PermRole.
PermRoles are ordered in the same way your Discord roles are ordered, and are applied starting with the @everyone role and ending with the highest up role.
In addition to setting global permissions, you can also set per-starboard permissions for each role.


  • /permroles view: View the permroles for a server.
  • /permroles create role: <role>: Create a PermRole.
  • /permroles delete [by-role: <role> by-id: <role id]: Delete a PermRole.
  • /permroles edit permrole: <role> [options...]: Edit the permissions for a PermRole. See the next section for configurable permissions.
  • /permroles edit-starboard permrole: <role> starboard: <starboard>: Edit a PermRoles starboard-specific permissions.


  • give-stars: Whether to allow giving stars.
  • receive-stars: Whether to allow receiving stars.
  • gain-xproles: Whether to allow users to receive XPRoles. Cannot be configured per-starboard (what would that even do).