Configurer le server.cfg de FiveM et vérifier vos modifications

Modifiez le server.cfg que votre profil FXServer ou txAdmin actif charge réellement. Conservez une copie fonctionnelle, ne modifiez que le paramètre dont vous avez besoin et vérifiez le démarrage ainsi qu'une véritable connexion de joueur. L'outil de configuration ci-dessous peut vous aider à rédiger des paramètres ; comparez sa sortie à vos ressources installées et à la référence officielle.

Les exemples de configuration et de code ici ciblent FiveM pour GTA V Legacy. Enhanced a des règles d'exécution et de compatibilité différentes ; vérifiez les changements Legacy-to-Enhanced de Cfx.re avant de les appliquer à un serveur Enhanced.

[fivemx_server_cfg_tool]

Trouver la configuration active

Dans txAdmin, inspectez le profil de serveur sélectionné et le chemin de configuration server-data/configuration. Pour une installation manuelle, inspectez la commande de démarrage et sa +exec argument. Le fichier n'a pas besoin d'être à côté de l'exécutable FXServer. Modifier une copie inutilisée ne change rien.

Sauvegardez le fichier et tous les fichiers inclus avant de les modifier. Conservez votre clé de licence, votre chaîne de connexion à la base de données et les autres secrets dans une configuration côté serveur protégée. Ne les incluez jamais dans des captures d'écran ni dans des scripts client/partagés.

Comprendre set, sets et setr

set définit une convar serveur. sets publie les informations du serveur, et setr réplique une valeur vers les clients. Utilisez la forme requise par le paramètre documenté. N'utilisez jamais un paramètre public ou répliqué pour des identifiants.

Un petit exemple de configuration

Ces lignes illustrent des paramètres de réseau et d'identité publique. Elles ne constituent pas une installation complète de framework : conservez la clé d'enregistrement de serveur valide, les exigences de la recette installée et la liste explicite des ressources dans votre configuration privée.

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sv_hostname "My Roleplay Server"
sets sv_projectName "My Roleplay Server"
sets sv_projectDesc "English roleplay with a guided start"
sets locale "en-US"
sv_maxclients 8

Utilisez le port attribué par votre hébergeur et autorisez le trafic TCP/UDP requis. Définissez la limite de slots en fonction de vos droits et de la capacité testée. Augmenter simplement ce nombre n'ajoute ni puissance de traitement ni droits de slots joueurs.

Démarrez les dépendances avant les ressources qui les utilisent

Suivez la recette de votre framework et le manifest de chaque ressource. Par exemple, une ressource utilisant oxmysql doit être chargée après ce driver et après la définition de sa chaîne de connexion. Incluez une liste de ressources distincte avec exec resources.cfg si cela permet de conserver une configuration lisible.

Évitez de copier l'intégralité de la liste de ressources d'un autre serveur. Chaque ensure doit désigner un élément installé intentionnellement. Conservez les paramètres propres au démarrage dans l'emplacement de démarrage/configuration pris en charge et effectuez un redémarrage complet lorsque cela est nécessaire.

Gardez le game build et les artifacts distincts

Les artifacts FXServer constituent le runtime du serveur. sv_enforceGameBuild sélectionne le contenu GTA requis par les ressources. Choisissez une valeur prise en charge dans la référence des commandes serveur Cfx.re lorsque cela est nécessaire, et testez les maps/véhicules qui en dépendent. Ce n'est pas un interrupteur universel de prévention des crashs.

Configurez les accès de manière délibérée

Laissez le RCon legacy désactivé, sauf si vous en avez besoin et que vous le sécurisez. N'attribuez que les permissions ACE nécessaires aux identifiants prévus. Vérifiez les cas autorisés et refusés avec des comptes de joueurs ordinaires. Une commande ou un élément d'UI masqué n'est pas une vérification d'autorisation.

N'utilisez pas de paramètres de rate copiés du moteur Source ni de flags d'« optimisation » inconnus. Vérifiez chaque paramètre par rapport à la documentation actuelle ou aux sources du runtime. La confidentialité des endpoints des joueurs est distincte du masquage de l'origine réseau d'un serveur et n'offre aucune protection contre les DDoS.

Vérifiez chaque modification

1. Enregistrez la configuration et redémarrez via le gestionnaire de serveur existant pendant une fenêtre appropriée.
2. Lisez les premières erreurs de démarrage et corrigez les fichiers inclus manquants, les dépendances de ressources ou les arguments invalides.
3. Connectez-vous en utilisant l'endpoint réel, puis vérifiez séparément le nom et la description publics dans la liste des serveurs.
4. Testez le comportement que vous avez modifié ainsi qu'un cas de refus/erreur pertinent.
5. Si la modification échoue, restaurez la configuration connue comme fonctionnelle et redémarrez via le même gestionnaire.

Lorsqu'un paramètre semble sans effet

Confirmez le profil actif et recherchez une autre affectation dans les fichiers de configuration inclus. Vérifiez si le paramètre est lu uniquement au démarrage, s'il nécessite setr, ou s'il appartient à une ressource qui n'est pas en cours d'exécution. Appuyez-vous sur la source/documentation de la ressource concernée plutôt que d'ajouter plusieurs clés d'apparence similaire.

Documentation de référence

Cfx.re — configuration d'un serveur vanilla · Cfx.re — configurer un serveur txadmin

Comment configurer un serveur FiveM avec txAdmin