ButtonRoles

Here is everything you need to know about ButtonRoles

What are ButtonRoles?

It's pretty simple. You click a button and the bot gives or removes a role from you.

Limits

  • Number limitations

    • Only up to 25 ButtonRoles per message

    • Only on the bots messages

    • Only up to 5 roles in one ButtonRole

    • Role names being set up cant exceed 50 characters

  • Label limitations

    • All emojis are valid

    • Label character limit is 80

Requirements

  • Role(s) have to be below the bots highest role

  • The bot has to have MANAGE_ROLES , EMBED_LINKS andMANAGE_MESSAGES permissions

  • Either label or emoji has to be existing

  • 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. Select any type of text based channels TextChannels, NewsChannels and Threads work for this

  5. Write a nice description This will be displayed as the main field in the embed when above the ButtonRole OPTIONAL:

  6. Select a title of your embed

  7. Select a color for your embed If none has been chosen the default color will be used

  8. Select 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

  9. Select an emoji If you don't want an emoji just pass none and the emoji will be empty

  10. Select a style of the button

  11. Select whether the member should be notified about the role change or not

  12. Select any additional roles When the button is clicked the bot will process all the roles (e.g. remove every role set up)

  13. Select a role you want the button to be restricted to. Only members with the selected role can claim or remove a role.

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

Last updated