Gamebuild et artifacts FiveM : configurer la bonne version sur son serveur

Sur un serveur FiveM, deux parametres determinent quels contenus GTA Online sont accessibles aux joueurs : le gamebuild (la version du client imposee par sv_enforceGameBuild) et les artifacts (les binaires FXServer qui font tourner le serveur). Un gamebuild trop bas et les vehicules DLC ne spawnent pas, les interieurs restent vides, les textures manquent. Des artifacts obsoletes et le serveur refuse de demarrer avec un gamebuild recent. Ce guide explique comment configurer les deux correctement sur votre serveur dedie ou votre VPS.

Ce guide s'adresse aux administrateurs de serveurs FiveM qui hebergent un serveur de jeu sur un VPS Linux, un VPS Windows ou un serveur dedie physique. Vous y trouverez le tableau complet des gamebuilds avec les DLC qu'ils debloquent, les prerequis materiels (RAM, processeur, stockage SSD), la procedure de mise a jour des artifacts sous Windows et Linux en ligne de commande, la sauvegarde de la base de donnees MySQL avant toute modification, et les pieges a eviter (ymaps cassees, scripts incompatibles). Si vous debutez avec FiveM, consultez d'abord notre page hebergement serveur FiveM.

Qu'est-ce qu'un gamebuild FiveM

Un gamebuild est un numero de version du client GTA V que le serveur FiveM impose aux joueurs qui se connectent via l'adresse IP ou le nom de domaine du serveur. Chaque gamebuild correspond a un DLC GTA Online specifique et debloque les vehicules, armes, vetements, interieurs et maps ajoutes par ce DLC et tous les precedents. Par defaut, un serveur FiveM utilise le build 1604 (Arena War, decembre 2018), qui ne contient aucun contenu post-2019.

La variable serveur qui controle ce numero est sv_enforceGameBuild. Elle se definit dans le fichier de configuration server.cfg et ne peut etre modifiee qu'au demarrage du serveur : un changement en cours de fonctionnement n'a aucun effet. Quand un joueur se connecte, le client FiveM ajuste automatiquement sa version de jeu pour correspondre au gamebuild impose. Ce mecanisme est transparent pour le joueur, mais le premier chargement d'un nouveau build peut prendre plusieurs minutes selon la bande passante de sa connexion.

Tableau des gamebuilds FiveM

Chaque gamebuild inclut tout le contenu des builds precedents. Monter de build debloque du contenu supplementaire, mais impose aussi aux joueurs de telecharger les fichiers correspondants au premier lancement. Voici la liste complete des builds supportes par FiveM (source : documentation officielle Cfx.re) :

Le build 2189 (Cayo Perico Heist) est le minimum requis pour tout serveur RP qui utilise l'ile de Cayo Perico ou les interieurs associes. Le build 3095 (The Chop Shop) est aujourd'hui le plus repandu sur les serveurs RP francophones car il offre un bon equilibre entre contenu disponible et compatibilite des scripts et des ressources. Les builds superieurs (3258 et au-dela) ajoutent des vehicules et des interieurs, mais certains scripts ou certaines maps custom ne sont pas encore testes sur ces versions.

Prerequis serveur selon le gamebuild

Le choix du gamebuild a un impact direct sur les ressources materielles du serveur. Un build plus eleve charge davantage d'assets en memoire (vehicules, textures, interieurs DLC), ce qui augmente la consommation de RAM et la charge processeur (CPU). La base de donnees MySQL utilisee par les frameworks RP (ESX, QBCore, QBox) pour stocker les donnees des joueurs (inventaires, comptes bancaires, vehicules) est aussi davantage sollicitee quand le serveur gere un catalogue de vehicules elargi. Voici les ressources recommandees pour heberger un serveur FiveM RP :

