Artefacts serveur FiveM obsolètes : comment mettre à jour FXServer en toute sécurité

txAdmin affiche un avertissement que vos artefacts serveur sont obsolètes, ou une ressource demande une version plus récente que celle que vous exécutez. La correction est de remplacer le programme FXServer par une version actuelle. Cela prend cinq minutes si vous gardez vos données séparées, et c'est comment le faire.

#Ce que sont les artefacts

Les « artefacts » sont les binaires FXServer : le programme qui exécute votre serveur. Ce ne sont pas vos ressources et ne sont pas votre configuration. Une disposition typique ressemble à ceci :

FXServer/
  server/          <- artifacts (FXServer.exe or run.sh and its files)
  server-data/     <- your server.cfg and resources
  txData/          <- txAdmin data and profiles

La mise à jour signifie remplacer ce qui se trouve dans le dossier des artefacts. Vous ne touchez pas aux deux autres. Si vos dossiers sont mélangés, découvrez ce qu'est quoi avant de remplacer quoi que ce soit : le dossier des artefacts est celui qui contient FXServer.exe sous Windows ou run.sh sous Linux.

#Recommandé ou dernier

Les pages de téléchargement marquent deux builds près du haut :

• Recommandé : la version que Cfx.re considère comme stable. Choisissez cela pour un serveur en direct.
• Dernier : la version la plus récente. Il a les corrections et fonctionnalités les plus récentes, et une chance plus élevée de nouveaux bugs.

Si txAdmin vous dit qu'une version spécifique est nécessaire et que la version recommandée est plus ancienne, prenez une version plus récente de la liste. Ne sautez pas à la plus récente juste parce qu'elle est la plus récente.

#Où télécharger

Les builds sont hébergées par Cfx.re sur runtime.fivem.net :

• Windows : https://runtime.fivem.net/artifacts/fivem/build_server_windows/master/
• Linux : https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/

Téléchargez uniquement à partir de ces pages. Ne prenez pas les builds serveur d'un message de forum, d'un fichier Discord ou d'un site tiers.

Sous Windows, vous obtenez une archive server.7z, que vous ouvrez avec 7-Zip. Sous Linux, vous obtenez une archive fx.tar.xz.

#Sauvegardez d'abord

Avant de remplacer quoi que ce soit, copiez :

1. Le dossier des artefacts actuel (le dossier entier server).
2. Votre dossier server-data, ou au moins server.cfg et resources.
3. Le dossier txData.
4. Une sauvegarde de votre base de données, si vous en avez une. Utilisez votre outil habituel, ou mysqldump sur la machine.

Si la nouvelle version se comporte mal, vous pouvez remettre l'ancien dossier en place et recommencer en une minute.

Attention : arrêtez complètement le serveur et txAdmin avant de remplacer les fichiers. Écraser FXServer pendant qu'il s'exécute échoue sous Windows, et sous Linux, cela laisse un mélange cassé de fichiers anciens et nouveaux.

#Mise à jour sous Windows

1. Arrêtez le serveur et fermez txAdmin.
2. Téléchargez le server.7z de la version que vous voulez.
3. Renommez l'ancien dossier des artefacts, par exemple en server_old.
4. Créez un nouveau dossier server et extrayez l'archive dedans.
5. Démarrez FXServer.exe de la même façon que vous l'avez fait avant, au même endroit et avec le même raccourci ou les mêmes arguments.

txAdmin trouve sa txData par le chemin que vous lui avez donné, et vous ne l'avez pas changé, donc votre profil, paramètres et administrateurs sont toujours là.

#Mise à jour sous Linux

sudo systemctl stop fivem        # or stop the screen session

cd ~/fivem
mv server server_old
mkdir server && cd server

wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/<build>/fx.tar.xz
tar xf fx.tar.xz
rm fx.tar.xz

Remplacez <build> par le nom de dossier que vous copiez depuis la page de téléchargement. Redémarrez le serveur avec votre commande ou service habituel. Si vous n'avez pas encore configuré cela, voir running a FiveM server on Linux.

#Vérifiez que ça a fonctionné

Au démarrage, la console imprime la version de FXServer. Comparez-la avec le numéro de build sur la page de téléchargement. txAdmin affiche aussi la version sur son tableau de bord, et l'avertissement obsolète devrait disparaître.

Si quelque chose casse après la mise à jour :

• Les ressources ne démarrent pas : lisez la première erreur dans la console. Une ressource qui dépendait d'un ancien comportement peut avoir besoin d'une mise à jour. Voir couldn't start resource.
• Le serveur ne démarre pas du tout : remettez l'ancien dossier server_old en place, démarrez-le, et signalez le numéro de build qui a échoué.
• Un nouvel avertissement sur la version du jeu : c'est un paramètre différent, voir sv_enforceGameBuild and DLC.

#À quelle fréquence mettre à jour

Vous n'avez pas besoin de chasser chaque version. Une règle raisonnable : mettez à jour quand txAdmin vous avertit, quand une ressource a besoin d'une version plus récente, ou quand vous frappez un bug qu'une version ultérieure corrige. Testez toujours une mise à jour sur une copie du serveur d'abord si vous exécutez des serveurs payants ou occupés, et faites-le quand peu de gens sont en ligne.

#Liste de contrôle