Docs

Changelog

3.2.0 (01-11-2026)

Anticheat contra menús de trampas reales

Se han analizado, sin ejecutarlos, varios menús de trampas reales para FiveM. Lo que hacen se ha convertido en detecciones nuevas, todas en modo sombra para empezar:

  • Firma del menú en el cliente (client_cheat_signature): Guardian escucha en el juego los eventos internos de un ejecutor de Lua conocido y reconoce el nombre que da al recurso que secuestra.
  • Vehículos de menú (cheat_vehicle): un vehículo creado por un jugador con la matrícula por defecto del menú (SPACE).
  • Spam de eventos (event_spam): los menús repiten en masa eventos de recursos ESX conocidos (facturas, sociedades, revivir, esposar, licencias) con datos basura. Guardian cuenta las llamadas de cada jugador sin interferir con el recurso. La lista se amplía en ServerConfig.EventWatch.
  • Guardian congelado (client_stopped): los menús buscan los anticheats por nombre y los congelan en el PC del tramposo. Si Guardian deja de responder mientras el jugador sigue moviéndose, ya no se confunde con un corte de conexión.
  • Nuevas firmas de variables de menú en shared/signatures.lua.

Documentación

  • README: cómo funcionan los menús analizados y qué ve Guardian de cada cosa, y endurecimiento opcional con sv_entityLockdown.

Actualizar desde 3.1.0

  • Sustituye la carpeta conservando tu config/ o pasa a tu archivo el bloque nuevo EventWatch, Entities.PlateCheckDelayMs, Session.StoppedMoveMetres y las detecciones nuevas de Detections (cheat_vehicle, client_stopped, event_spam, client_cheat_signature).
  • Sin cambios en la base de datos.

3.1.0 (31-10-2026)

Novedades

  • Nueva sección "Vigilancia" (el panel pasa a tener 11 secciones):
    • Buscador de cualquier jugador que haya pasado por el servidor, esté conectado o no, por nombre, personaje, license, Discord o Steam. Desde el resultado se abre su ficha completa y se le puede banear aunque no esté.
    • Lista de vigilancia: marca a un sospechoso con un motivo y Guardian avisa al staff (juego, panel y webhook) cuando entra y con cada detección suya, y guarda captura, caja negra y vídeo de sus detecciones aunque estén en modo sombra. Estar vigilado no sanciona nada.
  • Motivos rápidos de sanción: botones con motivos habituales (trampas, bugs, RDM, VDM, Fail RP, metagaming, toxicidad) en los diálogos de avisar, expulsar y banear. Rellenan el motivo y la duración del baneo. Se configuran en ServerConfig.SanctionPresets.
  • Vídeo de 12 segundos como prueba en cada detección: además de la captura, Guardian graba la pantalla del jugador y lo guarda en el caso. Se ve en Evidencias y se descarga como .webm desde el panel web. La expulsión o el baneo esperan a que el vídeo esté guardado.
  • CCTV con vídeo en directo a 1280x720 y 60 fps sin instalar ni configurar nada: el vídeo pasa por tu propio servidor de juego. Capturas como respaldo automático y WebRTC con TURN como opción avanzada.
  • Escucha de voz desde la ficha del jugador (solo en el juego), con aviso obligatorio al jugador y auditada.
  • Mapa 2D y 3D con imagen satélite de Los Santos de alta resolución y la altura real de cada jugador.
  • País de cada jugador con una base de datos incluida, sin clave ni servicios externos, y globo terráqueo (sección "Mundo", solo el propietario). Detección opcional de VPN y proxy.

