server.cfg FiveM : toutes les commandes expliquées, avec un exemple complet

Le fichier server.cfg est le cœur de votre serveur FiveM. Il dit à FXServer quelles ressources démarrer, comment s'afficher dans la liste des serveurs, combien de joueurs accepter et qui a le droit de faire quoi. Ce guide passe en revue chaque commande utile, avec des exemples prêts à copier.

#Les règles de syntaxe

• Une commande par ligne.
• Les lignes qui commencent par # sont des commentaires.
• Les valeurs qui contiennent des espaces s'écrivent entre guillemets : sv_hostname "Mon serveur RP".
• Les commandes sont lues de haut en bas : une ressource doit être démarrée après ses dépendances.
• exec autre.cfg charge un autre fichier, comme s'il était collé à cet endroit.

#Exemple complet pour un serveur roleplay

## ───── Réseau ─────
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

## ───── Identité dans la liste des serveurs ─────
sv_hostname "^3Paris RP ^7| Roleplay sérieux | Whitelist"
sets sv_projectName "Paris RP"
sets sv_projectDesc "Roleplay francophone sérieux, recrutement ouvert"
sets locale "fr-FR"
sets tags "roleplay, french, serious, economy"
sets banner_detail "https://exemple.fr/banniere.png"
sets banner_connecting "https://exemple.fr/chargement.png"
sets Discord "discord.gg/votre-code"
load_server_icon logo.png

## ───── Joueurs et synchronisation ─────
sv_maxclients 48
set onesync on
sv_enforceGameBuild 3258

## ───── Sécurité ─────
sv_scriptHookAllowed 0
sv_pureLevel 1
set sv_filterRequestControl 4

## ───── Base de données ─────
set mysql_connection_string "mysql://fivem:motdepasse@127.0.0.1/fivem?charset=utf8mb4"

## ───── Ressources ─────
exec resources.cfg

## ───── Permissions ─────
exec permissions.cfg

## ───── Licence ─────
sv_licenseKey "cfxk_votre_cle"

# Ressources système de Cfx.re
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap

# Bibliothèques (toujours en premier)
ensure oxmysql
ensure ox_lib

# Framework
ensure es_extended

# Scripts du serveur, rangés par dossier
ensure [esx]
ensure [scripts]
ensure [cartes]

#Réseau : endpoint_add_tcp et endpoint_add_udp

Ces deux lignes indiquent l'adresse et le port d'écoute du serveur, par défaut 30120. Le jeu utilise les deux protocoles : TCP pour le téléchargement des ressources, UDP pour la partie en direct.

#Liste des serveurs : nom, description, tags

Les codes couleur de sv_hostname :

#Joueurs : sv_maxclients

sv_maxclients 48 fixe le nombre de places. La clé gratuite de Cfx.re autorise 48 places au maximum. Au-delà, il faut un abonnement Element Club (palier Argentum ou plus) sur le compte qui a créé la clé. Sans lui, les joueurs sont refusés à la connexion.

#OneSync

set onesync on

OneSync déplace la synchronisation des entités (joueurs, véhicules, PNJ) vers le serveur. Il est indispensable au-delà de 32 joueurs, et la plupart des frameworks récents (ESX Legacy, QBCore, Qbox, ox_lib) en ont besoin. Laissez-le activé.

#Version du jeu : sv_enforceGameBuild

GTA V reçoit des mises à jour qui ajoutent des véhicules, des vêtements et des cartes. sv_enforceGameBuild impose à tous les joueurs la même version, pour que ces contenus soient disponibles :

Une ressource qui utilise un véhicule ou un vêtement récent demande souvent une version minimale dans son README. Si vous changez cette valeur, les joueurs téléchargent les données correspondantes à leur prochaine connexion.

#Sécurité

#Variables : set, sets, setr

Exemple avec une variable lue par un script :

set discord_webhook "https://discord.com/api/webhooks/..."
setr serveur_nom_court "Paris RP"

local webhook = GetConvar('discord_webhook', '')
if webhook == '' then
  print('^1Aucun webhook Discord configuré^7')
end

local nom = GetConvar('serveur_nom_court', 'Serveur')
print(('Bienvenue sur %s'):format(nom))

#Permissions : add_ace, add_principal

Le système ACE accorde des droits à des groupes, puis rattache des joueurs à ces groupes.

# Un groupe "admin" qui peut tout faire sauf arrêter le serveur
add_ace group.admin command allow
add_ace group.admin command.quit deny

# Un groupe "moderateur" limité
add_ace group.moderateur command.kick allow
add_ace group.moderateur command.annonce allow
add_ace group.moderateur moderation.voir allow

# Héritage : un admin est aussi modérateur
add_principal group.admin group.moderateur

# Joueurs (identifiants visibles dans txAdmin)
add_principal identifier.fivem:1234567 group.admin
add_principal identifier.license:0123456789abcdef0123456789abcdef01234567 group.moderateur
add_principal identifier.discord:123456789012345678 group.moderateur

Dans un script, vérifiez un droit avec IsPlayerAceAllowed(source, 'moderation.voir'). Une commande déclarée avec RegisterCommand('kick', fonction, true) n'est utilisable que par les joueurs qui ont command.kick.

#Erreurs fréquentes

EsoterHost n'est ni approuvé, ni sponsorisé, ni affilié à Rockstar Games ou à Cfx.re. FiveM et Grand Theft Auto V sont des marques de leurs propriétaires.