Remplissez le formulaire, copiez le fichier et posez-le dans le dossier de votre serveur FiveM. Chaque bloc est expliqué plus bas : réseau, base de données, ressources, places, sécurité et administrateurs. Pour l’installation complète, suivez le guide créer un serveur FiveM RP.
# server.cfg généré sur geobase.fr/outils/generateur-server-cfg ## Réseau : le même port en TCP et en UDP, à ouvrir dans le pare-feu endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" ## Base de données (oxmysql) : remplacez MOT_DE_PASSE, jamais en clair dans un dépôt public set mysql_connection_string "mysql://fivem:MOT_DE_PASSE@localhost/fivem?charset=utf8mb4" ## Ressources, dans l'ordre de démarrage ensure mapmanager ensure chat ensure spawnmanager ensure sessionmanager ensure hardcap ensure oxmysql ensure es_extended # le dossier [core] de la recette txAdmin ESX ensure [core] ## Identité dans la liste des serveurs sv_hostname "Ma ville RP" sets sv_projectName "Ma ville RP" sets sv_projectDesc "Serveur RP francophone" sets tags "roleplay, fr, serious" sets locale "fr-FR" # Logo dans la liste : PNG de 96 × 96 à côté de ce fichier, puis retirez le # de la ligne suivante # load_server_icon logo.png ## Places et synchronisation sv_maxclients 48 set onesync on ## Sécurité sv_scriptHookAllowed 0 sv_endpointPrivacy true ## Administrateurs add_ace group.admin command allow add_ace group.admin command.quit deny # add_principal identifier.fivem:VOTRE_ID group.admin ## Clé de licence : créée sur portal.cfx.re, à ne jamais partager sv_licenseKey "VOTRE_CLE_CFX"
Réseau : endpoint_add_tcp et endpoint_add_udp
Le serveur écoute sur un seul port, en TCP pour la connexion et les téléchargements, en UDP pour le jeu. Le port par défaut est 30120. Ouvrez-le dans les deux protocoles, dans le pare-feu de la machine et chez votre hébergeur.
0.0.0.0 veut dire « toutes les adresses de la machine ». Ne le remplacez par une adresse précise que si la machine en a plusieurs et que vous savez laquelle sert au jeu.
Base de données : mysql_connection_string
Les frameworks RP enregistrent les joueurs, l’argent et les objets dans une base MariaDB ou MySQL, via la ressource oxmysql. La chaîne de connexion contient l’utilisateur, le mot de passe, l’hôte et le nom de la base.
Le générateur laisse MOT_DE_PASSE à remplacer chez vous. Un server.cfg avec un vrai mot de passe ne doit jamais finir sur un dépôt public, une capture d’écran ou un salon Discord.
Ressources : l’ordre des ensure compte
ensure démarre une ressource. L’ordre est celui des lignes : une ressource doit démarrer après celles dont elle dépend. oxmysql passe donc avant le framework, et le framework avant les scripts qui l’utilisent.
Le générateur pose les ressources de base de Cfx.re, oxmysql et le cœur du framework choisi. Un nom entre crochets, comme [qb], démarre tout un dossier d’un coup : c’est ce que font les recettes de txAdmin. Pour comparer les frameworks, lisez ESX, QBCore ou Qbox.
Identité : sv_hostname, sv_projectName et tags
sv_hostname est le nom technique du serveur. sv_projectName et sv_projectDesc sont le nom et la description affichés dans la liste des serveurs FiveM. Les tags aident les joueurs à vous trouver par filtre : « roleplay », « fr », « serious », « whitelist »…
load_server_icon affiche votre logo dans la liste. L’image doit être un PNG de 96 × 96 pixels posé à côté du server.cfg.
Places et OneSync : sv_maxclients
sv_maxclients fixe le nombre de joueurs connectés en même temps. Sans abonnement, la limite est de 48. Au-delà, la clé de licence doit être liée à un abonnement Element Club (tarifs sur fivem.net/server-hosting).
OneSync est le mode de synchronisation dont dépendent les frameworks RP actuels. Avec txAdmin, il se règle aussi dans les paramètres du serveur : gardez une seule source de vérité pour éviter les surprises au démarrage.
Sécurité : sv_scriptHookAllowed et sv_endpointPrivacy
sv_scriptHookAllowed 0 refuse les clients qui chargent des menus ScriptHook. sv_endpointPrivacy true retire les adresses IP des joueurs des informations publiques du serveur.
Ces deux lignes ne remplacent ni un anticheat ni une protection réseau. Le reste se joue dans le code des ressources et devant le serveur : voir protéger son serveur FiveM.
Administrateurs : add_ace et add_principal
add_ace donne une permission à un groupe, add_principal place un joueur dans ce groupe. Le modèle donne toutes les commandes au groupe admin, sauf quit qui éteindrait le serveur.
L’identifiant du joueur s’écrit fivem:…, discord:… ou license:…. txAdmin l’affiche dans la fiche du joueur. Donnez ce groupe au strict nécessaire : chaque compte admin est une porte d’entrée.
Clé de licence : sv_licenseKey
Sans clé, le serveur ne démarre pas. Elle se crée gratuitement sur portal.cfx.re, avec le compte Cfx.re qui possédera le serveur. Les ressources achetées sous escrow ne tournent que sur une clé de ce même compte.
Gardez-la secrète. Si elle fuit, régénérez-la sur le portail et remplacez-la dans le fichier.
Sans server.cfg à écrire
Sur GeoBase, le serveur est livré installé, hébergé et protégé. Le nom, le logo, la couleur et l’écran de chargement se règlent en cinq minutes dans le panel, sans toucher à ce fichier : voir la documentation et les offres.
Questions fréquentes
- Où se trouve le fichier server.cfg ?
- Dans le dossier de données du serveur (server-data), à côté du dossier resources. Avec txAdmin, il s’ouvre aussi depuis l’éditeur de configuration de l’interface web.
- Faut-il redémarrer le serveur après une modification du server.cfg ?
- Oui. Le fichier n’est lu qu’au démarrage. Une ressource ajoutée par
ensurene démarre qu’au prochain lancement, ou à la main avec la commandeensure nom_de_la_ressourcedans la console. - Pourquoi mon serveur n’apparaît pas dans la liste FiveM ?
- Le plus souvent, le port n’est pas ouvert en TCP et en UDP, la clé de licence est invalide ou liée à un autre compte, ou la ligne
sv_master1 ""a été ajoutée, ce qui cache le serveur de la liste. - Combien de places sans payer ?
- Jusqu’à 48 joueurs. Au-delà, la clé de licence doit être liée à un abonnement Element Club de Cfx.re (Argentum, Aurum ou Platinum selon le nombre de places).