Problèmes au lancement du serveur

Cette page sert à aider les gens qui lancent le serveur et… ça part en vrille 😅 Fenêtre qui se ferme, txAdmin qui spam d’erreurs, ressources qui ne démarrent pas, port déjà utilisé, ect...

L’objectif : → lister les problèmes les plus fréquents au démarrage, → expliquer pourquoi ça arrive, → donner une solution claire que même un débutant peut suivre.

---

PROBLÈMES AU LANCEMENT DU SERVEUR

Quand ton serveur ne se lance pas correctement, c’est rarement “la fin du monde”, mais ça peut vite stresser. Cette page te donne une checklist des problèmes les plus courants au lancement, avec :

• Symptômes (ce que tu vois)

• Cause probable (ce qui se passe en vrai)

• Solution (ce que tu peux faire concrètement)

Je parle autant pour un serveur en local (PC/XAMPP) que sur un hébergeur / VPS / dédié.

---

1. Où regarder en premier quand ça ne démarre pas ?

Avant de tout casser, commence par regarder les bons endroits :

• La console du serveur (fenêtre noire / txAdmin / screen SSH)

• Les logs txAdmin si tu passes par txAdmin

• Les premiers messages d’erreur après server.cfg chargé

En général, la première erreur “importante” donne déjà une énorme info : → ressource introuvable, port déjà pris, licence key, base de données, fxmanifest, etc.

---

2. Le serveur se lance puis se ferme immédiatement

Symptômes

• Tu cliques sur ton run.sh / start.bat

• Une fenêtre s’ouvre, ça spam 2–3 lignes, puis la fenêtre se ferme

• En mode txAdmin, le profil ne passe jamais “Online”

Causes possibles

• Mauvais chemin vers les artifacts FiveM (FXServer)

• Script de lancement mal configuré (chemin faux, dossier déplacé)

• Sur Linux : run.sh / FXServer pas exécutable (Permission denied)

• Sur Windows : tu n’exécutes pas depuis le bon dossier

Solutions

1. Vérifie que tu lances depuis le bon dossier

   • Sur Windows : place ton run.bat dans le bon dossier (FXServer.exe + server.cfg)

   • Sur Linux : même chose, et lance avec ./run.sh ou ./FXServer depuis le bon répertoire

2. Regarde le message exact

   Sur Windows, lance depuis un Invite de commandes au lieu de double-cliquer :

   • Win + R → cmd

   • cd dans ton dossier serveur

   • lance ton .bat → Comme ça, la fenêtre reste ouverte et tu vois l’erreur.

3. Sous Linux, vérifie les permissions

   • chmod +x FXServer

   • chmod +x run.sh

   Si tu vois Permission denied, c’est souvent ça.

Sur windows mieux vos lancer directement le fichier FXServer.exe

---

3. “Could not load server license key” / problème de licence FiveM

Symptômes

• Message dans la console : Could not load server license key

• Ou un message qui parle de “license key not valid”, “invalid key”, etc.

Causes

• Mauvaise clé FiveM (copiée avec un espace, mauvais compte, clé supprimée…)

• Tu n’as pas encore créé de clé sur le Keymaster

• Tu as mis la clé dans une mauvaise ligne ou dans un mauvais fichier

Solutions

1. Va sur le Keymaster FiveM (cfx.re) et vérifie :

   • Que la clé existe

   • Qu’elle n’est pas désactivée

   • Qu’elle est bien liée à l’IP correcte si tu es chez un hébergeur

2. Dans ton server.cfg, vérifie que tu as bien une ligne du genre :

   • sv_licenseKey "TA_CLE_ICI"

3. Pas d’espace bizarre, pas de guillemets en trop, pas de commentaire sur la même ligne.

4. Redémarre ton serveur et regarde si le message disparaît.

---

4. “Couldn’t start resource …” / ressource qui refuse de démarrer

Symptômes

• Dans la console : Couldn't start resource nom_du_script

• Ou : Error loading script ...

• Ou fxmanifest.lua / __resource.lua mentionné dans l’erreur

Causes

• Erreur dans le fxmanifest.lua (syntaxe, caractère bizarre en début de fichier, mauvais encoding)

• Ressource qui demande une autre ressource non démarrée (dépendance)

• Script prévu pour une autre version du framework / d’un asset (ESX différent, ox_lib manquant, etc.)

• Fichiers manquants dans la ressource (tu as supprimé/renommé quelque chose)

Solutions

1. Vérifie le fxmanifest

   • Ouvre fxmanifest.lua avec un éditeur correct (VS Code, pas Word)

   • Vérifie qu’il n’y a pas de caractère chelou au tout début du fichier (BOM, <, etc.)

   • Vérifie que les chemins de fichiers (client.lua, server.lua, config.lua, etc.) existent réellement.

2. Regarde les dépendances

   Dans fxmanifest.lua, quand tu vois :

   • dependency 'ox_lib'

   • dependency 'es_extended' … assure-toi que ces ressources-là sont bien présentes et ensure dans ton server.cfg avant la ressource qui plante.

3. Version incompatible

   • Si le script vient d’une autre base, d’un autre ESX, d’une autre version d’ox_lib, il peut casser.

   • Regarde la doc du script, parfois il exige une version précise.

