Configurer server.cfg FiveM correctement est indispensable pour garantir la stabilité, la sécurité et les performances de votre serveur roleplay. Ce fichier de configuration centralise tous les paramètres essentiels : nom du serveur, clés d’API, limites de slots, variables de connexion et ressources actives. En 2025, avec l’évolution constante de FiveM et l’arrivée de nouvelles fonctionnalités, maîtriser ce fichier est devenu un pilier incontournable pour tout administrateur cherchant à offrir une expérience immersive et sans accroc à ses joueurs.
Pourquoi le fichier server.cfg est-il crucial pour FiveM ?
Le server.cfg est le cœur de votre serveur FiveM. Il contient l’ensemble des directives que le serveur exécute au démarrage : activation des ressources, gestion des permissions, configuration réseau, intégration Discord, paramétrage de txAdmin, et bien plus encore. Une erreur de syntaxe ou un paramètre manquant peut empêcher le serveur de démarrer ou provoquer des dysfonctionnements critiques en jeu.
Contrairement à d’autres jeux où la configuration reste dispersée, FiveM centralise tout dans ce fichier unique, ce qui simplifie la maintenance mais exige rigueur et précision. Chaque ligne compte, et il est recommandé de toujours sauvegarder une copie avant toute modification majeure.
Sur un hébergement professionnel comme celui proposé par Nexus Games, vous bénéficiez d’une infrastructure optimisée avec processeur AMD Ryzen 9 7950X3D, RAM DDR5 ECC et stockage NVMe, garantissant un temps de chargement minimal du server.cfg et une réactivité accrue pour les ressources gourmandes.
Structure et paramètres essentiels du server.cfg
Informations de base du serveur
Les premières lignes du fichier définissent l’identité publique de votre serveur. Voici les variables incontournables :
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sv_hostname "Votre Serveur Roleplay - FiveM 2025"
sv_maxclients 64
sv_endpointprivacy true
sets sv_projectName "NomDuProjet"
sets sv_projectDesc "Description complète de votre serveur"
sets tags "roleplay, français, whitelist, esx, qbcore"- endpoint_add_tcp / endpoint_add_udp : définissent l’adresse IP et le port d’écoute du serveur (30120 par défaut).
- sv_hostname : nom affiché dans la liste publique des serveurs FiveM.
- sv_maxclients : nombre maximum de joueurs simultanés (ajustez selon votre RAM et votre offre d’hébergement).
- sv_endpointprivacy : masque l’IP interne pour protéger votre infrastructure.
- sets : variables publiques visibles dans l’API FiveM et utilisées pour le référencement et les intégrations Discord.
Clés API et intégrations tierces
FiveM s’appuie sur plusieurs services externes qui nécessitent des clés API. Les plus courantes sont :
sv_licenseKey "votre_cle_patreon_cfx"
set steam_webApiKey "votre_cle_steam"
set sv_tebexSecret "votre_cle_tebex"- sv_licenseKey : obligatoire, obtenue via votre compte Patreon Cfx.re. Sur Nexus Games, cette clé est incluse systématiquement dans toutes les offres FiveM, vous évitant toute démarche supplémentaire.
- steam_webApiKey : permet l’identification Steam et l’intégration des bannissements VAC.
- sv_tebexSecret : nécessaire si vous utilisez Tebex pour les donations et achats in-game.
Gestion des ressources
Les ressources sont les scripts, mods et systèmes qui composent votre serveur. Leur activation se fait via les commandes ensure et start :
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure rconlog
start esx_core
start esx_identity
start esx_vehicleshop
start qb-core
start qb-clothing- ensure : charge la ressource et la relance automatiquement en cas de crash.
- start : démarre la ressource une seule fois au boot du serveur.
Il est conseillé d’utiliser ensure pour les ressources critiques (frameworks ESX, QBCore, scripts de spawn) et start pour les modules optionnels ou en test.
Paramètres réseau et performances
Pour garantir fluidité et sécurité, ajustez ces valeurs selon votre infrastructure :
sv_enforceGameBuild 2699
sv_scriptHookAllowed 0
set onesync on
set onesync_enableInfinity 1
set onesync_enableBeyond 1
sv_maxPlayers 64
sv_endpointprivacy true
setr voice_use3dAudio true
setr voice_useSendingRangeOnly true- sv_enforceGameBuild : impose une version spécifique de GTA V pour éviter les désynchronisations.
- sv_scriptHookAllowed : bloque ScriptHook pour empêcher le triche côté client.
- onesync : active la synchronisation avancée (requis pour plus de 32 joueurs).
- voice_use3dAudio : améliore la spatialisation vocale (nécessite tokovoip ou pma-voice).
Avec un processeur AMD Ryzen 9 7950X3D cadencé à plus de 5 GHz et de la RAM DDR5 ECC, comme sur les serveurs Nexus Games, ces paramètres avancés s’exécutent sans surcharge CPU, même avec 128 joueurs simultanés et des centaines de véhicules synchronisés.
Bonnes pratiques et optimisations avancées
Organisation modulaire du fichier
Pour faciliter la maintenance, organisez votre server.cfg en sections commentées :
######################
# Configuration réseau
######################
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
######################
# Informations publiques
######################
sv_hostname "Mon Serveur RP"
sets sv_projectName "MonProjetRP"
######################
# Clés API
######################
sv_licenseKey "cfxk_xxxxxxxxxxxxx"
set steam_webApiKey "xxxxxxxxxxxxx"
######################
# Frameworks
######################
ensure esx_core
ensure qb-core
######################
# Scripts métiers
######################
start esx_policejob
start esx_ambulancejob
start esx_mecanoCette structure rend le fichier lisible, facilite le debug et permet de partager des configurations types avec votre équipe.
Gestion des permissions et ACL
Le server.cfg permet de définir des permissions granulaires via le système ACL (Access Control List) :
add_ace group.admin command allow
add_ace group.admin command.quit deny
add_principal identifier.steam:110000xxxxxxxx group.admin
add_ace resource.esx_core command.add_ace allow
add_ace resource.esx_core command.add_principal allow- add_ace : attribue une permission (allow / deny) à un groupe ou une ressource.
- add_principal : affecte un identifiant (Steam, Discord, License) à un groupe.
Ces ACL permettent de protéger les commandes sensibles (restart, stop, ban) et de déléguer certaines permissions à vos modérateurs sans leur donner un accès root.
Intégration Discord et logs
Pour centraliser les logs et modérer efficacement, intégrez Discord directement dans le server.cfg :
set sv_discordAppId "123456789012345678"
set sv_discordGuildId "123456789012345678"
setr discord_perms "true"
setr discord_token "votre_bot_token"Cette configuration permet d’afficher le statut du serveur dans Discord, de synchroniser les rôles et de recevoir des alertes en temps réel (crash, ban, connexions suspectes).
Sécurité et anti-cheat
Renforcez la sécurité avec ces paramètres complémentaires :
sv_scriptHookAllowed 0
sv_enforceGameBuild 2699
sv_endpointprivacy true
setr ea_LanguageCheck "true"
setr ea_UseResolveURL "true"Associés à un pare-feu applicatif et une protection Anti-DDoS Game (incluse chez Nexus Games), ces réglages réduisent drastiquement les risques d’intrusion et de triche.
Pour aller plus loin, consultez la documentation officielle FiveM, une ressource technique de référence pour les configurations avancées.
Erreurs fréquentes et dépannage
Le serveur refuse de démarrer
Vérifiez en priorité :
- La validité de votre sv_licenseKey (renouvelez-la sur Patreon Cfx.re si expirée).
- L’absence de caractères spéciaux ou de guillemets mal fermés.
- Les conflits de ports (30120 déjà utilisé par un autre processus).
- Les logs dans le fichier console.log ou via txAdmin pour identifier la ligne fautive.
Ressources qui crashent en boucle
Remplacez ensure par start temporairement pour isoler la ressource défaillante :
# Désactiver temporairement
# ensure esx_skin
start esx_identityTestez une à une les ressources, mettez-les à jour, vérifiez leurs dépendances et consultez les logs serveur pour identifier l’origine du crash.
Latence ou lag persistant
Si votre serveur rame malgré une bonne connexion, ajustez :
- sv_maxPlayers : réduisez temporairement pour tester.
- onesync : vérifiez qu’il est bien activé (on, legacy ou infinity).
- Désactivez les ressources gourmandes (mods graphiques lourds, scripts mal optimisés).
- Passez à une offre supérieure si votre RAM ou CPU est saturé.
Avec une infrastructure Ryzen 9 7950X3D et RAM DDR5, vous pouvez supporter facilement 128 slots et des centaines de ressources actives sans dégradation notable.
En appliquant ces recommandations, vous maîtrisez pleinement la configuration server.cfg FiveM et pouvez bâtir un serveur stable, sécurisé et performant. N’oubliez pas de sauvegarder régulièrement votre fichier et de tester chaque modification sur un environnement de staging avant la mise en production. Une configuration rigoureuse, associée à un hébergement professionnel comme celui de Nexus Games incluant clé Patreon, protection Anti-DDoS et support 24/7, vous garantit une expérience roleplay de qualité pour vos joueurs.
FAQ
Quelle est la différence entre “ensure” et “start” dans le server.cfg FiveM ?
La commande ensure charge une ressource et la relance automatiquement en cas de crash ou d’arrêt inopiné, garantissant sa disponibilité permanente. start démarre la ressource une seule fois au boot du serveur, sans redémarrage automatique. Privilégiez ensure pour les ressources critiques (frameworks ESX/QBCore, spawn, chat) et start pour les modules optionnels ou en phase de test.
Comment obtenir et configurer correctement la clé sv_licenseKey pour FiveM ?
La sv_licenseKey s’obtient via votre compte Patreon Cfx.re (niveau Tier 1 minimum). Une fois générée, copiez-la dans le server.cfg à la ligne dédiée : sv_licenseKey "cfxk_xxxxxxxxxxxxx". Chez Nexus Games, cette clé Patreon est incluse automatiquement dans toutes les offres FiveM, vous épargnant toute démarche et garantissant un démarrage immédiat de votre serveur.
Mon serveur FiveM crashe au démarrage, comment identifier l’erreur dans le server.cfg ?
Consultez en priorité le fichier console.log ou les logs txAdmin pour repérer la ligne fautive. Les erreurs courantes incluent : guillemets mal fermés, clés API invalides, ressources manquantes ou conflits de syntaxe. Commentez progressivement les blocs de ressources (en ajoutant # devant chaque ligne) pour isoler la source du crash, puis corrigez ou mettez à jour la ressource incriminée.
