Serveurs de jeux & OuiPanel•15 décembre 2025• 13 vues

Comment configurer server.cfg sur son serveur FiveM

Comment configurer server.cfg sur son serveur FiveM

Comment configurer server.cfg sur son serveur FiveM

Temps estimé : 15 minutes
Difficulté : Intermédiaire ⭐⭐
Serveurs compatibles : FiveM

📋 Introduction

Le fichier server.cfg est le fichier de configuration principal de votre serveur FiveM. Il permet de définir le nom du serveur, le nombre de joueurs, les ressources à charger, les permissions, et bien plus encore.

Ce que vous pouvez configurer

Catégorie Exemples
🏷️ Identité Nom du serveur, description, tags
🔑 Licence Clé de licence Cfx.re (obligatoire)
👥 Joueurs Slots max, OneSync
📦 Ressources Scripts, maps, véhicules
🔒 Permissions ACE/ACL, admins, groupes
⚙️ Réseau Ports, RCON

🔑 Prérequis : Obtenir une Clé de Licence

Avant de configurer votre serveur, vous devez obtenir une clé de licence gratuite sur Cfx.re.

Créer un compte Cfx.re

  1. Rendez-vous sur Cfx.re
  2. Cliquez sur Sign Up (ou connectez-vous si vous avez déjà un compte)
  3. Créez votre compte avec email ou Discord

Générer la clé de licence

  1. Connectez-vous sur Cfx.re Keymaster
  2. Cliquez sur Register a new server
    Image
  1. Remplissez le formulaire :
    Image
  1. Cliquez sur Generate
  2. Copiez la clé générée (format: xxxxxxxxxxxxxxxxxxxxxxxxxxxxx)

Image

⚠️ Important :

  • Une clé = un serveur
  • Gardez cette clé secrète
  • Vous pouvez générer plusieurs clés pour plusieurs serveurs

📁 Accéder au Fichier server.cfg

Via le Gestionnaire de Fichiers

  1. Connectez-vous à OuiPanel
  2. Sélectionnez votre serveur FiveM
  3. Dans le menu latéral, cliquez sur Gestionnaire de fichiers
  4. Ouvrez le fichier server.cfg à la racine

Image

  1. Cliquez sur le fichier pour pouvoir le Modifier

Image

⚠️ Important : Arrêtez votre serveur avant de modifier ce fichier, puis redémarrez-le pour appliquer les changements.

🏷️ Configuration de Base

Clé de Licence (Obligatoire)

sv_licenseKey "votre_cle_de_licence_ici"

Remplacez par la clé obtenue sur Keymaster.

⚠️ Sans clé de licence valide, votre serveur ne démarrera pas.

Nom du Serveur

sv_hostname "Mon Serveur FiveM | Roleplay FR"

C'est le nom affiché dans la liste des serveurs FiveM.

Conseils pour le nom :

  • ✅ Court et mémorable
  • ✅ Inclure le type (RP, Freeroam, Drift...)
  • ✅ Inclure la langue (FR, EN...)
  • ✅ Utiliser des emojis avec modération

Exemples :

sv_hostname "🇫🇷 Revolution RP | Serious Roleplay"
sv_hostname "Los Santos Life | RP Francophone"
sv_hostname "Drift Paradise | Course & Tuning"

Description du Serveur

sv_projectDesc "Serveur roleplay francophone avec économie réaliste, métiers variés et communauté active."

Description affichée dans les détails du serveur. Maximum 200 caractères recommandé.

Nom du Projet

sv_projectName "Revolution RP"

Nom court du projet (affiché dans certains menus).

Tags du Serveur

sets tags "roleplay, francais, serious, economy, jobs"

Tags pour le référencement dans la liste des serveurs. Séparez par des virgules.

Tags populaires :

  • roleplay, rp, serious, semi-serious
  • francais, french, fr
  • economy, jobs, police, ems
  • custom-cars, drift, racing
  • esx, qbcore, vrp

Image/Banner du Serveur

load_server_icon server_icon.png

Affiche une icône dans la liste des serveurs.

Spécifications :

  • Format : PNG
  • Taille : 96x96 pixels
  • Nom : server_icon.png
  • Emplacement : racine du serveur

👥 Configuration des Joueurs

Nombre de Slots Maximum

sv_maxclients 32
Valeur Recommandation
32 Petit serveur / Test
64 Serveur moyen
128 Grand serveur
256+ Très grand serveur (OneSync requis)

⚠️ Plus de joueurs = plus de ressources nécessaires (RAM, CPU).

Activer OneSync

OneSync permet de gérer plus de 32 joueurs et améliore la synchronisation.

set onesync on
Mode Description
off Désactivé (limite 32 joueurs)
on Activé (recommandé)
legacy Mode legacy

Configuration OneSync avancée :

set onesync on
set onesync_population true

# Distance de culling (portée de vue des entités)
set onesync_distanceCullVehicles false
set onesync_distanceCull 500

Configuration du Spawn

