SafeGuard

Instalação

Requisitos

  • FXServer recente com OneSync ativo (set onesync on, ou a opção OneSync no txAdmin). Sem OneSync o servidor não vê as entidades, os danos e as posições em que as deteções se baseiam.
  • Um framework suportado ou nenhum: ESX, QBCore, Qbox, vRP, vRPex (creative) ou standalone. Ver Frameworks.
  • Nenhuma instalação nos jogadores: o SafeGuard descarrega sozinho o que o jogo precisa.

1. Transferir

Com sessão iniciada no dashboard, abre Servidores → Transferir o SafeGuard e descarrega a versão mais recente. Os pacotes são assinados; não uses cópias de outros sítios.

2. Copiar para o servidor

Extrai a pasta safeguard para dentro de resources, por exemplo:

resources/
  [safeguard]/
    safeguard/
      fxmanifest.lua
      config.lua
      SafeGuard.Server.net.dll
      ...

O nome da pasta tem de ser safeguard.

3. server.cfg

Adiciona as linhas abaixo depois do framework (por exemplo, depois de ensure es_extended, ensure qb-core ou ensure vrp) e antes dos teus outros scripts:

# SafeGuard
set safeguard_cloud_url "https://api.safeguardac.pt"
set safeguard_license_key "alk_xxxxxxxx.xxxxxxxx"
add_ace group.admin safeguard.admin allow     # comandos sg e menu de staff (F10)
add_ace group.admin safeguard.bypass allow    # a staff não é pontuada nem punida
ensure safeguard
Usa sempre set, nunca `setr`: o setr envia o valor para todos os jogadores, e a chave de licença é um segredo.

As duas primeiras linhas são obrigatórias. Sem uma licença válida o SafeGuard não funciona: sem chave, com uma chave inválida ou com a licença revogada ou expirada, desliga a proteção, avisa na consola e o servidor desliga-se 10 segundos depois. Se a SafeGuard Cloud estiver inacessível (rede, manutenção), o servidor continua a funcionar e protegido. A chave de licença obténs no dashboard, em Licenças (ver Dashboard).

4. Arrancar e confirmar

Reinicia o servidor (ou refresh e ensure safeguard). Na consola deves ver:

[safeguard] INFO  started version=… framework=… cloud=Connected

Escreve sg status na consola para ver o estado: modo, jogadores, deteções e fila. Se aparecer cloud=Rejected, a chave está errada ou já está em uso noutra máquina (ver Resolução de problemas).

Atualizar

Quando sair uma versão nova, o dashboard mostra-o na página do servidor. Substitui a pasta safeguard mantendo o teu config.lua e a pasta data (banimentos locais e fila offline), e faz restart safeguard.