Les artifacts FiveM expliqués

1. Ce qu'est un artifact FiveM

Cfx.re publie de nouvelles builds de FXServer plusieurs fois par semaine sur runtime.fivem.net, numérotées par ordre croissant. Chaque build est un paquet serveur complet : les binaires FXServer, le runtime Citizen et le txAdmin fourni. Vos resources, votre server.cfg et votre base de données n'en font pas partie ; ils restent en place quand vous changez de build.

Le numéro de build est ce que vérifient la liste des serveurs et le client du jeu. Quand Cfx.re publie une mise à jour du client qui exige un serveur plus récent, les serveurs sur d'anciennes builds n'acceptent plus de nouveaux joueurs tant qu'ils ne sont pas mis à jour ; c'est pourquoi la mise à jour des artifacts est la tâche de maintenance la plus courante sur un serveur FiveM.

2. Recommended, latest ou une build précise ?

Cfx.re marque une build comme Recommended : celle qui est sortie depuis assez longtemps pour être fiable. La build Latest est la plus récente publiée, parfois vieille de quelques heures seulement. Pour un serveur roleplay public, Recommended est le choix sûr ; prenez Latest uniquement si une mise à jour du client l'exige ou si une entrée du changelog corrige un problème que vous rencontrez.

Les anciennes builds restent en ligne, vous pouvez donc aussi fixer un numéro précis, par exemple quand une resource dont vous dépendez casse sur une build plus récente. Le changelog sur changelogs.fivem.net liste ce qui a changé entre les builds et signale celles marquées critical.

3. Vérifier quelle build votre serveur exécute

Ouvrez la page de connexion txAdmin de votre serveur : le pied de page affiche deux versions, comme tx: v8.1.1 | fx: b suivi d'un numéro. Ce numéro fx est votre artifact, et vous n'avez même pas besoin de vous connecter pour le lire. La console du serveur affiche le même numéro juste après le démarrage.

4. Mettre à jour sur un serveur VibeGAMES (un clic)

Dans le panel de jeu, ouvrez votre serveur et cliquez sur Artifacts Updater sous Game Server. La liste affiche les builds de runtime.fivem.net, avec l'étiquette Recommended sur celle que Cfx.re conseille et l'étiquette Optional sur la plus récente ; un champ de recherche permet de trouver un numéro précis.

Choisissez une build et appuyez sur Install. Le panel arrête le serveur, télécharge la build directement depuis Cfx.re et redémarre le serveur ; la page Console indique quand il est de retour. Vos resources, server.cfg, données txAdmin et base de données restent intacts. Si vous sautez beaucoup de builds d'un coup, faites d'abord une sauvegarde.

Les serveurs passés sur FiveM for GTAV Enhanced exécutent toujours automatiquement la dernière build, l'outil de mise à jour y est donc en lecture seule ; revenez en arrière sur la page GTAV Enhanced si vous devez fixer une build.

5. Mettre à jour à la main sur un VPS ou un serveur dédié

Arrêtez le serveur. Téléchargez la build voulue depuis runtime.fivem.net (fx.tar.xz pour Linux, server.7z pour Windows), extrayez-la dans un nouveau dossier à côté de l'ancien et faites pointer votre commande de démarrage ou run.sh vers le nouveau dossier. Votre dossier server-data avec les resources, server.cfg et le cache reste où il est.

Démarrez le serveur et surveillez dans la console le numéro de build et la ligne indiquant que l'authentification de la clé de licence a réussi. Gardez l'ancien dossier tant que vous n'êtes pas sûr que tout fonctionne ; revenir en arrière consiste alors simplement à refaire pointer la commande de démarrage.

6. Quand une mise à jour casse quelque chose

Un serveur qui ne démarre plus après une mise à jour, c'est généralement une resource qui utilise une API supprimée par la nouvelle build, ou un profil txAdmin qui a besoin d'une réinitialisation. Cherchez dans la console la première ligne rouge, désactivez la resource qu'elle nomme et réessayez. Si cela ne suffit pas, réinstallez la build Recommended ; rétrograder est aussi sûr que monter de version.

Les auteurs de resources publient des notes de compatibilité sur le forum Cfx.re et sur leurs pages de publication ; après un grand saut, il vaut donc la peine de mettre à jour vos plus grosses resources (framework, inventaire, anti-cheat) dans la même session.

7. À quelle fréquence mettre à jour ?

Une fois toutes les quelques semaines suffit pour la plupart des serveurs, plus chaque fois qu'une mise à jour du client empêche les joueurs de se connecter. Surveillez dans le changelog les builds marquées critical : elles corrigent des problèmes de sécurité ou de stabilité et méritent d'être installées tout de suite. Sur VibeGAMES, une mise à jour, c'est un clic et environ une minute d'interruption, il n'y a donc aucune raison de garder un an de retard.