Pular para o conteúdo principal

Problemas comuns

Se algo não está a funcionar, começa aqui. A maioria dos problemas resolve-se em 30 segundos.

O recurso não inicia​

Se vires isto na consola:

Couldn't find resource fiverank_guard

Solução:

  1. Verifica que a pasta está no sítio certo: resources/fiverank_guard/fxmanifest.lua
  2. Verifica que o teu server.cfg tem a linha ensure fiverank_guard.

"Token inválido"​

Se vires isto:

[FiveRank Guard] INVALID_TOKEN — o token não existe ou foi revogado.

Soluções:

  1. Verifica que o token está corretamente escrito no server.cfg (sem espaços, aspas bem fechadas).
  2. Gera um novo token em Painel → FR Guard → Gerar nova API Key e substitui no server.cfg.
  3. Cada token só funciona para um servidor. Se copiaste um token de outro servidor, não vai funcionar.

"Servidor não verificado"​

Se vires isto:

[FiveRank Guard] NOT_VERIFIED_OWNER — este servidor não está verificado.

Solução:

O FR Guard só funciona em servidores verificados. Vai a Painel → Servidores → [O teu servidor] → Verificar e completa o processo de verificação.

Todos os jogadores estão a ser rejeitados​

Se ninguém consegue entrar no servidor:

  1. Verifica se diz "Discord necessário". Os teus jogadores provavelmente não têm o Discord aberto. Informa-os de que devem abrir o Discord antes de ligar.
  2. Verifica que o teu VPS tem acesso à internet. Do teu VPS executa: 
    curl -I https://fiverank.gg
    Deve responder HTTP/2 200. Se não, é um problema de firewall do teu alojamento.
  3. Garante que tens set fiverank_fail_open "1" para que um problema temporário não bloqueie toda a gente.

O cartão de ligação fica preso​

Se o cartão "A verificar a tua reputação…" nunca avança:

  • O teu servidor não consegue contactar fiverank.gg. Isto é quase sempre a firewall do alojamento a bloquear HTTPS de saída. Pede ao teu fornecedor para abrir a porta 443 de saída.
  • Se usas uma rede privada (Pterodactyl, Docker), verifica que tens acesso à internet de saída a partir do contentor.

Quero ver mais logs para perceber o que está a acontecer​

Ativa os logs detalhados temporariamente:

set fiverank_debug "1"

Reinicia o recurso. Agora vais ver cada verificação na consola:

[FiveRank Guard] [debug] a ligar: Carlos (270...)
[FiveRank Guard] [debug] discord = 123456789012345678
[FiveRank Guard] [debug] cache miss → resposta em 142ms → permitido

Quando terminares, desativa novamente (set fiverank_debug "0") para manter os logs limpos.

Continua a não funcionar​

Não fiques preso. Entra no Discord e nós ajudamos em menos de 24 horas:

Quando pedires ajuda, junta:

  1. Screenshot da consola com fiverank_debug ativado.
  2. O teu server.cfg (esconde o token antes de enviar).
  3. Que framework estás a usar (ESX, QBCore, etc.).