server.cfg expliqué : chaque ligne du server.cfg FiveM, une par une

Vous avez ouvert server.cfg et c'est un mur de lignes que vous avez copié d'une recette. Ce guide parcourt les lignes que vous trouverez dans la plupart des serveurs, dans l'ordre où elles apparaissent généralement, avec une brève explication et un lien vers un guide plus détaillé le cas échéant.

#Endpoints

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

Ce sont l'adresse et le port où le serveur écoute. 0.0.0.0 signifie chaque interface réseau, et 30120 est le port par défaut. Les joueurs se connectent via UDP et utilisent TCP pour HTTP et le proxy txAdmin, donc vous ouvrez les deux dans votre pare-feu. Avec txAdmin, l'interface et le port sont généralement gérés pour vous, et les paramètres txAdmin peuvent se plaindre s'ils ne correspondent pas. Si les joueurs ne peuvent pas se connecter de l'extérieur, consultez port forwarding.

#Nom et liste

sv_hostname "My Server"
sets sv_projectName "My Server"
sets sv_projectDesc "A friendly roleplay server"
sets tags "roleplay, esx, english"
sets locale "en-US"
load_server_icon myLogo.png

• sv_hostname est le nom du serveur plus ancien.
• sv_projectName et sv_projectDesc sont le nom et la description dans la liste des serveurs. La forme sets les publie.
• tags sont les mots-clés par lesquels les gens filtrent, et locale est la langue.
• load_server_icon charge un petit PNG depuis le dossier du serveur.

Les couleurs, les bannières et la taille de l'icône sont couvertes dans server icon, banner and tags.

#Joueurs

sv_maxclients 48

Le nombre d'emplacements de joueurs. Aller au-delà de 48 nécessite OneSync et un niveau de support sur le côté Cfx.re. Les détails sont dans OneSync and the player limit.

#Clés

sv_licenseKey "cfxk_xxxxxxxxxxxxxxxxxxxx_xxxxx"
set steam_webApiKey "none"

sv_licenseKey est la clé du Cfx.re Portal, et le serveur ne démarrera pas sans une clé valide. Voir server license key error. steam_webApiKey n'est nécessaire que si vous voulez des identifiants Steam, et none est accepté quand vous ne le faites pas. Les deux lignes sont des secrets : ne partagez pas votre server.cfg dans les captures d'écran.

#Base de données

set mysql_connection_string "mysql://user:password@localhost/dbname?charset=utf8mb4"

La chaîne de connexion qu'oxmysql lit. Les valeurs incorrectes donnent les erreurs dans oxmysql connection error. Utilisez set, pas setr ou sets, de sorte que le mot de passe reste sur le serveur.

#OneSync et game build

set onesync on
sv_enforceGameBuild 3258

onesync on active OneSync, qui est la norme pour les serveurs modernes et nécessaire pour de nombreux emplacements. sv_enforceGameBuild force les clients à utiliser une version du jeu, et les voitures DLC, les vêtements et les cartes nécessitent une version récente. Les numéros de build et ce qu'ils déverrouillent sont dans sv_enforceGameBuild and DLC. Utilisez un numéro de build pris en charge par vos artefacts, pas seulement celui de cet exemple.

#Ressources : ensure

ensure oxmysql
ensure ox_lib
ensure es_extended
ensure [standalone]

Chaque ensure démarre une ressource, ou un dossier de support complet. L'ordre compte : les bases de données, les bibliothèques et le framework en premier. Voir server.cfg ensure order. Si l'un d'eux échoue, couldn't start resource explique le message.

#Permissions : add_ace et add_principal

add_ace group.admin command allow
add_principal identifier.fivem:1234567 group.admin

add_ace donne une permission à un groupe, ici chaque commande. add_principal met un joueur (par identifiant) dans ce groupe. Remplacez l'identifiant par le vôtre. L'explication complète, avec la différence entre ACE et les propres groupes de votre framework, est dans ACE permissions.

#Inclusion d'autres fichiers : exec

exec permissions.cfg
exec resources.cfg

exec exécute un autre fichier cfg comme si ses lignes étaient ici. Diviser les permissions ou les ressources dans leurs propres fichiers garde server.cfg lisible, et vous pouvez garder les secrets dans un fichier que vous ne partagez jamais.

#Un exemple minimal

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

sv_licenseKey "cfxk_..."
sv_hostname "My Server"
sets sv_projectName "My Server"
sets sv_projectDesc "A friendly roleplay server"
sets tags "roleplay"
sets locale "en-US"
load_server_icon myLogo.png
sv_maxclients 48
set onesync on
set mysql_connection_string "mysql://user:password@localhost/dbname?charset=utf8mb4"

ensure oxmysql
ensure ox_lib
ensure es_extended

Attention : une faute de frappe dans une ligne n'arrête pas toujours le serveur. Une convar mal orthographiée est créée silencieusement et ne fait rien. Quand un paramètre semble ignoré, vérifiez d'abord l'orthographe.

#Liste de contrôle