Le stockage SSD (idealement NVMe) est indispensable : la base de donnees MySQL effectue de nombreuses lectures et ecritures simultanees, et un disque dur traditionnel cree un goulot d'etranglement des que le nombre de joueurs depasse 30. La bande passante reseau compte aussi : chaque joueur qui se connecte pour la premiere fois avec un gamebuild superieur telecharge les fichiers DLC correspondants, ce qui genere un pic de trafic transitoire sur le serveur.

Un VPS Linux avec acces root convient pour les serveurs de 1 a 64 joueurs. La virtualisation KVM utilisee sur les VPS garantit une isolation complete des ressources (RAM, CPU, stockage) par rapport aux autres serveurs virtuels heberges sur la meme machine physique. Au-dela de 64 joueurs, un serveur dedie physique offre des performances superieures grace a des ressources non partagees et un processeur dont la totalite de la puissance est dediee a votre serveur FiveM.

Comment choisir le bon gamebuild

Le choix du gamebuild depend des ressources et scripts installes sur votre serveur. Voici la methode :

1. Lister les scripts qui exigent un DLC specifique. Un script de vehicules du DLC Bottom Dollar Bounties ne fonctionnera pas sur un build inferieur a 3258. Les scripts bien documentes indiquent le gamebuild minimum dans leur fichier README ou dans la directive games de fxmanifest.lua.
2. Identifier le build le plus eleve requis. Puisque chaque build inclut tout le contenu des precedents, le build le plus eleve parmi tous vos scripts est celui que le serveur doit imposer.
3. Verifier la compatibilite des maps custom (ymaps). C'est le piege principal : une map creee pour le build 2545 peut afficher des routes invisibles ou des textures cassees sur le build 3095 si elle n'a pas ete re-exportee avec le bon niveau de DLC dans CodeWalker. Avant de monter de build, testez chaque map custom sur un serveur de test.
4. Verifier la compatibilite des artifacts. Le gamebuild choisi doit etre supporte par la version des artifacts installes. Des artifacts trop anciens ne reconnaissent pas les builds recents.
5. Controler l'impact sur la base de donnees. Certains frameworks RP stockent les identifiants de vehicules et d'armes dans les tables MySQL. Un changement de gamebuild peut modifier les hashs de ces objets. Avant tout changement, sauvegardez votre base de donnees et testez sur un environnement de pre-production.

En cas de doute, commencez par le build 3095 (The Chop Shop) : c'est le standard actuel pour la majorite des frameworks RP (ESX, QBCore, QBox). Montez uniquement si un script ou un vehicule specifique l'exige. Pour comprendre les differences entre les principaux frameworks, consultez notre comparatif ESX Legacy vs QBCore.

Configurer sv_enforceGameBuild

Connectez-vous au serveur en SSH (Linux) ou via le bureau a distance (Windows) et ouvrez le fichier de configuration server.cfg. Ajoutez la ligne suivante en utilisant le numero de build ou son alias :

sv_enforceGameBuild 3095

Ou avec l'alias :

sv_enforceGameBuild mp2023_02

Sur un VPS Linux sous Debian ou Ubuntu, editez le fichier directement en ligne de commande depuis le terminal SSH :

sudo nano /home/fivem/server-data/server.cfg

Redemarrez le serveur pour appliquer le changement. Cette variable est lue une seule fois au demarrage : la modifier dans la console en cours de fonctionnement ou via txAdmin sans redemarrage n'a pas d'effet. Pour administrer votre serveur et gerer les redemarrages, consultez notre guide configurer txAdmin sur un serveur FiveM.

Pour verifier le gamebuild actif apres le demarrage, ouvrez la console serveur (txAdmin ou le terminal SSH) et cherchez la ligne :

[sv_enforceGameBuild] Enforcing game build 3095 (mp2023_02)

Si votre serveur est accessible via un nom de domaine avec enregistrement DNS SRV, le changement de gamebuild n'affecte pas la resolution DNS ni l'adresse IP du serveur. Les joueurs continuent a se connecter via la meme adresse, seul le contenu DLC disponible change.

