Cómo crear una clasificación de facciones con XP de mensajes

Antes de empezar

• Ten un bot conectado a tu servidor de Discord, con acceso Pro y XP de facción activado.
• Roles de Discord existentes para representar las facciones, con cada participante asignado a exactamente uno de esos roles.
• Necesitas el permiso Gestionar servidor o el rol gestor configurado para añadir, eliminar o restablecer facciones. El bot debe poder ver los canales donde esperas que cuenten los mensajes.

1. Activa la puntuación y define un tiempo de espera por miembro

   Abre el área de Módulos de tu bot, activa XP de facción y abre su configuración. Selecciona el servidor de Discord correspondiente, activa «Activar en este servidor» y guarda. La puntuación está desactivada de forma predeterminada en cada servidor. Elige, si quieres, «Rol de gestión (opcional)» para quien deba gestionar facciones sin Gestionar servidor.

   Define «XP por mensaje» de 1 a 100 y «Espera por miembro (segundos)» de 15 a 3600. Los valores predeterminados son 10 XP y 60 segundos. El tiempo de espera se aplica a un miembro en todas las facciones de ese servidor, así que cambiar de rol de facción no lo evita. Explica tus reglas de participación antes de invitar a los miembros a competir.

2. Registra roles existentes como facciones

   Usa /faction add y elige la opción role para cada facción. Puedes registrar hasta 10 roles por servidor. Cada facción recién registrada empieza en cero XP. El módulo rechaza @everyone, los roles gestionados por una integración y los roles que no sean válidos para este servidor; registrar el mismo rol otra vez no reinicia su puntuación.

   Añadir una facción registra el rol para la puntuación. No crea un rol ni asigna miembros a él. Da a los participantes su rol de facción con las herramientas de roles de Discord o tu flujo de roles habitual. Un miembro sin ningún rol de facción registrado no gana nada; un miembro con varios roles de facción registrados tampoco gana nada. Mantén a tu participante de prueba en exactamente una facción.

3. Comprueba qué mensajes suman puntos

   Con el bot en marcha, envía un mensaje nuevo desde una cuenta de prueba humana en un canal que el bot pueda ver. Consulta /faction leaderboard para ver el total de la facción. Envía otro mensaje durante el tiempo de espera del miembro; no debería sumar puntos. Cuando termine el tiempo de espera, un nuevo mensaje puede volver a sumar la XP configurada.

   Los mensajes de bots, webhooks y los mensajes del sistema no suman XP. El módulo también descarta eventos de mensaje obsoletos y no recupera mensajes enviados mientras estaba desconectado. Lee la pertenencia a roles, no el contenido del mensaje. Enviar mensajes más largos no aumenta la XP otorgada por mensaje.

   Solo aumenta el total de la facción; el módulo no mantiene una clasificación de contribución individual. Los puntos ya ganados se quedan en la facción si el miembro cambia de equipo o se va. La puntuación y los tiempos de espera por miembro se guardan, así que reiniciar el bot no los reinicia.

4. Consulta la clasificación guardada del servidor

   Cualquier miembro puede usar /faction leaderboard mientras el módulo esté activo. La respuesta privada muestra las facciones registradas, sus totales de XP y los ID de rol, ordenados de mayor a menor puntuación. Las puntuaciones iguales se ordenan por ID de rol, no por un desempate de competición aparte. La respuesta no menciona los roles.

   Si una puntuación no cambia, revisa la pertenencia a roles: confirma que el miembro tiene exactamente un rol de facción registrado, que el tiempo de espera ya terminó, que el bot puede ver el canal y que ambos interruptores del módulo están activos. También hay un límite de 1.000 millones de XP por facción. Desactivar el módulo pausa la puntuación y los comandos, pero conserva las puntuaciones.

5. Elimina una facción o inicia un restablecimiento manual

   Usa /faction remove con id igual al ID de rol de la facción en la clasificación. Esto elimina de forma permanente la puntuación guardada de esa facción, aunque el rol de Discord ya se haya borrado. Deja los roles y las pertenencias de Discord sin cambios. Volver a registrar el rol empieza una puntuación nueva en cero; los tiempos de espera de los miembros se mantienen.

   Para un reinicio deliberado, un gestor puede usar /faction reset con confirm en true. Esto pone en cero, de forma permanente, la puntuación de todas las facciones registradas del servidor. Mantiene los registros y los tiempos de espera de los miembros. No hay opción de deshacer para los puntos acumulados. Las competiciones mensuales opcionales conservan puntos y resultados mensuales separados; restablecer los totales no los borra.

   Para resultados mensuales, registra primero todos los roles, activa Competiciones mensuales en los ajustes y usa /faction monthly o /faction history. El primer mensaje válido o comando mensual inicia el seguimiento y fija los participantes; los roles nuevos entran el mes siguiente. Los meses terminan el día uno a las 00:00 UTC y cambian con el siguiente mensaje válido o comando mensual. Se guardan los últimos 12 meses completados, sin recuperar mensajes anteriores. Gestiona las recompensas por separado. La XP de niveles individual sigue siendo un módulo aparte y no se convierte en puntos de facción.