ButtonRoles

What are ButtonRoles?

It's pretty simple. You click a button and the App gives, removes or switches out a role.

Limits

info_outline
Requirements
  • Role(s) have to be below the Apps highest role
  • The App has to have MANAGE_ROLES, EMBED_LINKS and MANAGE_MESSAGES permissions
  • Follow the style requirements below
  • With 2 or more roles a custom label is required

How to set up a ButtonRole

  1. Type out /buttonrole create
  2. Select the type you want to use
    Toggle adds and removes roles (when you have the role it removes it and vice versa
    Add only adds roles but doesn't remove them
    Remove only removes roles but doesn't add them
  3. Select a role
    Make sure all the requirements mentioned above are met
  4. Write a nice description
    This will be displayed as the main field in the embed when above the ButtonRole

Optional Arguments

  1. Select any type of text based channels
    This can be every channel except for Stage Channels and Categories
  2. Create a title of your embed
  3. Select a color for your embed
    If none has been chosen the default color will be used
  4. Create a label
    If you don't want a label just send pass none and the label will be empty
    Just be sure to meet the label requirements above
  5. Select an emoji
    If you don't want an emoji just pass none and the emoji will be empty
  6. Select a style of the button
  7. Select whether the member should be notified about the role change or not
  8. Select any additional roles
    When the button is clicked the app will process all the roles (e.g. remove every role set up)
  9. Select a role you want the button to be restricted to.
    Only members with the selected role can claim or remove a role.
warning
Style Requirements
  • There has to be either a label or an emoji
  • The label can not be zero-width characters

When you're done your command should look similar to this:

Filled out ButtonRole creation command
Filled out ButtonRole creation command