Aller au contenu principal

Problèmes courants

Si quelque chose ne fonctionne pas, commence ici. La plupart des problèmes se règlent en 30 secondes.

La ressource ne démarre pas​

Si tu vois ça dans la console :

Couldn't find resource fiverank_guard

Solution :

  1. Vérifie que le dossier est au bon endroit : resources/fiverank_guard/fxmanifest.lua
  2. Vérifie que ton server.cfg a la ligne ensure fiverank_guard.

"Token invalide"​

Si tu vois ça :

[FiveRank Guard] INVALID_TOKEN — le token n'existe pas ou a été révoqué.

Solutions :

  1. Vérifie que le token est correctement saisi dans server.cfg (sans espaces, guillemets bien fermés).
  2. Génère un nouveau token dans Panneau → FR Guard → Générer une nouvelle clé API et remplace-le dans server.cfg.
  3. Chaque token ne fonctionne que pour un serveur. Si tu as copié un token d'un autre serveur, ça ne marchera pas.

"Serveur non vérifié"​

Si tu vois ça :

[FiveRank Guard] NOT_VERIFIED_OWNER — ce serveur n'est pas vérifié.

Solution :

FR Guard ne fonctionne que sur les serveurs vérifiés. Va dans Panneau → Serveurs → [Ton serveur] → Vérifier et complète le processus de vérification.

Tous les joueurs sont rejetés​

Si personne ne peut entrer sur le serveur :

  1. Vérifie si ça dit "Discord requis". Tes joueurs n'ont probablement pas Discord ouvert. Informe-les qu'ils doivent ouvrir Discord avant de se connecter.
  2. Vérifie que ton VPS a accès à internet. Depuis ton VPS, exécute : 
    curl -I https://fiverank.gg
    Ça doit répondre HTTP/2 200. Sinon, c'est un problème de pare-feu de ton hébergeur.
  3. Assure-toi d'avoir set fiverank_fail_open "1" pour qu'un problème temporaire ne bloque pas tout le monde.

La carte de connexion reste bloquée​

Si la carte "Vérification de ta réputation…" ne progresse jamais :

  • Ton serveur ne peut pas contacter fiverank.gg. C'est presque toujours le pare-feu de l'hébergeur qui bloque le HTTPS sortant. Demande à ton fournisseur d'ouvrir le port 443 sortant.
  • Si tu utilises un réseau privé (Pterodactyl, Docker), vérifie que tu as accès à internet sortant depuis le conteneur.

Je veux voir plus de logs pour comprendre ce qui se passe​

Active temporairement les logs détaillés :

set fiverank_debug "1"

Redémarre la ressource. Tu verras maintenant chaque vérification dans la console :

[FiveRank Guard] [debug] connexion: Carlos (270...)
[FiveRank Guard] [debug] discord = 123456789012345678
[FiveRank Guard] [debug] cache miss → réponse en 142ms → autorisé

Quand tu as fini, désactive-le (set fiverank_debug "0") pour garder tes logs propres.

Toujours bloqué​

Ne reste pas coincé. Rejoins le Discord et on t'aide en moins de 24h :

Quand tu demandes de l'aide, fournis :

  1. Screenshot de la console avec fiverank_debug activé.
  2. Ton server.cfg (cache le token avant de l'envoyer).
  3. Quel framework tu utilises (ESX, QBCore, etc.).