Le fichier server.cfg FiveM expliqué ligne par ligne (2026)

Le fichier server.cfg est le centre de configuration de votre serveur FiveM. Il définit l'identité publique (nom, description, bannière), les ressources chargées au démarrage, les slots disponibles, les permissions administrateur et bien plus. Ce guide détaille chaque ligne du fichier pré-configuré fourni avec votre offre d'hébergement FiveM Lordhosting sur Pterodactyl.

⚙️ Où trouver le fichier server.cfg ?

Sur votre panel Pterodactyl Lordhosting :

Sélectionnez votre serveur FiveM
Cliquez sur l'onglet « File Manager » (menu de gauche)
À la racine, ouvrez le fichier server.cfg

Un server.cfg exemple est pré-configuré avec les paramètres de base et les slots définis selon votre offre. Vous pouvez l'éditer directement depuis le panel — chaque sauvegarde requiert un redémarrage du serveur pour être prise en compte.

⚠️ À ne pas toucher : les lignes endpoint_add_tcp et endpoint_add_udp liées au port. Pterodactyl les réécrit automatiquement au démarrage avec le port correct attribué à votre serveur. Toute modification manuelle sera écrasée.

⚙️ Identité du serveur

Ces lignes définissent comment votre serveur apparaît dans la liste publique FiveM.

sv_hostname

sv_hostname "^4[FR] ^7Mon Super Serveur RP ^2| ^1Discord.gg/example"

Nom affiché dans la server list FiveM. Vous pouvez utiliser les codes couleur FiveM :

Code	Couleur
`^0`	Noir
`^1`	Rouge
`^2`	Vert
`^3`	Jaune
`^4`	Bleu
`^5`	Cyan
`^6`	Magenta
`^7`	Blanc
`^8`	Rouge foncé
`^9`	Gris

Astuce : commencez le nom par [FR], [EN] ou [ES] pour signaler la langue principale du serveur.

sv_projectName

sv_projectName "Mon Super Serveur RP"

Nom court de votre projet, affiché dans certaines interfaces FiveM. Pas de codes couleur.

sv_projectDesc

sv_projectDesc "Serveur GTA RP francophone, économie réaliste, jobs custom, 100 slots."

Description affichée dans la fiche détaillée du serveur. Limité à environ 1 ligne.

sv_maxClients

sv_maxClients 64

Nombre maximum de slots (joueurs simultanés). Doit correspondre au nombre de slots prévu par votre offre Lordhosting : un dépassement bloquera le démarrage du serveur.

Valeurs typiques :

Démarrage / petit RP : 32
RP communauté moyenne : 64
Grosse communauté RP : 128 à 200

⚙️ Bannière et présentation

load_server_icon icon.png

Image affichée à côté du nom du serveur dans la liste FiveM. Format requis : PNG 96x96 pixels exactement. Uploadez le fichier icon.png à la racine de votre serveur via le File Manager Pterodactyl.

Game build (DLC GTA V)

sets sv_enforceGameBuild 3258

Force une version spécifique de GTA V (DLC). Important pour utiliser certains véhicules récents ou MLOs.

Builds courants en 2026 :

2802 : Cayo Perico
2944 : Contracts
3095 : Drug Wars
3258 : The Chop Shop
3407 : Bottom Dollar Bounties (dernier en date)

⚠️ Plus le build est récent, plus les anciens scripts peuvent casser. Testez avant de pousser en production.

⚙️ Ressources et démarrage

# Ressources de base FiveM
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap

# Vos ressources custom
ensure votre_framework
ensure votre_inventaire
ensure vos_jobs

ensure charge la ressource au démarrage et la redémarre automatiquement si elle crash.

💡 Ordre de chargement : démarrez toujours par les ressources core (sessionmanager, mapmanager, etc.), puis votre framework (ESX, QBCore, QBox), puis les ressources qui en dépendent.

Pour désactiver temporairement une ressource sans la supprimer, commentez la ligne avec # :

# ensure mon_script_en_panne

⚙️ Permissions et administration

Système ACE (Access Control Entries)

FiveM utilise un système de permissions appelé ACE. Vous définissez des principals (utilisateurs ou groupes) et leur attribuez des permissions.

# Création d'un groupe admin
add_ace group.admin command allow
add_ace group.admin command.quit deny

# Ajouter un utilisateur au groupe admin (via identifier Steam, license, etc.)
add_principal identifier.license:abc123def456... group.admin

