Explication des versions du jeu FiveM

Une version de jeu FiveM sélectionne la base de contenu GTA V qu'un serveur s'attend à ce que les clients utilisent. Les propriétaires de serveurs utilisent sv_enforceGameBuild lorsqu'une ressource a besoin d'éléments ou de natifs d'une version DLC particulière. La version la plus récente disponible n'est pas automatiquement le choix le plus sûr pour un serveur établi.

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.

Ce que sv_enforceGameBuild change

La variable de serveur demande aux clients qui se connectent d'utiliser la version de jeu configurée. Cela peut exposer les véhicules, les cartes, les vêtements, les armes et les natifs associés des DLC requis par les ressources. Cela ne met pas à jour vos scripts, ne répare pas les éléments incompatibles et ne prouve pas que chaque ressource client prend en charge la version sélectionnée.

# server.cfg — example only; choose a tested supported build
set sv_enforceGameBuild 2189

L'exemple sélectionne la base de Cayo Perico, pas une recommandation universelle. Définissez cette valeur au démarrage et redémarrez complètement FXServer. Utilisez les valeurs prises en charge dans la documentation Cfx actuelle. Ne collez pas un numéro de build d'un article non daté en production.

Quand changer la version

• Une ressource documentée nécessite du contenu ou des fonctions natives introduites dans une version plus récente.
• Votre version actuelle n'est plus prise en charge par la plateforme ou une dépendance critique.
• Vous avez une fenêtre de publication définie, des preuves de staging et un plan de restauration.

Ne le changez pas uniquement parce qu'un nombre plus grand existe. Chaque changement de version forcée peut affecter les cartes, les vêtements, les véhicules, les scripts et les téléchargements clients en même temps.

Liste de vérification pour le changement de build

1. Sauvegardez la base de données, la configuration du serveur et l'ensemble complet des ressources.
2. Enregistrez la version actuelle et les versions des artefacts.
3. Mettez d'abord à jour le staging et ne videz que les caches requis par la procédure officielle.
4. Testez la connexion, la sélection des personnages, les vêtements, les intérieurs, les véhicules, les armes et la voix.
5. Exercez les ressources qui utilisent des fonctions natives ou des assets spécifiques à la version.
6. Testez avec un compte joueur normal, un administrateur et plus d'un client.
7. Vérifiez les erreurs de la console du serveur et de F8 et comparez les performances avec la base de référence.
8. Gardez la configuration et les artefacts précédents prêts pour la restauration.

Version du jeu vs. artefacts du serveur

Ils résolvent des problèmes différents. La version du jeu contrôle la base de contenu GTA ; les artefacts FXServer fournissent l'exécution du serveur. La mise à jour de l'un n'implique pas que l'autre doive changer dans la même version. Séparez les changements lorsque cela est possible afin qu'une régression ait une cause claire.

Pannes courantes

Des modèles ou intérieurs manquants signalent généralement une incompatibilité entre les éléments et la version du jeu. Des erreurs de script peuvent provenir d’une hypothèse incorrecte sur une fonction native ou une dépendance. Si de nombreux clients échouent immédiatement après le changement, traitez-le comme un incident de déploiement : revenez d’abord à la version précédente, puis reproduisez le problème en préproduction. Conservez l’erreur exacte, la ressource concernée et les anciennes et nouvelles versions dans le dossier de l’incident.

Pour la maintenance du runtime, consultez mise à jour des artefacts du serveur FiveM.

Documentation de référence

Cfx.re — commandes du serveur