Ce guide couvre les solutions aux problèmes les plus courants des serveurs FiveM — problèmes d'accès à TXAdmin, erreurs de clé de licence CFX, échecs de connexion à la base de données, plantages du serveur, problèmes de connexion des joueurs et ressources qui ne se chargent pas. Pour la configuration initiale du serveur, consultez le Guide de configuration du serveur FiveM.
Conseil général de dépannage : Vérifiez toujours la sortie de la console GPanel et les journaux TXAdmin en premier. La plupart des erreurs produisent un message clair qui indique la cause.
TXAdmin ne se charge pas ou est inaccessible
- Vérifiez que le serveur est en cours d'exécution dans GPanel — TXAdmin ne démarre que lorsque le processus du serveur FiveM est actif.
- Vérifiez la console GPanel pour l'URL et le port de TXAdmin. Le port TXAdmin est différent du port de jeu.
- Assurez-vous d'utiliser
http://et nonhttps://— TXAdmin n'utilise pas SSL par défaut. - Si TXAdmin fonctionnait auparavant mais ne se charge plus, essayez de redémarrer le serveur depuis GPanel.
- Videz le cache de votre navigateur ou essayez une fenêtre de navigation privée.
Mot de passe TXAdmin perdu ? Si vous ne pouvez pas vous connecter, vous devrez peut-être supprimer les données de profil TXAdmin et relancer l'assistant de configuration. Vérifiez l'onglet Files du GPanel pour le répertoire de données de TXAdmin et supprimez ses fichiers de profil, puis redémarrez le serveur.
Erreurs de clé de licence CFX
| Message d'erreur | Cause | Solution |
|---|---|---|
Invalid license key |
Clé copiée incorrectement ou espaces supplémentaires | Allez sur Keymaster, confirmez que la clé est active, et recopiez-la soigneusement. Collez-la à la fois dans la variable Startup du GPanel et dans sv_licenseKey du server.cfg. |
License key already in use |
La clé est enregistrée sur une adresse IP de serveur différente | Chaque clé ne peut être utilisée que sur un seul serveur à la fois. Révoquez l'ancienne clé sur Keymaster et générez-en une nouvelle avec l'IP actuelle de votre serveur. |
Unable to verify license key |
Les serveurs d'authentification Cfx.re sont temporairement indisponibles | Attendez quelques minutes et redémarrez le serveur. Vérifiez status.cfx.re pour les pannes. |
Conseil : Assurez-vous que la clé est définie à la fois dans la variable Startup du GPanel et dans
server.cfg (sv_licenseKey). Selon votre configuration, le serveur peut lire l'une ou l'autre.
Erreurs de connexion à la base de données
| Message d'erreur | Cause | Solution |
|---|---|---|
Connection refused ou ETIMEDOUT |
Mauvais hôte ou port de base de données | Vérifiez l'adresse de l'hôte et le port de la base de données depuis l'onglet Databases du GPanel. N'utilisez pas localhost ni 127.0.0.1. |
Access denied |
Mauvais nom d'utilisateur ou mot de passe | Copiez les identifiants directement depuis GPanel pour éviter les fautes de frappe. Les mots de passe sont sensibles à la casse. |
Unknown database |
Le nom de la base de données ne correspond pas | Assurez-vous que le nom de la base de données dans votre chaîne de connexion correspond exactement à ce qui est affiché dans GPanel. |
Étapes supplémentaires de dépannage de la base de données :
- Si vous utilisez oxmysql, assurez-vous d'avoir la ressource
oxmysqldans votre dossierresources/et queensure oxmysqlapparaît dans server.cfg avant toute ressource nécessitant une base de données. - Si votre mot de passe contient des caractères spéciaux tels que
@,#ou%, encodez-les en URL dans la chaîne de connexion (ex.@devient%40). - Vérifiez votre chaîne de connexion pour les caractères manquants ou en trop — même un seul caractère mal placé causera un échec.
N'utilisez pas localhost. Le serveur de base de données est séparé du serveur de jeu. Utilisez toujours l'adresse complète de l'hôte affichée dans l'onglet Databases du GPanel.
Le serveur plante au démarrage
- Vérifiez la console GPanel pour les messages d'erreur. Les causes courantes incluent un
server.cfgmanquant ou mal configuré, une clé de licence CFX invalide, ou une ressource défectueuse. - Essayez de désactiver les ressources personnalisées en les commentant dans server.cfg (ajoutez
#avant chaque ligneensure) et redémarrez. Réactivez-les une par une pour identifier la ressource problématique. - Assurez-vous que les ports dans
endpoint_add_tcpetendpoint_add_udpcorrespondent au port attribué dans GPanel.
# Comment out resources to isolate the problem
#ensure suspicious-resource
#ensure another-resource
# Keep core resources enabled
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure chat
Recherche binaire des ressources défectueuses : Si vous avez de nombreuses ressources, commentez-en la moitié à la fois plutôt qu'une par une. Cela permet de cerner le problème beaucoup plus rapidement.
Les joueurs ne peuvent pas se connecter
- Confirmez que le serveur affiche Running dans GPanel.
- Vérifiez l'IP et le port — les joueurs doivent utiliser le port de jeu, pas le port TXAdmin.
- Vérifiez que
sv_maxclientsn'est pas défini à 0 ou à un nombre déraisonnablement bas. - Si vous utilisez un mot de passe serveur (
sv_passworddans server.cfg), assurez-vous que les joueurs le connaissent. - Les joueurs doivent avoir le client FiveM installé — ils ne peuvent pas se connecter en utilisant le lanceur GTA V classique.
- Vérifiez l'onglet Network du GPanel et confirmez que les ports dans
endpoint_add_tcpetendpoint_add_udpcorrespondent. Une différence empêchera les connexions.
Le serveur n'apparaît pas dans le navigateur ? Les nouveaux serveurs peuvent mettre 5 à 15 minutes pour apparaître dans la liste des serveurs FiveM. Utilisez la connexion directe (
IP:PORT) en attendant. Vérifiez également que votre sv_licenseKey est valide.
Les ressources ne se chargent pas
- Vérifiez que le dossier de la ressource se trouve dans le répertoire
resources/(ou un sous-dossier approprié). - Vérifiez que le nom du dossier correspond exactement à la ligne
ensuredans server.cfg (sensible à la casse). - Chaque ressource doit contenir un fichier
fxmanifest.luavalide (ou l'ancien__resource.lua). Si ce fichier est manquant, la ressource ne se chargera pas. - Vérifiez la console TXAdmin ou GPanel pour les messages d'erreur liés à la ressource. Les erreurs courantes incluent des dépendances manquantes ou des erreurs de syntaxe Lua.
- Si la ressource nécessite un framework (ESX, QBCore), assurez-vous que le framework est chargé avant la ressource dans server.cfg.
- Si la ressource nécessite une base de données, assurez-vous que votre ressource MySQL (oxmysql, mysql-async) est chargée et que la connexion à la base de données fonctionne.
Vérifiez la structure des dossiers. Une erreur courante est d'uploader une ressource et de se retrouver avec un dossier doublement imbriqué comme
resources/my-resource/my-resource/fxmanifest.lua. Le manifeste doit être directement dans le dossier de la ressource : resources/my-resource/fxmanifest.lua.
Problèmes de performance du serveur
- Ouvrez TXAdmin et vérifiez le Dashboard pour les métriques de performance (temps de tick, nombre de joueurs, utilisation mémoire).
- Un serveur FiveM en bonne santé doit maintenir un temps de tick serveur (aussi appelé « hitch ») inférieur à 20ms. Des pics constants au-dessus de cette valeur indiquent qu'une ressource utilise trop de temps de traitement.
- Utilisez la page Resources de TXAdmin pour identifier quelles ressources consomment le plus de temps serveur.
- Supprimez ou remplacez les ressources mal optimisées. Les ressources gratuites de sources inconnues sont souvent la cause des problèmes de performance.
- Réduisez le nombre de ressources chargées si les limites de mémoire ou de CPU de votre plan serveur sont atteintes.
Obtenir de l'aide
Si vous avez essayé les solutions ci-dessus et rencontrez toujours des problèmes :
- Copiez le message d'erreur complet depuis la console GPanel ou le journal TXAdmin.
- Notez les étapes de dépannage que vous avez déjà essayées.
- Ouvrez un ticket de support à https://legionhosting.net/submitticket.php avec ces informations. Notre équipe vous assistera le plus rapidement possible.