Anticheat más duro, sin más falsos positivos

  • Nueva detección de vuelo y noclip en el servidor (noclip): un jugador a pie que sube 20 m en pocos segundos. Escaleras, escaleras de mano, saltos, explosiones, ascensores y buzos no la disparan (25 situaciones legales simuladas, ninguna salta).
  • Nueva señal del cliente de jugador flotando en el aire (client_noclip).
  • Spawn de objetos: además de las ráfagas, se detecta el ritmo sostenido (más de 60 objetos en un minuto).
  • Avisos en el juego también de las detecciones en modo sombra de confianza media o alta: el staff se entera aunque Guardian todavía no sancione.
  • Modo prueba del staff (/guardiantest): el staff está exento de las detecciones y por eso al probar trampas con una cuenta de administrador no saltaba nada. Ahora puedes activar el modo prueba y ver lo que detecta, sin que te pueda sancionar. Al entrar, el staff exento recibe un aviso de que no se le vigila.
  • Heurística de puntería sin falsos positivos: con los umbrales anteriores, 1 de cada 4 jugadores muy hábiles daba positivo. Ahora el patrón debe mantenerse 15 disparos seguidos y los umbrales son más estrictos; en 40 partidas simuladas por perfil ningún jugador legal da positivo y los aimbots se siguen detectando.
  • Nueva detección de tareas forzadas sobre otro jugador (task_on_player): menús que mueven, congelan o sacan del coche a otros.
  • Nuevas detecciones de proyectiles: ráfagas de cohetes o granadas (projectile_spam) y proyectiles disparados en nombre de otro jugador (projectile_for_others).
  • Quitar todas las armas a otro jugador de golpe ahora también se detecta (weapon_to_others).
  • Corregido: las detecciones de spam de partículas y de fuego no saltaban nunca porque escuchaban eventos con el nombre mal escrito.
  • Todas las detecciones nuevas empiezan en modo sombra y con confianza baja o media: registran lo que habrían hecho y no pueden expulsar ni banear por sí solas hasta que tú lo decidas.
  • Escáner de backdoors reforzado tras analizar una infección real (familia 9ns1.com): nombres de archivo con letras falsas, DLL .NET que lanzan programas y archivos de txAdmin modificados, con un resumen claro de "servidor comprometido".

Correcciones

  • CCTV: ya no se ve en negro, no baja a capturas a los pocos segundos, no se corta con el error "(11)" cuando los trozos de vídeo llegan desordenados y no se congela a ratos cuando llegan a ráfagas (el visor amplía su margen solo y muestra el retraso).
  • CCTV: funciona de nuevo después de reiniciar Guardian con jugadores dentro (el juego vuelve a pedir su sesión cada 5 s).
  • CCTV: el vídeo ya no intenta http:// desde el juego, que FiveM bloquea como contenido mixto.
  • Panel del juego: corregida la pantalla gris al abrirlo y retirada una comprobación que llenaba la consola F8.
  • Panel web: ya no se queda en blanco al abrir /guardian sin la barra final.
  • Panel web: la contraseña correcta ya no se rechaza en servidores que devuelven 1 en la comprobación bcrypt, y se ignoran los espacios copiados de la consola.

Documentación

  • README reorganizado: índice, instalación rápida, cómo crear usuarios paso a paso, todos los comandos, convars y exports, qué hace cada sección del panel, tabla de detecciones y solución de problemas.

Actualizar desde 3.0.0

  • Sustituye la carpeta conservando tu config/ (o pasa a tu archivo los bloques nuevos Watchlist, SanctionPresets, Evidence.Video, Projectiles y las detecciones nuevas de Detections).
  • Añade player.watch a los roles que quieras en Roles.Permissions (admin y moderador lo traen por defecto).
  • Las tablas nuevas (guardian_watchlist, guardian_evidence_parts) se crean solas al arrancar. No se borra ni se modifica ningún dato.

3.0.0

Rediseño completo de Guardian 2.

  • Defensa real en el servidor: teletransporte y velocidad con OneSync, vida y blindaje, entidades, explosiones, armas, daño, cadencia y alcance por arma, eventos trampa, saturación y falsificación de eventos.
  • Señales de cliente con peso bajo y tope de puntos: nunca expulsan ni banean solas.
  • Puntuación de riesgo con peso, confianza y caducidad; modos por detección cambiables en vivo; modo sombra.
  • Baneos automáticos pendientes de revisión; los de confianza media o baja no se aplican sin el staff.
  • Evidencias por detección: instantánea, recorrido del servidor, captura y caja negra con reproducción 2D.
  • Panel nuevo compartido por el juego y el navegador, con roles, auditoría, tema oscuro y claro, español e inglés.
  • Panel web seguro: contraseñas con hash, sesiones con caducidad, CSRF, bloqueo por intentos, CSP y verificación en dos pasos.
  • Compatible con QBCore, Qbox, ESX o sin framework.
  • Seguridad: retirado el screenshot-basic incluido en Guardian 2, que contenía un backdoor; eliminada la cuenta admin/admin123.
  • Los baneos de Guardian 2 siguen funcionando; la migración de la base de datos solo añade.