DocsAdminRoles de Reacción

Roles de Reacción

Cómo funciona

Los roles de reacción permiten que los miembros obtengan roles por sí mismos simplemente reaccionando con un emoji a un mensaje publicado por el bot. Todo se configura desde el dashboard — no hay comandos slash para este módulo.

Usuario reacciona
emoji en el panel
Bot lo detecta
busca el panel
Verifica modo
normal o único
Asigna el rol
al instante

Quitar la reacción elimina el rol. En el modo único, cambiar a otro emoji elimina automáticamente el rol anterior y añade el nuevo — el usuario nunca puede tener dos roles del mismo panel.

Crear un panel

Cada panel es un mensaje que el bot publica en el canal que elijas. Puedes tener hasta 10 paneles por servidor, cada uno con hasta 20 entradas de rol.

1
Crea el panel

Dale un título y, opcionalmente, una descripción. Elige el color de la barra lateral del embed entre los ocho presets disponibles.

2
Añade las entradas de rol

Por cada rol que quieras ofrecer: elige un emoji, selecciona el rol de Discord y escribe una etiqueta opcional (si no pones nada, se usa el nombre del rol). Repite hasta 20 veces.

3
Elige el canal y el modo

Selecciona el canal donde se publicará el panel y decide si los roles son acumulables (normal) o exclusivos entre sí (único).

4
Publica

Pulsa "Publicar". El bot envía el embed al canal y añade cada emoji como reacción automáticamente. El panel queda activo de inmediato.

Activa "Mostrar lista de roles" para que el embed incluya qué emoji corresponde a qué rol. Es útil para que los usuarios sepan qué reacción pulsar sin tener que adivinarlo.

Modos

Normal — el usuario puede obtener varios roles del mismo panel sin restricciones. Cada emoji funciona de forma independiente: reaccionar añade el rol, quitar la reacción lo elimina. Ideal para paneles de géneros, idiomas, intereses o colores.
Único — el usuario solo puede tener un rol del panel a la vez. Si reacciona con un segundo emoji, el bot elimina automáticamente el rol y la reacción anterior. Volver a pulsar el mismo emoji quita el rol (comportamiento de toggle). Ideal para paneles de región, equipo o nivel.
El rol del bot debe estar por encima de todos los roles que gestiona en la jerarquía del servidor. Si no, Discord le impedirá asignarlos y el panel no funcionará.

Publicar y actualizar

Al publicar por primera vez el bot envía el embed y añade los emojis como reacciones (con un breve intervalo entre cada uno para respetar los límites de Discord). El ID del mensaje queda guardado automáticamente.

Si después editas el panel y vuelves a publicar, el bot edita el mensaje existente en lugar de crear uno nuevo — así no se pierde el historial de reacciones ni el hilo del canal. El botón cambia de "Publicar" a "Re-publicar" una vez que el panel ya existe en el canal.

Si borras manualmente el mensaje del panel desde Discord, deberás volver al dashboard y publicar de nuevo para regenerarlo en el canal.