Pular para o conteúdo principal

Configuração

O FR Guard funciona perfeitamente sem alterar nada após a instalação. Mas se quiseres ajustar algo, aqui estão as opções mais úteis explicadas em linguagem simples.

Todas as opções vão no teu server.cfg com set <opção> "<valor>".

Opções principais​

fiverank_token (obrigatório)​

A tua API Key. Sem isto o FR Guard não funciona.

set fiverank_token "frk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

fiverank_language — Idioma​

Idioma dos cartões de ligação que os jogadores veem e das notificações do staff.

set fiverank_language "pt"

Valores válidos: es, en, pt, fr, de. (Padrão: es.)

fiverank_fail_open — Se o FiveRank cair​

O que fazer se a API do FiveRank não responder a tempo.

set fiverank_fail_open "1"
  • "1" (recomendado) — O teu servidor continua a funcionar normalmente e deixa os jogadores entrar. A proteção só se perde enquanto durar a falha.
  • "0" — Se a API cair, ninguém entra. Usa isto apenas se preferires "melhor fechar o servidor do que deixar entrar um cheater por engano".

fiverank_debug — Logs detalhados​

set fiverank_debug "0"
  • "0" (normal) — apenas logs importantes.
  • "1" — logs detalhados para cada verificação. Usa só quando estiveres a resolver problemas.

Comportamento avançado (opcional)​

Se quiseres ajustar detalhes mais finos, abre o config.lua dentro de resources/fiverank_guard/.

Permitir jogadores sem Discord aberto?​

O FR Guard identifica os jogadores pela conta de Discord. Se alguém se ligar sem o Discord aberto, não pode ser identificado.

Config.Behavior.failOpenNoDiscord = false  -- recomendado
  • false (recomendado) — Se não tiverem o Discord aberto, não entram. É a única forma de evitar que um cheater feche simplesmente o Discord para contornar o sistema.
  • true — Deixa-os entrar na mesma. Não recomendado.

Atualizar banimentos a cada X minutos​

Se banires alguém no painel web do FiveRank e esse jogador já estiver ligado ao teu servidor, o FR Guard vai expulsá-lo automaticamente na próxima "varredura".

Config.Behavior.banSweepMinutes = 3
  • 3 (recomendado) — bom equilíbrio.
  • 1 — mais rápido mas com mais carga.
  • 0 — desativado (os banimentos só têm efeito quando voltarem a ligar-se).

Rodar o token​

Se achares que o teu token foi comprometido:

  1. Vai a Painel → Servidores → [O teu servidor] → FR Guard.
  2. Clica em Revogar no key atual.
  3. Gera um novo.
  4. Atualiza set fiverank_token no teu server.cfg.
  5. Reinicia o recurso: restart fiverank_guard.
Nunca partilhes o teu token
  • Não carregues o teu server.cfg com o token para o GitHub, Pastebin ou Discord público.
  • Cada token só funciona para um servidor. Não reutilizes tokens em vários servidores.