← Blog

Configurer server.cfg sur FiveM : le guide complet des paramètres

Par Benjamin Dayan · PDG

· Mis à jour le 7 octobre 2026 · Lecture 7 min

Sommaire

Le fichier server.cfg FiveM est le point d'entrée qui pilote l'ensemble du comportement technique d'une instance : convars réseau, activation de OneSync, chargement des ressources, règles RCON. Une configuration mal réglée entraîne des kicks aléatoires, des pertes de synchronisation entre joueurs ou des ressources qui refusent de démarrer. Ce guide détaille chaque bloc du server.cfg FiveM pour obtenir une instance stable.



Comprendre la structure du server.cfg FiveM

Le server.cfg FiveM n'est pas un simple fichier de variables : c'est une suite de commandes console exécutées séquentiellement au démarrage du serveur. Chaque ligne appelle une convar (variable de convenience) ou une commande comme ensure, exec ou set. L'ordre compte : une ressource appelée avant que ses dépendances soient chargées provoquera une erreur au lancement.

Structure type d'un server.cfg FiveM fonctionnel :

# Identité et réseau
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sv_hostname "Mon serveur FiveM"
sv_maxclients 48

# Licence et sécurité
sv_licenseKey "changeme"
sv_scriptHookAllowed 0

# OneSync
set onesync on
set onesync_population true

# Ressources
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap

Avant d'aller plus loin dans les réglages, si tu cherches une infrastructure déjà prête avec panel Pterodactyl, console live et anti-DDoS inclus pour faire tourner ce type de configuration, l'hébergeur FiveM de Fly-Serv permet d'importer directement ce fichier sans configuration réseau manuelle côté machine.

Sur une instance autogérée, ce fichier se place à la racine du dossier serveur, généralement nommé server.cfg, et il est référencé au lancement via l'option +exec dans la commande de démarrage du binaire FXServer.



Les paramètres de base du server.cfg FiveM

Cette section regroupe les convars qui définissent l'identité, le réseau et la capacité du serveur. Ce sont les premiers éléments à vérifier quand un serveur FiveM refuse les connexions ou n'apparaît pas dans la liste des serveurs.

Identité et affichage

ConvarRôleExemple
sv_hostnameNom affiché dans la liste des serveurssv_hostname "RP France - Vanilla"
sv_projectNameNom court du projetsv_projectName "MonServeur"
sv_projectDescDescription courtesv_projectDesc "Roleplay francophone"
tagsTags de recherche dans le browsersets tags "rp, drift, economy"

Réseau et capacité

Les endpoints définissent le port d'écoute. Par défaut FiveM utilise le port 30120 en TCP et UDP, mais il est possible de le modifier si plusieurs instances tournent sur la même machine :

endpoint_add_tcp "0.0.0.0:30121"
endpoint_add_udp "0.0.0.0:30121"
sv_maxclients 64
sv_endpointprivacy true

Le paramètre sv_maxclients fixe le nombre de slots. Augmenter cette valeur sans adapter les ressources CPU du serveur entraîne une dégradation progressive du tickrate ressentie par les joueurs sous forme de rubber-banding. Sur un CPU Ryzen à fréquence élevée, une population de 64 à 96 joueurs reste gérable si les scripts sont optimisés, mais au-delà il faut surveiller la charge réseau de près.

Licence et clé de licence Cfx.re

Chaque serveur FiveM doit déclarer une clé de licence générée sur le portail Cfx.re via la convar sv_licenseKey. Sans cette clé, le serveur refuse de démarrer ou se bloque à l'écran de chargement des ressources.

sv_licenseKey "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
sv_master1 "https://servers-frontend.fivem.net/api/servers/single/"


OneSync : la configuration réseau avancée du serveur FiveM

OneSync est le système qui permet de dépasser la limite historique de 32 joueurs en synchronisant les entités (véhicules, peds, objets) sur un plus grand nombre de clients simultanés. Sa configuration dans le server.cfg FiveM influence directement la stabilité des interactions en jeu : collisions fantômes, désynchronisation de véhicules, peds qui disparaissent.

Activer OneSync

set onesync on
set onesync_population true
set onesync_distanceCullVehicles true
set onesync_forceMigration true

Pour des populations supérieures à 32 joueurs, onesync on est obligatoire. Le mode onesync legacy existait historiquement mais n'est plus recommandé sur les versions récentes du build FXServer.

Distance de synchronisation des entités

Ces convars contrôlent la distance à laquelle les entités restent synchronisées entre les clients, ce qui a un impact direct sur la charge réseau et la latence perçue :

ConvarEffet
onesync_workaround763185Corrige un bug historique de migration d'entités, utile sur d'anciens scripts
sv_entityLockdownVerrouille la création d'entités côté client (strict/relaxed/inactive)
sv_filterRequestControlFiltre les demandes de contrôle d'entité pour limiter les abus de scripts

