Comunidad y gestión
Seguimiento de invitaciones
Ganyu atribuye cada llegada al miembro cuyo enlace de invitación se usó, lleva un contador por invitador y recompensa a los mejores con roles. El seguimiento está desactivado por defecto y se configura con /invites config o desde la pestaña Invitaciones del El dashboard web.
Por el equipo de Ganyu Actualizado el
Activar el seguimiento
Activa el seguimiento con /invites config enabled:True o con el interruptor de la pestaña Invitaciones del dashboard. Al activarlo, Ganyu lee de inmediato los enlaces del servidor: es el estado inicial con el que se compara cada llegada.
Ganyu necesita el permiso Gestionar servidor: sin él, Discord se niega a darle la lista de invitaciones y las llegadas no se pueden atribuir. El dashboard muestra entonces un aviso con un botón «Volver a comprobar», y /invites show también lo indica. Las creaciones y eliminaciones de enlaces llegan por el intent de invitaciones de Discord, que no es privilegiado: no hay nada que activar por tu parte.
Consejo — Tras devolver el permiso, usa /invites sync (o «Volver a comprobar» en el dashboard) para leer los enlaces al instante.
Cómo se atribuye una llegada
Discord nunca dice qué enlace se usó. Ganyu compara el número de usos de cada enlace justo antes y justo después de la llegada: el enlace cuyo contador subió designa al invitador. Algunas llegadas no se pueden atribuir:
- Enlace personalizado (vanity): la llegada se registra como tal, sin invitador.
- Desconocida: ningún contador cambió (enlace eliminado entretanto, estado inicial perdido).
- Ambigua: varios enlaces se usaron en el mismo instante; en lugar de adivinar, no se atribuye a nadie.
- Enlace de un solo uso: Discord lo elimina en cuanto se usa; Ganyu lo reconoce cuando estaba a un uso de su límite justo antes.
- Bot: un bot añadido por autorización no usa ningún enlace y no se atribuye a nadie.
- Falta un permiso: la llegada ocurrió cuando Ganyu no tenía Gestionar servidor.
Regla de cálculo
total = llegadas + bonus − salidas − cuentas falsas. Un miembro solo cuenta una vez por invitador, aunque se vaya y vuelva varias veces por sus enlaces; sus regresos se muestran a título informativo.
Una cuenta más joven que el umbral de «cuenta reciente» (7 días por defecto, ajustable de 1 a 90 días) al llegar cuenta como falsa y resta una invitación. Un miembro contado que abandona el servidor pasa a ser una salida. Si vuelve por el enlace de otro miembro, se atribuye a este último y cuenta como salida para el primer invitador.
El total no tiene mínimo: bonus retirados o cuentas falsas pueden volverlo negativo.
Los comandos
show, leaderboard, who y codes están abiertos a todos. bonus, reset, sync, config y rewards requieren el permiso Gestionar servidor.
/invites show [member] Total de invitaciones de un miembro (tú por defecto), con llegadas, salidas, cuentas falsas, regresos y bonus.
/invites leaderboard [period] Clasificación de invitadores, desde siempre o en 30 días, 7 días o 24 horas, de 10 en 10.
/invites who <member> Quién invitó a este miembro, con qué enlace y cuándo.
/invites codes [member] Enlaces de invitación activos de un miembro y sus usos.
/invites bonus add <member> <amount> [reason] Añade invitaciones bonus (de 1 a 10 000) a un miembro.
/invites bonus remove <member> <amount> [reason] Quita invitaciones bonus a un miembro.
/invites reset [member] Borra el historial de un miembro, o de todo el servidor sin miembro, tras un botón de confirmación. Definitivo.
/invites sync Vuelve a leer los enlaces del servidor en Discord y comprueba el permiso.
/invites config <enabled> [fake_days] [log_channel] [log_off] Activa o desactiva el seguimiento, fija el umbral de cuentas recientes (de 1 a 90 días) y el canal de registro; log_off quita el canal.
/invites rewards add <role> <invites> Otorga un rol a partir de un número de invitaciones (de 1 a 10 000).
/invites rewards remove <role> Quita un rol de los niveles. Los miembros que lo tienen lo conservan.
/invites rewards list Lista los niveles, el modo y el límite de tu plan.
/invites rewards mode <mode> stack acumula todos los niveles alcanzados, replace solo conserva el más alto.
Roles por nivel
Un rol de nivel se otorga en cuanto el total de invitaciones alcanza su umbral, y se retira si el total baja de él. Solo se tocan los roles configurados como niveles: un rol dado a mano nunca se retira. El rol no puede ser @everyone, ni un rol gestionado por una integración, ni un rol situado por encima del de Ganyu.
| Límite | FREE | PREMIUM | PRO |
|---|---|---|---|
| Roles por nivel | 3 | 10 | 25 |
Consejo — Los niveles también se gestionan en la pestaña Invitaciones del dashboard, con el contador de niveles usados sobre el límite de tu Premium.
En el dashboard
La pestaña Invitaciones reúne la activación, el umbral de cuentas recientes, el canal de registro, el modo y el editor de niveles, la clasificación por periodo y el historial de llegadas y salidas. El historial se filtra por miembro, invitador, tipo, origen y periodo, y se exporta en CSV (como máximo los 50 000 eventos más recientes).
Mensajes de bienvenida y canal de registro
Los mensajes de bienvenida y despedida aceptan {inviter} (mención del invitador), {inviterName} (su nombre), {inviteCode} (el código del enlace) y {inviterInvites} (su total). Cuando la llegada no se atribuye o el seguimiento está desactivado, una etiqueta neutra sustituye la variable. Ver Roles automáticos y bienvenida.
El canal de registro, elegido con /invites config log_channel o en el dashboard, anuncia cada llegada y salida con su invitador.
Requisito de invitaciones para los sorteos
Una plantilla de sorteo puede exigir un número mínimo de invitaciones para participar. Mientras el seguimiento esté desactivado en el servidor, la participación en ese sorteo se rechaza en lugar de aceptarse sin control. Ver Sorteos.
Datos y privacidad
Ganyu registra las llegadas y salidas (miembro, invitador, código del enlace, fecha) y los bonus. Estos datos se eliminan con el resto de datos del servidor 30 días después de que el bot se vaya. Cada miembro puede exportar o borrar sus datos desde la página Privacidad de su cuenta en ganyu.fr; el comando /privacy gestiona el seguimiento de actividad.
Preguntas frecuentes
¿Por qué una llegada es «desconocida»?
Ningún contador de enlace cambió entre las dos lecturas: el enlace pudo eliminarse justo antes, o faltaba la lectura inicial. Usa /invites sync para partir de un estado actualizado.
¿El enlace personalizado del servidor cuenta para alguien?
No. Una llegada por el enlace personalizado (vanity) se registra como tal y no se atribuye a ningún miembro.
¿Qué pasa si un miembro invitado se va y vuelve?
Solo cuenta una vez para su invitador. Si vuelve por el enlace de otro miembro, se atribuye a este último y el primer invitador lo cuenta como salida.
¿Cómo exigir invitaciones para un sorteo?
Fija un mínimo de invitaciones en una plantilla de sorteo del dashboard. El seguimiento debe estar activado; si no, la participación se rechaza.
¿Cuántos roles por nivel puedo crear?
3 en FREE, 10 en PREMIUM y 25 en PRO. Ver Premium.
Fuentes y documentación oficial
Comunidad y gestión
¿Listo para probar Ganyu?
Añade Ganyu a tu servidor de Discord gratis y pon en práctica esta guía en menos de un minuto.
Añadir Ganyu gratis