spawnpoint 0 -269.4 -955.3 31.2

Coordonnées de spawn par défaut (X, Y, Z). La plupart des frameworks (ESX, QBCore) gèrent le spawn eux-mêmes.

📦 Configuration des Ressources

Démarrer une Ressource

ensure nom_de_la_ressource

Ou :

start nom_de_la_ressource

💡 ensure est recommandé car il redémarre la ressource si elle crash.

Ordre de Chargement

L'ordre des ensure est important ! Certaines ressources dépendent d'autres.

Ordre recommandé :

# 1. Ressources de base FiveM
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure rconlog

# 2. Base de données
ensure oxmysql

# 3. Framework (ESX ou QBCore)
ensure es_extended

# 4. Dépendances communes
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list

# 5. Scripts essentiels
ensure esx_identity
ensure esx_society
ensure esx_billing
ensure esx_banking

# 6. Jobs / Métiers
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob

# 7. Autres scripts
ensure esx_vehicleshop
ensure esx_property
ensure esx_skin

# 8. Scripts custom
ensure mon_script_custom

Arrêter une Ressource

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

# ensure ressource_desactivee

🗄️ Configuration de la Base de Données

Connexion MySQL

set mysql_connection_string "mysql://user:password@host:3306/database?charset=utf8mb4"

Remplacez :

  • user : Nom d'utilisateur MySQL
  • password : Mot de passe MySQL
  • host : Adresse du serveur MySQL
  • 3306 : Port MySQL
  • database : Nom de la base de données

📖 Consultez le guide "Créer et Gérer une Base de Données MySQL" pour créer votre base.

Exemple avec OuiHeberg :

set mysql_connection_string "mysql://s123_bdd:[email protected]:3306/s123_bdd?charset=utf8mb4"

Alternatives de configuration MySQL

Format JDBC (ancien) :

set mysql_connection_string "server=mysql-1.ouiheberg.com;uid=s123_bdd;password=MotDePasse123;database=s123_bdd"

🔒 Configuration des Permissions (ACE/ACL)

Système ACE

Le système ACE (Access Control Entry) gère les permissions sur FiveM.

Ajouter un Administrateur

Par identifiant Steam (recommandé) :

add_ace identifier.steam:110000xxxxxxxxx group.admin allow
add_principal identifier.steam:110000xxxxxxxxx group.admin

Par identifiant Discord :

add_ace identifier.discord:123456789012345678 group.admin allow
add_principal identifier.discord:123456789012345678 group.admin

Par identifiant License :

add_ace identifier.license:xxxxxxxxxxxxxxxxxxxxx group.admin allow
add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxx group.admin

💡 Pour trouver votre identifiant Steam : SteamID.io

Créer des Groupes de Permissions

# Créer le groupe admin avec toutes les permissions
add_ace group.admin command allow
add_ace group.admin command.quit deny

# Créer le groupe modérateur
add_ace group.moderator command.kick allow
add_ace group.moderator command.ban allow

# Hériter les permissions
add_principal group.admin group.moderator

Permissions Courantes

# Permettre au groupe admin d'utiliser toutes les commandes
add_ace group.admin command allow

# Permissions spécifiques
add_ace group.admin command.restart allow
add_ace group.admin command.stop allow
add_ace group.admin command.start allow
add_ace group.admin command.refresh allow

# Permissions vMenu
add_ace group.admin vMenu.everything allow
add_ace group.moderator vMenu.kick allow
add_ace group.moderator vMenu.ban allow

Assigner un Joueur à un Groupe

add_principal identifier.steam:110000xxxxxxxxx group.admin
add_principal identifier.discord:123456789012345678 group.moderator

⚙️ Configuration Réseau

Port du Serveur

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

⚠️ Sur OuiHeberg, le port est géré automatiquement. Utilisez le port assigné à votre serveur.

RCON (Remote Console)

rcon_password "MotDePasseRconTresSecure"

Permet de contrôler le serveur à distance. Utilisez un mot de passe fort !

💡 Laissez vide pour désactiver RCON : rcon_password ""

Configuration Steam

set steam_webApiKey "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Clé API Steam (optionnel, pour certaines fonctionnalités). Obtenez-la sur : Steam Web API Key

🎮 Configuration Gameplay

Activer/Désactiver les Fonctionnalités

# Désactiver le mode passif automatique
sv_disablePassive false

# Activer le PvP
sv_enablePVP true

# Désactiver la synchronisation du temps
sv_disableTimeSync true

# Afficher le logo FiveM au chargement
sv_showFiveMBanner true

Mode Hardcore / Sérieux

# Désactiver le radar automatique
sv_disableRadar true

# Désactiver les notifications natives
sv_disableClientNotify true

# Mode RP sérieux
set sv_enforceGameBuild 2944

Build du Jeu

sv_enforceGameBuild 2944

Force une version spécifique de GTA V. Utile pour la compatibilité des ressources.

