Docs

Cómo decide Guardian

  1. Una detección se dispara y suma weight puntos al riesgo del jugador. Los puntos pierden la mitad de su valor cada decayHours.
  2. Las señales de cliente suman como máximo Scoring.ClientCap puntos en total (20 por defecto, por debajo de la expulsión).
  3. Con el riesgo acumulado, la acción es: aviso desde WarnAt (25), expulsión desde KickAt (60) y baneo desde BanAt (100) si además hay al menos BanMinServerPoints (60) puntos de servidor. Sin puntos de servidor nunca hay expulsión ni baneo.
  4. El modo de la detección es el techo: una detección en modo warn nunca expulsa aunque el riesgo sea 300. Aunque una detección solo registre (modo sombra o riesgo bajo), el staff conectado recibe un aviso en el juego si es de confianza media o alta (StaffAlerts.QuietDetections).
  5. Baneo automático: si la detección es de confianza alta se aplica y queda "aplicado, pendiente de revisión"; si es de confianza media o baja no se aplica, se abre un caso "pendiente de revisión" y se avisa al staff.
  6. Antes de expulsar o banear, Guardian espera a que lleguen la captura, la caja negra y el vídeo de esa detección.

Interpretar la puntuación

  • 0-24: normal. Puede haber señales sueltas de cliente o falsos positivos aislados.
  • 25-59: el staff recibe aviso. Mira la detección, sus evidencias y si es servidor o cliente.
  • 60-99: con evidencia de servidor puede expulsar (si el modo lo permite).
  • 100 o más con 60 puntos de servidor: candidato a baneo.
  • "Confianza" (columna del panel) es 100 menos el riesgo expresado como porcentaje de BanAt: 100 sin riesgo, 0 en el umbral de baneo.

Modo sombra

Casi todas las detecciones empiezan en log: se registran y el panel muestra qué habría hecho Guardian (columna "Haría") sin hacer nada. Déjalas así unos días, mira los resultados en Detecciones filtrando por "sombra" y sube el modo solo de las que no den falsos positivos en tu servidor. Los cambios se hacen en vivo desde Configuración, quedan en la base de datos y en la auditoría, y se pueden restablecer al valor del archivo.

Revisión de casos y baneos pendientes

  • Detecciones > filtro "Pendiente de revisión". Abre el caso y revisa los detalles, la instantánea, el recorrido del servidor, la caja negra, la captura y el vídeo.
  • "Confirmar trampa": el caso se cierra y el baneo automático, si lo hay, se mantiene.
  • "Descartar" (motivo obligatorio): se retiran los puntos de esa detección y se levanta el baneo automático asociado.
  • En Baneos, los automáticos pendientes aparecen como "Aplicado, pendiente de revisión" y se pueden confirmar o levantar (con motivo obligatorio).

Ventanas de gracia y exenciones

No hay detecciones de movimiento al entrar, al reaparecer, al cambiar de instancia, de vehículo o de modelo, ni tras observar a alguien (tiempos en ServerConfig.Grace). Las caídas largas, el paracaídas y los vehículos rápidos tienen sus propios límites en ServerConfig.Movement. Para tus scripts:

  • Teletransportes propios: exports.guardian:AllowTeleport(source, segundos) justo antes de mover al jugador.
  • Zonas con saltos esperados (ascensores de MLO): ServerConfig.Movement.IgnoreAreas.
  • Puertas de interiores que teletransportan sin avisar: Guardian aprende los puntos a los que saltan varios jugadores distintos (LearnedTeleports).
  • Creador de personaje o cámaras de tiendas: devuelve true en ClientEditable.IsLegitimatelyHidden() mientras estén activos.