Setup Roles

Use this command to let members assign themselves roles by reacting to a message. Ideal for community, gaming, or study servers where users can opt into interests, notifications, or access levels.

Parameters

title (required)

Title for the role message (max 256 characters)

description (required)

Description text (max 2000 characters)

roles (required)

Role-emoji pairs in format: emoji:role (max 4000 characters)

color (optional)

Embed color as hex code or predefined choice

Step-by-Step Example

Decide which roles you want users to be able to assign themselves.
Choose an emoji for each role.
Run the command:

/setup-roles 
title:"Choose Your Roles" 
description:"React to get access to channels and notifications!" 
roles:"🎮:Gaming,📚:Books,🎵:Music"
color:"#0099ff"

The bot will post a message. Users can react to assign/remove roles.

Use categories in your roles string for better organization:

#Interests
🎮:Gaming
📚:Books
#Notifications
📢:News
🎉:Events

Supports up to 4000 characters in the roles field—plan for scalability!

Troubleshooting

Bot not posting message: Check bot permissions (Manage Roles, Send Messages, Add Reactions).
Roles not assigned: Ensure the bot's role is above the target roles in the Discord role list.
Emoji not working: Use standard emoji or custom emoji the bot has access to.