Identifier d'un joueur

Pour ajouter un admin, vous avez besoin de son identifier. Trois options pour le récupérer :

Via la console serveur : tapez players quand le joueur est connecté
Via un script : la plupart des frameworks affichent l'identifier des joueurs dans l'interface admin
Via les logs : à la connexion, FiveM logue l'identifier dans la console

Format typique : license:abc123def456... ou steam:110000100000000

⚙️ Sécurité et anti-cheat

Mode OneSync

set onesync on
set onesync_population true

OneSync est le système de réplication réseau de FiveM qui permet :

Plus de 32 joueurs simultanés
Meilleure synchronisation des entités
Population GTA V synchronisée entre les joueurs

Recommandé pour tout serveur RP moderne. Inclus gratuitement chez Lordhosting.

Scripthook désactivé

sv_scriptHookAllowed 0

Désactive l'utilisation du Script Hook côté client (anti-cheat basique). À garder sur 0 pour un serveur RP sérieux. Les triches client-side sont ainsi limitées.

Mot de passe de connexion (optionnel)

# sv_password "monMotDePasse"

Décommentez et définissez un mot de passe pour rendre votre serveur privé (whitelist beta, tests fermés, etc.). À retirer pour un serveur public.

⚙️ Licence et identité technique

Clé Keymaster

sv_licenseKey "cfxk_XXXXXXXXXXXXXXXXXXXXXXXXX_YYYYYY"

Clé obtenue sur keymaster.fivem.net. Sans elle, votre serveur n'apparaît pas dans la liste publique. Consultez notre guide Keymaster pour l'obtenir.

💡 Alternative recommandée : entrez votre clé via l'onglet « Startup » du panel Pterodactyl Lordhosting (variable LICENSE_KEY) plutôt que dans server.cfg. Plus propre et plus sécurisé en cas de partage de configuration.

⚙️ Limites de connexion

# Limiter à 1 connexion par adresse IP
set sv_authMaxVariance 1
set sv_authMinTrust 5

Ces paramètres protègent contre les multi-comptes basiques. Pour une protection plus poussée, utilisez un système anti-cheat dédié (FiveGuard, Polar Anticheat, etc.).

⚙️ Exemple de server.cfg complet

# === IDENTITÉ ===
sv_hostname "^4[FR] ^7Mon Serveur RP ^2| ^1discord.gg/example"
sv_projectName "Mon Serveur RP"
sv_projectDesc "Serveur GTA RP francophone, économie réaliste, ESX, 64 slots."
sv_maxClients 64

# === BANNIÈRE & TAGS ===
load_server_icon icon.png
sets tags "roleplay, rp, francais, esx, hardrp"
sets sv_enforceGameBuild 3258

# === RESSOURCES ===
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure es_extended
ensure ox_inventory
# Ajoutez vos resources custom ici

# === SÉCURITÉ ===
set onesync on
set onesync_population true
sv_scriptHookAllowed 0

# === ADMIN (exemple) ===
add_ace group.admin command allow
add_principal identifier.license:abc123... group.admin

# === LICENCE (préférez la mettre en Startup var) ===
# sv_licenseKey "cfxk_..."

⚙️ Sauvegarder et redémarrer

Après chaque modification :

Sauvegardez le fichier dans le File Manager Pterodactyl
Allez dans l'onglet « Console »
Cliquez sur « Restart »

Vous verrez en console les ressources se charger une à une. Surveillez les erreurs éventuelles, qui apparaissent en rouge.

⚙️ Erreurs courantes

Erreur	Cause	Solution
`Couldn't find resource X`	Ressource référencée avec `ensure` mais absente du dossier `resources/`	Vérifier que le dossier de la ressource existe et porte le bon nom
`License key authentication failed`	Clé Keymaster invalide ou liée à une autre IP	Voir le guide Keymaster
`sv_maxClients value exceeds limit`	Slots demandés supérieurs à ceux de l'offre	Réduire `sv_maxClients` ou upgrader l'offre
Server doesn't appear in list	Manque la clé Keymaster ou identifier de game build invalide	Vérifier `sv_licenseKey` et `sv_enforceGameBuild`

⚙️ Pour aller plus loin

Obtenir sa clé Keymaster CFX.re : étape indispensable avant de configurer server.cfg
ESX vs QBCore : quel framework choisir ? : pour bien choisir vos ensure framework
Mettre à jour son serveur FiveM : artifacts à jour pour profiter des dernières features