4. Solution simple : isoler

   • Désactive temporairement la ressource dans server.cfg (# devant ensure)

   • Redémarre le serveur et vois si tout le reste tourne.

   • Tu pourras revenir sur ce script plus tard.

---

5. “Could not find resource …” / ressource introuvable

Symptômes

• Could not find resource nom_du_script

• Ou No such resource nom_du_script

Causes

• Il y a un ensure nom_du_script dans ton server.cfg / ressources.cfg mais :

  • le dossier n’existe pas

  • le dossier a été renommé

  • le nom ne correspond pas exactement (majuscules/minuscules, tirets, etc.)

Solutions

1. Vérifie dans resources/ que le dossier existe.

2. Compare exactement le nom :

   • ensure ducratif_territoire

   • dossier = resources/[1_esential]/[10_ducratif]/ducratif_territoire → Le nom du dossier doit correspondre au nom du ensure.

3. Si tu as renommé le dossier à la main, pense à :

   • Mettre à jour le ensure

   • Vérifier le fxmanifest.lua si jamais il fait référence à son propre nom (rare mais possible)

---

6. Problèmes de port : “Couldn’t start network server on …”

Symptômes

• Message du type : Couldn't start network server on [::]:30120 ou Address already in use

Causes

• Le port que tu veux utiliser est déjà pris par un autre logiciel ou un autre serveur FiveM

• Deux serveurs utilisent le même port sur la même machine

• Le pare-feu ou l’hébergeur bloque quelque chose (mais là tu aurais plutôt un serveur qui démarre mais n’est pas joignable)

Solutions

1. Vérifie dans ton server.cfg :

   • endpoint_add_tcp "0.0.0.0:30120"

   • endpoint_add_udp "0.0.0.0:30120" → C’est bien le port que tu veux utiliser ? (Ou le port primaire de ta machine sur un hebergeur)

2. Sur ta machine :

   • Vérifie qu’un autre serveur n’est pas déjà lancé sur ce port

   • Sur Linux : ss -tulnp | grep 30120

   • Sur Windows : netstat -ano | find "30120"

3. Si besoin, change de port :

   • par ex. 30121, mets à jour les deux lignes endpoint_add_...

   • redémarre et teste.

4. Chez un hébergeur :

   • Vérifie que le port que tu utilises fait partie de ceux autorisés par l’hébergeur

   • Certains panels imposent un port précis.

   • Un port primaire pour ton serveur.

   • Un port secondaire pour TxAdmin si activé.

---

7. Erreurs liées à la base de données au lancement

Je te fais un résumé rapide ici, mais tu as une page dédiée “Erreurs SQL courantes & solutions” pour le détail.

Symptômes

• Le serveur démarre, mais inonde la console de :

  • [oxmysql] [ERROR]

  • Access denied for user

  • Unknown database

  • Table 'xxx' doesn't exist

Causes

• Mauvais identifiants DB

• Base non importée / table manquante

• Host DB incorrect (localhost au lieu d’une IP hébergeur, ou inverse)

Solutions (ultra résumé)

• Vérifie les identifiants dans la config de oxmysql

• Vérifie dans phpMyAdmin (ou autre) que :

  • la base existe

  • les tables sont bien là

• Vérifie que tu pointes vers la bonne base (nom exact)

• Pour tous les détails → voir la page SQL.

---

8. En local ça marche, chez l’hébergeur ça ne démarre plus

Symptômes

• Chez toi en local : tout tourne

• Tu uploades tout chez un hébergeur → le serveur démarre mal ou pas du tout

• Erreurs de type :

  • Access denied for user

  • Can't connect to MySQL server

  • ressources introuvables

  • chemins bizarres

Causes courantes

• Tu as gardé dans la config DB :

  • localhost, root et pas les infos de l’hébergeur

• Différences de chemins / environnement (Docker, Pterodactyl, Linux vs Windows)

• Droits de fichiers (Linux) si tu as upload via FTP avec un user différent

Solutions

1. Revois toutes les configs sensibles :

   • DB (host, user, mdp, nom DB)

   • Ports

   • Chemin d’accès dans ton script de lancement (run.sh / start.bat / txAdmin)

2. Vérifie les logs de l’hébergeur :

   • Souvent, ils donnent une erreur très claire dans la console ou dans un onglet “Logs”.

3. Sur Linux :

   • Vérifie les droits :

     • chmod +x FXServer

     • chmod -R 755 resources/ (ou au moins les scripts qui ne se lancent pas)

---

9. Quand le serveur “reste bloqué” au démarrage

Symptômes

• La console ne se ferme pas, mais reste figée sur certaines lignes

• txAdmin reste en “Starting…” sans passer à “Online”

Causes

• Ressource qui reste bloquée à l’initialisation (boucle, attente DB, bug)

• Script qui nécessite une réponse (SQL, API, etc.) qui n’arrive jamais

• Très gros chargement au démarrage (maps, véhicules, etc.) sur un petit serveur

Solutions

1. Regarde la dernière ligne affichée :

   • Si c’est toujours le même script mentionné : c’est lui le coupable potentiel

   • Désactive temporairement la ressource (# ensure nom_du_script) et teste sans

2. Vérifie la partie SQL (encore une fois, si oxmysql spam au même moment, ça peut être lié à la DB).

3. Si tu as ajouté récemment :

   • un gros pack de mappings

   • un pack de véhicules → Teste un démarrage sans ces ressources pour voir si ça vient de là.

---

10. Checklist rapide quand le serveur refuse de se lancer

Avant de péter un câble, passe vite fait sur cette checklist :

• Ma clé FiveM est bien configurée dans server.cfg

• Les artifacts que j’utilise sont adaptés à mon OS (Linux/Windows)

• Je lance le serveur depuis le bon dossier

• Mon fichier server.cfg se charge bien (pas renommé par erreur, pas mal placé)

• Les ressources mentionnées en ensure existent vraiment dans resources/

• Ma configuration MySQL est correcte (host, user, mdp, DB)

• Le port du serveur n’est pas déjà utilisé par autre chose

• Je regarde la première erreur sérieuse dans la console, pas juste la dernière ligne random