Qu'est-ce que les artifacts FiveM

Les artifacts (aussi appeles FXServer builds) sont les binaires du serveur FiveM : le fichier executable FXServer.exe sous Windows ou les fichiers du runtime sous Linux, plus les bibliotheques associees. C'est le moteur qui fait tourner votre serveur de jeu. Les artifacts incluent aussi txAdmin, le panneau d'administration web integre qui permet de gerer le serveur depuis un navigateur sans connexion SSH directe.

Les artifacts sont publies par l'equipe Cfx.re sur le depot officiel. Chaque nouvelle version apporte le support des gamebuilds recents, des correctifs de securite, des ameliorations de performances et des mises a jour de txAdmin. Un serveur dont les artifacts datent de plusieurs mois risque de ne pas supporter les derniers gamebuilds et de manquer des correctifs importants. Pour securiser votre serveur au-dela des artifacts, consultez notre guide securiser un serveur FiveM (anti-cheat et anti-DDoS).

Trois canaux de publication existent :

• Recommended : version stable testee par Cfx.re sur des milliers de serveurs en production. C'est le choix par defaut pour tout serveur qui heberge des joueurs.
• Optional : version plus recente, generalement stable, pour acceder a un correctif ou une fonctionnalite pas encore dans Recommended.
• Latest : derniere compilation du pipeline, non testee en production. Reservee aux serveurs de developpement et de test.

Mettre a jour les artifacts

Avant toute mise a jour, sauvegardez votre dossier serveur et votre base de donnees MySQL. Les artifacts sont independants de vos ressources et de votre configuration : la mise a jour ne touche ni server.cfg, ni le dossier resources/, ni les bases de donnees. Mais en cas de probleme, un backup complet permet de restaurer l'etat precedent en quelques minutes.

Sous Windows

1. Arretez le serveur FiveM (fermez FXServer ou arretez-le via txAdmin).
2. Telechargez les derniers artifacts Recommended depuis le depot officiel Cfx.re (section build_server_windows). Le fichier telecharge est une archive server.7z.
3. Extrayez l'archive dans un nouveau dossier temporaire.
4. Remplacez les fichiers du dossier serveur actuel par ceux extraits. Conservez vos dossiers resources/, server-data/ et votre server.cfg.
5. Redemarrez le serveur et verifiez dans la console que la version a change.

Sur Linux (Debian, Ubuntu)

La majorite des hebergeurs deploient les serveurs FiveM sur une distribution Linux comme Debian 12 ou Ubuntu 22.04 LTS. Si vous administrez votre serveur dedie ou votre VPS via SSH avec un acces root ou un utilisateur sudo, voici la procedure en ligne de commande :

1. Connectez-vous en SSH a votre serveur :

ssh utilisateur@adresse-ip-du-serveur

2. Arretez le serveur. Si vous utilisez un service systemd :

sudo systemctl stop fivem

3. Telechargez les artifacts Linux Recommended depuis le depot officiel (section build_proot_linux). Le fichier est une archive fx.tar.xz. Remplacez le numero par la version Recommended actuelle :

cd /home/fivem/server
wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/NUMERO-ID/fx.tar.xz
tar xf fx.tar.xz

4. Redemarrez le serveur et verifiez la version dans les logs :

sudo systemctl start fivem
sudo journalctl -u fivem -f

Si votre serveur n'utilise pas de service systemd, vous pouvez le demarrer directement dans une session screen ou tmux. Pour mettre en place un demarrage automatique au boot, consultez notre guide creer un service systemd pour un serveur de jeu Linux. Verifiez aussi que les ports sont ouverts dans le pare-feu (port 30120 TCP et UDP par defaut pour FiveM).

Pour optimiser les performances de votre serveur apres la mise a jour, consultez notre guide optimiser les performances d'un serveur FiveM.

Sauvegarder le serveur et la base de donnees avant modification