Build Version GTA V
2060 Los Santos Summer Special
2189 Cayo Perico
2372 Los Santos Tuners
2545 The Contract
2699 Criminal Enterprises
2944 San Andreas Mercenaries
3095 Chop Shop

📜 Variables Convars Utiles

Définir des Variables

set ma_variable "valeur"
setr ma_variable_repliquee "valeur"
sets ma_variable_serverinfo "valeur"
Commande Visibilité
set Serveur uniquement
setr Répliquée aux clients
sets Visible dans les infos serveur

Variables Framework ESX

set es_enableCustomData 1
set es_startingCash 50000
set es_startingBank 100000
set es_startingBlackMoney 0

Variables Framework QBCore

set qb_locale "fr"
set qb_starterMoney 5000
set qb_starterBank 10000

📄 Fichier server.cfg Complet (Exemple)

Voici un exemple de server.cfg complet et fonctionnel :

# ============================================
# CONFIGURATION DU SERVEUR FIVEM
# ============================================

# === LICENCE ===
sv_licenseKey "votre_cle_de_licence_ici"

# === IDENTITÉ DU SERVEUR ===
sv_hostname "🇫🇷 Mon Serveur RP | Serious Roleplay"
sv_projectName "Mon Serveur RP"
sv_projectDesc "Serveur roleplay francophone avec économie réaliste et communauté active."
sets tags "roleplay, francais, serious, esx, economy"
load_server_icon server_icon.png

# === JOUEURS ===
sv_maxclients 64
set onesync on

# === RÉSEAU ===
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# === RCON ===
rcon_password ""

# === BASE DE DONNÉES ===
set mysql_connection_string "mysql://user:password@host:3306/database?charset=utf8mb4"

# === STEAM (Optionnel) ===
# set steam_webApiKey "XXXXXXXXXXXXXXXXXXXXXXXXXX"

# === GAMEPLAY ===
sv_enforceGameBuild 2944

# ============================================
# PERMISSIONS ACE/ACL
# ============================================

# Groupe Admin
add_ace group.admin command allow
add_ace group.admin command.quit deny

# Administrateurs (remplacez par vos identifiants)
# add_principal identifier.steam:110000xxxxxxxxx group.admin
# add_principal identifier.discord:123456789012345678 group.admin

# ============================================
# RESSOURCES
# ============================================

# === Base FiveM ===
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure rconlog

# === Base de données ===
ensure oxmysql

# === Framework ESX ===
ensure es_extended
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list

# === Scripts ESX ===
ensure esx_identity
ensure esx_society
ensure esx_billing
ensure esx_banking
ensure esx_skin

# === Métiers ===
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob

# === Autres scripts ===
ensure esx_vehicleshop
ensure esx_property

# === Scripts custom ===
# ensure mon_script

🔧 Dépannage

Le serveur ne démarre pas

❌ Erreur ✅ Solution
Invalid license key Vérifiez votre clé sur Keymaster
License key not set Ajoutez sv_licenseKey dans server.cfg
Could not find resource Vérifiez que la ressource existe dans le dossier resources
MySQL connection failed Vérifiez la chaîne de connexion MySQL

Le serveur n'apparaît pas dans la liste

❌ Cause ✅ Solution
Clé de licence invalide Régénérez une clé sur Keymaster
Port bloqué Vérifiez que les ports TCP/UDP sont ouverts
Serveur en démarrage Attendez quelques minutes

Ressource qui ne charge pas

❌ Cause ✅ Solution
Dépendance manquante Vérifiez les dépendances requises
Erreur dans le script Consultez la console (F8 en jeu)
Mauvais ordre de chargement Réorganisez les ensure
fxmanifest.lua manquant Vérifiez que le fichier existe

Erreur de base de données

❌ Erreur ✅ Solution
Access denied Vérifiez user/password MySQL
Unknown database Créez la base de données
Connection refused Vérifiez l'host et le port

Permissions ACE non appliquées

❌ Cause ✅ Solution
Mauvais identifiant Vérifiez le format (steam:, discord:, license:)
Serveur non redémarré Redémarrez après modification
Faute de frappe Vérifiez la syntaxe

📝 Commandes Console Utiles

Commande Description
restart [ressource] Redémarre une ressource
stop [ressource] Arrête une ressource
start [ressource] Démarre une ressource
refresh Actualise la liste des ressources
status Affiche les joueurs connectés
quit Arrête le serveur

📝 Récapitulatif

1. Obtenir une clé de licence sur Keymaster (Cfx.re)
2. Arrêter le serveur
3. Gestionnaire de fichiers → server.cfg → Modifier
4. Configurer :
   - sv_licenseKey (obligatoire)
   - sv_hostname (nom du serveur)
   - sv_maxclients (slots)
   - mysql_connection_string (base de données)
   - Ressources (ensure)
   - Permissions ACE (admins)
5. Enregistrer le fichier
6. Redémarrer le serveur
7. Vérifier dans la liste des serveurs FiveM
Retour à la documentation