Cómo configurar roles por reacción en Discord

Antes de empezar

• Necesitas un bot conectado, Pro o la prueba de Pro de 14 días, y el permiso Gestionar roles en tu propia cuenta para usar los comandos del módulo.
• El bot necesita Gestionar roles y tener su rol por encima de los que asignará. En el canal del panel necesita enviar mensajes, insertar enlaces, añadir reacciones y leer el historial.
• Prepara una segunda cuenta sin roles de personal. No publiques roles que otorguen permisos de moderación o acceso privado.

1. Configura los valores predeterminados del panel

   Abre tu bot, entra en «Módulos» y activa el módulo. Abre su configuración con el botón de engranaje y elige tu «Servidor». El bot debe estar conectado y dentro del servidor para cargar sus canales y roles. Los ajustes se guardan por servidor.

   Comprueba «Activar Roles por Reacción». Si está desactivado, el bot ignora las reacciones y no abre el asistente. «Canal de Panel Predeterminado» es opcional: elige un canal para omitir ese paso en el asistente o déjalo sin seleccionar para decidir cada vez.

   Edita «Título de Panel Predeterminado», «Descripción de Panel Predeterminada» y «Color del Embed del Panel». «Máximo de Roles por Panel» admite de 1 a 20 pares de emoji y rol. Pulsa «Guardar Configuración» y espera a ver «Guardado ✓». Si aparece un aviso de error de sincronización, reinicia el bot desde su página y espera a que vuelva a estar conectado antes de probarlo.

2. Decide qué pasa al quitar una reacción

   «Permitir Quitar el Rol al Quitar la Reacción» está activado por defecto. Al quitar la reacción se retira también el rol. Si lo desactivas, el rol se conserva. El texto de un panel antiguo no cambia automáticamente al guardar esta opción; revisa los paneles publicados.

   «MD al Cambiar de Rol» envía un mensaje privado cuando se concede un rol, no cuando se retira. Si el miembro tiene los mensajes privados cerrados, puede recibir el rol igualmente. Explica este comportamiento a tu comunidad para que un MD ausente no parezca un fallo de asignación.

3. Diseña el panel y añade los roles

   Ejecuta !reactionrole o !rr con el prefijo del bot. El asistente te deja elegir el canal si no hay uno predeterminado y personalizar el título y la descripción o continuar con los valores guardados. El asistente pertenece a la persona que lo inició.

   Selecciona un rol y su emoji, y repite para los demás. El menú omite @everyone, los roles gestionados por integraciones y los que están por encima del bot. Cada emoji se usa una sola vez por panel. Revisa la vista previa y termina la creación para publicar el mensaje y sus reacciones.

   El menú no comprueba si los permisos de un rol son apropiados para todos los miembros. Esa decisión es tuya. Usa roles de intereses o notificaciones y revisa su acceso antes de publicarlos.

4. Añade roles a un mensaje existente con cuidado

   rradd permite asociar un emoji y un rol a un mensaje existente. Por ejemplo: !rradd #roles 123456789012345678 🎮 @Juegos. Sustituye el ID de ejemplo por el del mensaje real. El nombre rradd se mantiene en inglés; el canal y el rol son los de tu servidor.

   Repetir el mismo emoji puede cambiar el rol al que apunta. A diferencia del asistente, rradd no comprueba la jerarquía al añadir el par, así que prueba cada asignación. Usa emojis estándar o personalizados estáticos: los animados no se reconocen en este flujo.

5. Prueba añadir y quitar el rol

   Desde la cuenta de prueba, reacciona al panel y comprueba el rol en Discord. Retira la reacción y, si está permitida la eliminación, comprueba que el rol desaparece. Las reacciones de cuentas de bots se ignoran.

   Si no ocurre nada, revisa el interruptor del módulo, Gestionar roles, la posición del rol del bot y que el emoji coincida exactamente. Cambiar la jerarquía puede resolver el problema sin recrear el panel. No pruebes solo con una cuenta que ya tenga el rol.

6. Mantén los paneles y revisa el plan

   listroles o rrlist muestra los paneles del servidor. El asistente permite editar un panel existente. deleterole, rrdelete y removerole eliminan su configuración y pueden borrar el mensaje original: guarda su texto antes, especialmente si añadiste roles a un mensaje de normas. Los roles ya concedidos permanecen.

   rrsettings permite consultar y cambiar los valores predeterminados. El módulo requiere Pro: si termina la prueba de Pro de 14 días sin pasar a Pro, se desactiva y las reacciones dejan de asignar o retirar roles. Se conservan los ajustes y los miembros mantienen los roles que ya tenían.