Changer ou rétrograder les artifacts d'un serveur FiveM

Les artifacts FiveM, c'est le build FXServer sur lequel tourne votre serveur. Vous passez de Recommended à Latest depuis l'onglet Version de votre panel DoomHosting, et vous pouvez figer un build plus ancien depuis l'onglet Démarrage quand un script ou un framework n'a pas encore suivi. Aucune des deux méthodes ne touche à votre server.cfg, à vos resources ni à votre base de données.

Ce guide couvre les deux, plus comment trouver un numéro de build précis et quoi faire quand un changement ne prend pas.

Ce qu'est vraiment un artifact FiveM

Cfx.re ne publie pas les serveurs FiveM sous forme de versions numérotées. Il publie un flux continu de builds, chacun identifié par un numéro comme 34833, et en désigne un comme recommandé. Trois noms comptent :

• Recommended : le build que Cfx.re considère stable. C'est celui qu'installe un nouveau serveur DoomHosting.
• Latest : le build le plus récent qui existe. Il reçoit les nouveaux natives et les correctifs en premier, et parfois de nouveaux bugs avec.
• Un build figé : un numéro précis que vous choisissez vous-même, en général un plus ancien sur lequel vos scripts fonctionnent.

Les artifacts ne concernent que le côté serveur. Les joueurs se connectent avec le client FiveM qu'ils ont déjà, donc changer d'artifact n'oblige personne à mettre à jour ou à réinstaller quoi que ce soit.

Passer de Recommended à Latest

Ouvrez votre serveur dans le panel et cliquez sur Version dans le menu de gauche, sous l'intitulé FiveM. Vous obtenez deux cartes avec le numéro de build actuel sous chacune, ce qui montre d'un coup d'oeil si vous êtes en retard.

Cliquez sur la carte voulue et confirmez. Le panel retélécharge les fichiers FXServer et redémarre le serveur.

Cela prend en général quelques minutes. Vos fichiers sont conservés, donc le serveur revient avec les mêmes resources, le même server.cfg et la même connexion à la base qu'avant.

Figer un build artifact plus ancien

Les deux cartes suivent toujours ce que Cfx.re publie à l'instant, elles ne peuvent donc pas vous ramener vers un build précis. Pour cela, vous renseignez le numéro vous-même :

1. Ouvrez Démarrage dans le panel.
2. Repérez le champ fivem version. Il indique recommended par défaut.
3. Remplacez-le par le numéro de build exact que vous voulez, par exemple 34833.
4. Laissez le champ s'enregistrer.

Modifier le champ ne suffit pas encore. Le build est choisi pendant l'étape d'installation, le serveur doit donc être réinstallé pour prendre votre numéro. Allez dans Paramètres, descendez jusqu'à la Zone de danger et cliquez sur Réinstaller le serveur.

Laissez la case "Supprimer aussi tous les fichiers actuels au préalable" décochée. Décochée, la réinstallation ne remplace que les binaires FXServer : votre dossier resources, server.cfg et vos bases de données survivent tous. Cochée, le serveur est vidé d'abord, et ce n'est pas ce que vous voulez ici.

Une fois un numéro de build renseigné, l'onglet Version le dit, au lieu de faire croire qu'un des canaux est actif :

Pour sortir du figeage plus tard, cliquez simplement sur Recommended dans cet onglet. Cela efface le numéro et réinstalle en une fois.

Comment trouver le numéro de build voulu

Deux adresses, et vous voulez les deux ouvertes :

• La liste des artifacts : https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/. Tous les builds encore disponibles pour Linux y figurent, le plus récent en haut, chacun sous forme d'un dossier nommé <build>-<hash>. Vous pouvez coller l'une ou l'autre moitié dans le panel : le numéro seul (34833) ou le nom de dossier complet (34833-68c152444ad75b65017d6e6a56b59b9ef233dc59). Le nom complet est le plus sûr, car un numéro court ou partiel peut correspondre à plusieurs dossiers et l'installation n'arrive alors pas à le résoudre. L'archive est profonde, plusieurs centaines de builds aujourd'hui, donc des builds de bien plus d'un an restent installables.
• Le changelog : https://changelogs-live.fivem.net/ indique ce qui a changé entre les builds et lequel est recommandé en ce moment.

Si vous rétrogradez parce que quelque chose a cassé, le build que vous cherchez est en général le dernier qui fonctionnait. Votre console serveur affiche le numéro de build à chaque démarrage, et txAdmin le montre sur son tableau de bord, remontez donc l'historique de la console pour retrouver le numéro d'avant la panne.

