Aller au contenu principal

Configuration

FR Guard fonctionne parfaitement sans rien changer après l'installation. Mais si tu veux ajuster quelque chose, voici les options les plus utiles expliquées en langage simple.

Toutes les options vont dans ton server.cfg avec set <option> "<valeur>".

Options principales​

fiverank_token (obligatoire)​

Ta clé API. Sans ça, FR Guard ne fonctionne pas.

set fiverank_token "frk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

fiverank_language — Langue​

Langue des cartes de connexion que les joueurs voient et des notifications staff.

set fiverank_language "fr"

Valeurs valides : es, en, pt, fr, de. (Défaut : es.)

fiverank_fail_open — Si FiveRank tombe​

Que faire si l'API FiveRank ne répond pas à temps.

set fiverank_fail_open "1"
  • "1" (recommandé) — Ton serveur continue à fonctionner normalement et laisse entrer les joueurs. La protection est perdue seulement pendant la durée de la panne.
  • "0" — Si l'API tombe, personne n'entre. Utilise ça uniquement si tu préfères « mieux fermer le serveur que laisser entrer un cheater par erreur ».

fiverank_debug — Logs détaillés​

set fiverank_debug "0"
  • "0" (normal) — seulement les logs importants.
  • "1" — logs détaillés pour chaque vérification. À utiliser seulement quand tu débogues.

Comportement avancé (optionnel)​

Si tu veux régler des détails plus fins, ouvre config.lua dans resources/fiverank_guard/.

Autoriser les joueurs sans Discord ouvert ?​

FR Guard identifie les joueurs par leur compte Discord. Si quelqu'un se connecte sans Discord ouvert, il ne peut pas être identifié.

Config.Behavior.failOpenNoDiscord = false  -- recommandé
  • false (recommandé) — S'ils n'ont pas Discord ouvert, ils ne peuvent pas entrer. C'est le seul moyen d'empêcher un cheater de simplement fermer Discord pour contourner le système.
  • true — Les laisser entrer quand même. Non recommandé.

Actualiser les bans toutes les X minutes​

Si tu bans quelqu'un depuis le panneau web FiveRank et que ce joueur est déjà connecté à ton serveur, FR Guard l'expulsera automatiquement lors du prochain « scan ».

Config.Behavior.banSweepMinutes = 3
  • 3 (recommandé) — bon équilibre.
  • 1 — plus rapide mais plus de charge.
  • 0 — désactivé (les bans ne prennent effet que lors de la reconnexion).

Renouveler ton token​

Si tu penses que ton token a été compromis :

  1. Va dans Panneau → Serveurs → [Ton serveur] → FR Guard.
  2. Clique sur Révoquer sur la clé actuelle.
  3. Génères-en une nouvelle.
  4. Mets à jour set fiverank_token dans ton server.cfg.
  5. Redémarre la ressource : restart fiverank_guard.
Ne partage jamais ton token
  • Ne télécharge pas ton server.cfg avec le token sur GitHub, Pastebin ou Discord public.
  • Chaque token ne fonctionne que pour un seul serveur. Ne réutilise pas les tokens sur plusieurs serveurs.