Solución de problemas

El servidor se apaga 10 segundos después de arrancar

SafeGuard no tiene una licencia válida. La consola muestra el motivo en rojo:

• no license key: falta safeguard_license_key o safeguard_cloud_url en server.cfg (con set).
• the license key is invalid: la clave está mal copiada o se ha rotado. Copia la clave actual de Licencias.
• the license is revoked or suspended: la licencia se ha revocado o suspendido en el panel.
• the license has expired: renuévala en Licencias.

Para que el servidor se apague con el comando quit normal (en vez de terminar el proceso), añade a server.cfg: add_ace resource.safeguard command.quit allow.

El servidor no aparece en el panel

• En la consola, sg status debería decir cloud=Connected.
• cloud=Disabled: falta safeguard_cloud_url o safeguard_license_key en server.cfg (con set).
• cloud=Rejected: clave incorrecta, caducada o revocada, o ya activa en otra máquina. En Licencias, comprueba su estado y usa Restablecer activación si has cambiado de máquina.
• cloud=Connecting durante mucho tiempo: el servidor no llega a la dirección de la API. Comprueba la dirección y el cortafuegos de salida del servidor.

SafeGuard no arranca (dependencia /onesync)

El resource necesita OneSync. Actívalo (set onesync on o en txAdmin) y reinicia el servidor.

No se detecta el framework

sg framework muestra el adaptador elegido. Asegúrate de que ensure safeguard va después del framework. Las bases vRPex/creative necesitan Config.Framework = 'vrpex'.

El staff recibe detecciones

Comprueba que tiene safeguard.bypass (ACE) o uno de los permisos de Config.Staff.FrameworkPermissions. sg staff muestra quién está exento y por qué.

Falsos "teleport" al entrar en casas, garajes o la cárcel

Desde la versión 1.3.1, ir y volver entre los mismos sitios (puerta, vestíbulo, apartamento) ya no cuenta como patrón de teletransporte. Si la detección continúa, tienes dos opciones:

• Sin tocar el script: abre la detección, copia las coordenadas de from y to y añade la puerta o el interior a Config.TransitionZones en config.lua. Un salto que empiece o acabe en esa área no cuenta. Usa áreas pequeñas, de unos 10 m.
• En el script del servidor: añade el recurso a Config.MovementPermissionResources y llama a exports.safeguard:allowTeleport(source, 5000, 'apartamento') antes del teletransporte (consulta Scripts e integraciones). Sin el recurso en esa lista, la llamada se rechaza.

Bajar la sensibilidad de movement.teleport también funciona, pero afecta a todo el servidor.

Espectar va lento o las capturas no llegan

• El jugador tiene que tener SafeGuard funcionando en su juego (se muestra en En directo y en el menú F10).
• Las imágenes van directamente a la dirección HTTP de tu servidor FiveM. Si tu servidor no es accesible por HTTP, se usa un camino más lento. En la consola, spectate.stats muestra las imágenes por segundo y en qué se va el tiempo; envíanos esa línea en Discord.
• Con una conexión débil del jugador, usa Equilibrado o Detalle.

Una detección salta sin motivo

Consulta Detecciones → Falsos positivos.

Soporte

Háblanos en Discord o por correo en equipa@safeguardac.online. Incluye la versión (sg status), el framework y, si puedes, las líneas de la consola.