Dépannage
Solutions aux problèmes les plus courants rencontrés avec l'addon Flitt.
📡
Le serveur reste "Hors ligne"
Causes possibles
- ✓Addon non chargé ou dans le mauvais dossier
- ✓Identifiants invalides (serverId / apiKey)
- ✓Pare-feu bloquant les connexions sortantes
Solutions
- →Vérifiez que la ressource est activée (ensure flitt sur FiveM)
- →Vérifiez la console du serveur pour les logs Flitt
- →Assurez-vous que le pare-feu autorise les connexions sortantes
📊
Les logs ne sont pas envoyés
Causes possibles
- ✓Système de logs (qb-log, bLogs, Helix...) non installé
- ✓Modules de logs désactivés pour le serveur
- ✓Événements personnalisés non enregistrés
Solutions
- →Vérifiez que le système de logs est actif
- →Déclenchez un événement test (ex : kick ou connexion)
- →Vérifiez les logs Flitt pour les erreurs d'enregistrement
⚙️
Erreur "Configuration manquante"
Causes possibles
- ✓Identifiants non configurés
- ✓Placeholders non remplacés (ex : {API_KEY})
Solutions
- →Téléchargez l'addon depuis le tableau de bord (remplissage auto)
- →Ou configurez manuellement lua/autorun/server/flitt.lua
🔐
HTTP 401 / Non autorisé
Causes possibles
- ✓Clé API invalide ou expirée
- ✓Clé API d'un autre serveur utilisée
- ✓ID serveur incorrect
Solutions
- →Régénérez une clé API depuis le tableau de bord
- →Mettez à jour le fichier de configuration
- →Vérifiez que vous utilisez la bonne clé pour le bon serveur
📈
Les stats joueurs ne se mettent pas à jour
Causes possibles
- ✓Le serveur ne peut pas joindre l'API (port 443 bloqué)
- ✓Réseau instable ou DNS bloqué
- ✓Limite de requêtes API dépassée
Solutions
- →Vérifiez la connectivité sortante (ping api.flitt.xyz)
- →Consultez les logs réseau dans la console serveur
- →Attendez quelques minutes avant de réessayer
🆘
Toujours bloqué ?
Ouvrez un ticket support depuis le tableau de bord. Incluez les logs Flitt et votre ID serveur (ne partagez jamais votre clé API).