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.
Open the server.cfg Builder & Checker
Trouver la configuration active
Dans txAdmin, examinez le profil de serveur sélectionné et le chemin configuré vers server-data et la configuration. Pour une installation manuelle, examinez la commande de démarrage et son argument +exec. Le fichier ne doit pas forcément se trouver à 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 8Utilisez 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
- Enregistrez la configuration et redémarrez via le gestionnaire de serveur existant pendant une fenêtre appropriée.
- Lisez les premières erreurs de démarrage et corrigez les fichiers inclus manquants, les dépendances de ressources ou les arguments invalides.
- 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.
- Testez le comportement que vous avez modifié ainsi qu'un cas de refus/erreur pertinent.
- 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