Avant tout changement de gamebuild ou de version d'artifacts, une sauvegarde complete (backup) du serveur est indispensable. Trois elements doivent etre sauvegardes :

• La base de donnees MySQL. Les frameworks RP comme ESX, QBCore et QBox stockent toutes les donnees des joueurs dans une base de donnees MySQL (ou MariaDB) : inventaires, comptes bancaires, vehicules, proprietes, identites. Un export avec mysqldump cree une copie complete de ces bases de donnees :

mysqldump -u root -p --all-databases > /home/fivem/backups/backup-mysql-$(date +%F).sql

• Le dossier resources/ et server.cfg. Vos scripts Lua, fichiers de configuration et maps custom :

tar czf /home/fivem/backups/backup-resources-$(date +%F).tar.gz \
  /home/fivem/server-data/resources/ /home/fivem/server-data/server.cfg

• Les artifacts actuels. Si la nouvelle version pose probleme, vous pouvez restaurer les binaires precedents et redemarrer le serveur en quelques minutes.

Pour automatiser ces sauvegardes, consultez notre guide sauvegardes serveur FiveM. Pour configurer ou depanner la connexion entre votre serveur et la base de donnees MySQL, consultez le guide lier une base de donnees MySQL a un serveur FiveM.

Pieges a eviter

Voici les problemes les plus frequents lors d'un changement de gamebuild ou d'une mise a jour d'artifacts :

• Maps custom (ymaps) cassees apres un changement de build. C'est le piege le plus courant. Une ymap creee dans CodeWalker pour un build donne peut afficher des routes invisibles, des textures floues ou des props manquants sur un build superieur. La solution : re-exporter la map dans CodeWalker en selectionnant le DLC correspondant au nouveau gamebuild, puis remplacer les fichiers sur le serveur. Testez toujours sur un serveur de test avant de deployer en production. Pour approfondir le sujet du mapping, consultez notre guide debuter le mapping FiveM.
• Scripts incompatibles avec un build superieur. Certains scripts anciens utilisent des natives (fonctions internes du jeu) dont le comportement change entre les builds. Les symptomes : erreurs dans la console serveur, fonctionnalites qui ne repondent plus, crashes du client. Verifiez la compatibilite de chaque script avant de monter le gamebuild. Pour trouver des scripts fiables et a jour, consultez notre guide scripts FiveM : ou les trouver, lesquels eviter.
• Artifacts trop anciens pour le gamebuild choisi. Si vous configurez sv_enforceGameBuild 3889 avec des artifacts datant de 2024, le serveur ne reconnaitra pas ce build et refusera de demarrer. Mettez a jour les artifacts en premier, puis changez le gamebuild dans server.cfg.
• Base de donnees non sauvegardee avant le changement. Un changement de gamebuild peut reveler des incompatibilites dans les scripts qui accedent aux bases de donnees MySQL. Sans backup, la restauration des donnees est impossible. Effectuez toujours un export mysqldump avant de modifier le gamebuild ou les artifacts.
• Icones de blip invisibles. Les icones de la carte (blips) ajoutees par les DLC recents apparaissent en blanc ou sont absentes si le gamebuild du serveur est trop ancien pour contenir leurs sprites.
• Vetements et accessoires invisibles. Les composants vestimentaires ajoutes par un DLC ne s'affichent pas si le serveur utilise un build anterieur a ce DLC. Les personnages apparaissent partiellement nus ou avec des textures par defaut.
• Telechargement d'artifacts depuis des sources non officielles. Utilisez uniquement le depot officiel Cfx.re pour telecharger les artifacts. Les fichiers distribues via Discord ou des sites tiers peuvent contenir du code modifie ou des backdoors qui compromettent la securite de votre serveur, de vos bases de donnees et de l'adresse IP de vos joueurs.

Questions frequentes

Les reponses aux questions les plus posees par les administrateurs sur les gamebuilds et artifacts FiveM.