Sur une machine avec peu de ressources CPU, une population trop élevée combinée à OneSync actif génère des pics de latence visibles côté client, notamment lors des sessions avec beaucoup de véhicules. Un CPU à fréquence élevée et un stockage NVMe réduisent les temps de lecture des entités en base mais ne compensent pas un script mal optimisé : il faut profiler les ressources lourdes avec la commande txAdmin ou l'outil profiler intégré à la console FXServer.



Ressources, sécurité RCON et bonnes pratiques d'administration

Au-delà des convars réseau, le server.cfg FiveM gère le chargement des ressources et les règles de sécurité d'accès à la console. C'est ici que se jouent la stabilité du serveur en jeu et sa résistance aux tentatives d'intrusion.

Charger les ressources dans le bon ordre

La commande ensure force le démarrage d'une ressource même si elle a déjà été arrêtée. L'ordre de déclaration doit respecter les dépendances : framework avant les scripts métiers, inventaire avant l'économie, par exemple.

ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure qb-core
ensure qb-inventory
ensure qb-banking

Un fichier resources.cfg séparé ou des blocs exec permettent de modulariser un server.cfg FiveM volumineux, ce qui facilite la maintenance d'un serveur avec plusieurs dizaines de ressources actives.

Sécuriser l'accès RCON

Le mot de passe RCON permet d'exécuter des commandes à distance sur le serveur. Un mot de passe faible ou laissé par défaut expose l'instance à des prises de contrôle complètes.

rcon_password "un-mot-de-passe-long-et-unique"
sv_scriptHookAllowed 0
sv_enforceGameBuild 2802
  • Utilise un mot de passe RCON long, unique, jamais réutilisé ailleurs.
  • Désactive sv_scriptHookAllowed pour bloquer les menus de triche côté client.
  • Fixe sv_enforceGameBuild pour éviter les écarts de version entre clients et serveur.
  • Mets en place une whitelist via une ressource dédiée pour filtrer les connexions en amont.
  • Planifie des sauvegardes régulières de la base de données et du dossier de ressources avant toute mise à jour.

Journalisation et bannissements

Le server.cfg FiveM peut aussi référencer les fichiers de bannissement et de logs :

set sv_logAll true
add_ace resource.chat command.say allow
exec permissions.cfg
exec banlist.cfg

Centraliser les règles d'ACE dans un fichier permissions.cfg séparé évite d'alourdir le server.cfg principal et simplifie la gestion des rangs d'administration, surtout sur les instances gérées par plusieurs sous-utilisateurs via un panel comme Pterodactyl.

Pour les équipes qui gèrent plusieurs projets FiveM ou RedM en parallèle, retrouver l'ensemble des jeux pris en charge sur tous nos serveurs de jeu permet de comparer les options d'infrastructure disponibles, tandis qu'un VPS Pterodactyl reste une option pour héberger soi-même plusieurs panels de gestion sur une seule machine.



Diagnostiquer les erreurs courantes liées au server.cfg FiveM

Certaines erreurs reviennent fréquemment lors de la mise en route d'un server.cfg FiveM : clé de licence invalide, port bloqué, ressource manquante dans l'arborescence.

Checklist de diagnostic

  1. Vérifier que sv_licenseKey correspond bien à la clé générée sur le portail Cfx.re.
  2. Contrôler que les ports déclarés dans endpoint_add_tcp et endpoint_add_udp sont bien ouverts et correspondent au port réellement utilisé.
  3. S'assurer que chaque ressource appelée avec ensure existe physiquement dans le dossier resources.
  4. Vérifier les logs console pour repérer les erreurs de dépendance entre scripts.
  5. Tester une configuration minimale avant de réintroduire progressivement les ressources personnalisées.

Sur une infrastructure autogérée, la console du VPS Linux permet de suivre ces logs en direct via journalctl ou un simple tail -f sur le fichier de sortie du processus FXServer, ce qui accélère grandement le diagnostic.



Le server.cfg FiveM reste le fichier central à maîtriser pour stabiliser un serveur : réseau, OneSync, ressources et sécurité RCON doivent être réglés ensemble, pas isolément. Une configuration testée et documentée évite la majorité des incidents rencontrés en production et facilite la maintenance au fil des mises à jour du jeu.



FAQ

Pourquoi mon serveur FiveM refuse de démarrer après modification du server.cfg ?

Vérifie en priorité la clé de licence via sv_licenseKey et l'ordre des commandes ensure. Une ressource appelée avant ses dépendances ou une clé invalide bloque systématiquement le démarrage dans la console.

Faut-il toujours activer OneSync dans le server.cfg FiveM ?

Oui dès que la population dépasse 32 joueurs simultanés. En dessous, OneSync reste recommandé pour la stabilité des entités, mais son impact réseau doit être surveillé via la console si les scripts sont nombreux.

Comment sécuriser le mot de passe RCON d'un serveur FiveM ?

Utilise une chaîne longue et unique dans rcon_password, ne la réutilise jamais ailleurs, et limite l'accès console aux seuls administrateurs via les permissions ACE définies dans un fichier dédié.

Lire aussi