Quelle version faire tourner ?

Recommended pour presque tous les serveurs. C'est la valeur par défaut pour une raison : c'est le build que l'équipe Cfx.re et l'écosystème de scripts ont tous deux eu le temps de tester.

Latest quand vous avez précisément besoin de quelque chose de neuf. Un nouveau native appelé par votre script, un correctif pour un bug qui vous pénalise maintenant, ou une sortie de framework qui exige un build serveur récent. Attendez-vous à quelques aspérités.

Un build plus ancien figé quand une mise à jour vous a cassé et que le serveur doit tourner ce soir. Traitez cela comme temporaire. Les vieux builds finissent par disparaître de la liste des artifacts, et rester loin derrière signifie se priver des correctifs de stabilité et de sécurité. Utilisez le figeage pour gagner du temps pendant que l'auteur de la ressource rattrape son retard, puis revenez sur Recommended.

Changer d'artifact supprime-t-il quelque chose ?

Non. L'étape d'installation remplace les fichiers FXServer et rien d'autre. Concrètement :

• server.cfg est conservé. L'installeur n'en écrit un nouveau que si le fichier manque totalement.
• Votre dossier resources/ est conservé, avec chaque script, véhicule et map que vous avez envoyé.
• Les bases de données ne sont pas touchées. Elles vivent hors des fichiers du serveur, une réinstallation ne les atteint pas.

Les sauvegardes sont incluses sur chaque serveur DoomHosting, donc avant de tester un build risqué, faites-en une depuis l'onglet Backups. Cela ne coûte rien et transforme un mauvais build en retour arrière de deux minutes.

Problèmes courants

Il a réinstallé Recommended au lieu de mon build. L'installeur cherche votre numéro dans la liste des artifacts, et quand il ne le trouve pas, il retombe sur Recommended et l'écrit dans le log d'installation. Deux causes : vous avez tapé un numéro partiel, ou le build a été retiré de la liste. Ouvrez la liste, copiez le numéro de build complet exactement tel qu'il apparaît avant le tiret, et réinstallez.

Rien n'a changé après avoir modifié le champ dans Démarrage. Vous n'avez pas réinstallé. Modifier le champ seul ne remplace jamais les binaires. Paramètres, Zone de danger, Réinstaller le serveur, case décochée.

Le serveur ne démarre plus après un changement de version. Lisez la sortie console. Sur un build plus récent, la cause habituelle est une ressource qui appelle quelque chose de supprimé, et son nom figure dans l'erreur. Sur un build plus ancien, c'est l'inverse : une ressource qui a besoin d'un native que votre build n'a pas encore. Dans les deux cas, la solution est de passer sur le build attendu par cette ressource, et c'est exactement à cela que sert le figeage.

Les resources se chargent mais les joueurs ne peuvent pas se connecter. Un changement de version en est rarement la cause. Vérifiez d'abord votre clé de licence et votre référencement, voir Serveur FiveM absent de la liste.

txAdmin annonce une version différente de celle réglée. txAdmin lit le build réellement en cours, faites-lui confiance. S'il contredit votre champ dans Démarrage, l'installation est retombée sur Recommended, voir le premier point ci-dessus.

Questions fréquentes

Rétrograder affecte-t-il mes joueurs ? Non. Les artifacts sont côté serveur. Les joueurs gardent le client FiveM qu'ils ont déjà.

Jusqu'où puis-je remonter ? Aussi loin que va la liste des artifacts, soit plusieurs centaines de builds aujourd'hui. Tout ce qui y figure encore est installable. Tout ce qui en a été retiré est perdu.

Est-ce que je perds ma configuration ESX ou QBCore ? Non. Les frameworks vivent dans resources/ et dans votre base de données, et une réinstallation conserve les deux. Si vous êtes encore en train d'en installer un, voir Installer ESX ou QBCore sur votre serveur FiveM.

À quelle fréquence mettre à jour ? Quand Cfx.re déplace le build Recommended et que rien ne s'y oppose. Jeter un oeil à l'onglet Version une fois par mois suffit largement à la plupart des serveurs.

Puis-je basculer entre les builds FiveM et RedM ici ? Non, c'est un réglage distinct. Le champ fivem version choisit uniquement le build FXServer que vous faites tourner.

Chaque serveur FiveM chez DoomHosting embarque ce sélecteur, les sauvegardes et l'accès complet aux fichiers, le tout dans le même panneau de contrôle. Si un changement de build vous bloque, ouvrez un ticket et nous vous remettrons sur un artifact fonctionnel.