Resolução de problemas

O servidor desliga-se 10 segundos depois de arrancar

O SafeGuard não tem uma licença válida. A consola diz porquê, a vermelho:

• no license key: falta safeguard_license_key ou safeguard_cloud_url no server.cfg (com set).
• the license key is invalid: a chave foi mal copiada ou foi rodada. Copia a chave atual em Licenças.
• the license is revoked or suspended: a licença foi revogada ou suspensa no dashboard.
• the license has expired: renova-a em Licenças.

Para o servidor desligar com o comando quit normal (em vez de o processo ser terminado), acrescenta ao server.cfg: add_ace resource.safeguard command.quit allow.

O servidor não aparece no dashboard

• Na consola, sg status deve mostrar cloud=Connected.
• cloud=Disabled: faltam safeguard_cloud_url ou safeguard_license_key no server.cfg (com set).
• cloud=Rejected: chave errada, expirada, revogada ou já ativa noutra máquina. Em Licenças, confirma o estado e usa Repor ativação se mudaste de máquina.
• cloud=Connecting durante muito tempo: o servidor não chega ao endereço da API. Confirma o endereço e a firewall de saída do servidor.

O SafeGuard não arranca (dependência /onesync)

O recurso exige OneSync. Ativa-o (set onesync on ou no txAdmin) e reinicia o servidor.

O framework não foi detetado

sg framework mostra o adaptador escolhido. Confirma que ensure safeguard vem depois do framework. Bases vRPex/creative precisam de Config.Framework = 'vrpex'.

A staff está a ser detetada

Confirma que tem safeguard.bypass (ACE) ou uma das permissões em Config.Staff.FrameworkPermissions. sg staff mostra quem está isento e porquê.

Falsos "teleport" ao entrar em casas, garagens ou na prisão

A partir da versão 1.3.1, ir e voltar entre os mesmos sítios (porta, átrio, apartamento) já não conta como padrão de teleporte. Se a deteção continuar, tens duas opções:

• Sem mexer no script: abre a deteção, copia as coordenadas de from e to e adiciona a porta ou o interior a Config.TransitionZones no config.lua. Um salto que comece ou acabe nessa área não conta. Usa áreas pequenas, com cerca de 10 m.
• No script do servidor: adiciona o recurso a Config.MovementPermissionResources e chama exports.safeguard:allowTeleport(source, 5000, 'apartamento') antes do teleporte (ver Scripts e integrações). Sem o recurso nessa lista, a chamada é recusada.

Baixar a sensibilidade de movement.teleport também resolve, mas afeta todo o servidor.

O spectate está lento ou as capturas não chegam

• O jogador tem de ter o SafeGuard a correr no jogo (vês isso em Ao vivo e no menu F10).
• As imagens vão diretamente para o endereço HTTP do teu servidor FiveM. Se o teu servidor não estiver acessível por HTTP, é usado um caminho mais lento. Na consola, spectate.stats mostra as imagens por segundo e onde o tempo é gasto; envia-nos essa linha no Discord.
• Com internet fraca do jogador, usa o modo Equilibrado ou Detalhe.

Uma deteção dispara sem razão

Ver Deteções → Falsos positivos.

Suporte

Fala connosco no Discord ou por e-mail em equipa@safeguardac.online. Inclui a versão (sg status), o framework e, se possível, as linhas da consola.