Mettre à jour les artifacts FXServer de votre serveur FiveM

Que sont les artifacts FXServer ?

Mettre à jour les artifacts FiveM consiste à remplacer les fichiers exécutables qui font fonctionner FXServer par une version plus récente publiée par Cfx.re. Les artifacts constituent le cœur technique de votre serveur : ils lancent les ressources, exécutent les scripts et assurent les échanges avec les clients FiveM.

Ils contiennent notamment :

• les fichiers exécutables de FXServer ;
• les composants nécessaires à l’exécution des ressources ;
• les correctifs apportés par Cfx.re ;
• les évolutions du moteur serveur ;
• txAdmin, intégré aux versions modernes de FXServer.

Les artifacts sont identifiés par un numéro de build. Ce numéro permet de connaître précisément la version utilisée et de revenir à une version antérieure lorsqu’une mise à jour provoque une incompatibilité.

Ils sont distincts des fichiers de votre serveur RP :

FXServer / artifacts
├── binaires du serveur
├── bibliothèques
└── txAdmin

Données du serveur
├── server.cfg
├── resources/
├── cache/
└── txData/

Une mise à jour des artifacts ne correspond donc pas à une mise à jour d’ESX, de QBCore ou de vos scripts. Ces éléments possèdent leurs propres versions et doivent être contrôlés séparément.

Une version trop ancienne peut devenir incompatible avec les évolutions de FiveM ou ne plus être prise en charge. Ne laissez pas votre serveur fonctionner durablement sur un build obsolète.

Recommended ou Latest : quelle version choisir ?

Les panels d’hébergement et les pages de téléchargement peuvent proposer plusieurs canaux ou types de builds.

Version	Description	Utilisation conseillée
Recommended	Build recommandé par Cfx.re pour une utilisation courante	Serveur public ou environnement de production
Latest	Build le plus récent disponible	Tests, besoin technique précis ou correction récente
Numéro précis	Build sélectionné manuellement	Compatibilité particulière ou retour temporaire à une ancienne version

La version Recommended est généralement le meilleur choix pour un serveur communautaire accessible au public. Elle a été retenue comme version de référence et limite le risque d’adopter immédiatement une modification encore peu éprouvée avec votre ensemble de scripts.

La version Latest contient les changements les plus récents. Elle peut être nécessaire lorsqu’une ressource demande un build minimal ou lorsqu’un correctif important vient d’être publié. Elle peut toutefois révéler une incompatibilité avec un ancien script.

« Latest » ne signifie pas automatiquement « meilleure pour votre serveur ». La bonne version est celle qui reste compatible avec vos ressources tout en étant encore prise en charge.

Pour un serveur RP stable, utilisez en priorité le build recommandé. Testez les versions les plus récentes sur une instance séparée avant de les appliquer à votre serveur principal.

Avant de mettre à jour les artifacts FiveM

Une mise à jour reste une opération sensible, même lorsqu’elle ne modifie pas directement les ressources ou la base de données.

Commencez par noter le numéro du build actuellement utilisé. Il apparaît généralement dans la console de démarrage, les informations du serveur ou la section consacrée aux versions dans le panel.

Conservez une note comme celle-ci :

Date : 28 juillet 2026
Ancien artifact : build XXXXX
Nouveau canal prévu : Recommended
Framework : ESX Legacy
OneSync : activé

Vous disposerez ainsi d’un point de retour précis en cas de problème.

Arrêtez ensuite complètement le serveur. Évitez de remplacer les fichiers FXServer pendant que des joueurs sont connectés ou que des données sont encore en cours d’écriture.

Des sauvegardes automatiques sont incluses pour vous aider à restaurer. Conservez aussi vos propres exports réguliers : vous restez responsable de vos données.

Exportez au minimum :

server.cfg
resources/
txData/
base de données MySQL

Prévenez également votre communauté lorsqu’une coupure est prévue. Une annonce simple suffit :

Maintenance technique en cours : mise à jour du moteur FXServer.
Le serveur sera de nouveau accessible après les vérifications.

Si votre serveur accueille de nombreux joueurs, réalisez d’abord la mise à jour sur une copie de test utilisant les mêmes scripts et la même configuration.

Mettre à jour les artifacts FiveM depuis le panel TalCloud

Arrêtez votre serveur depuis le panel TalCloud, puis ouvrez la section consacrée à la version de FXServer, aux artifacts ou aux paramètres de démarrage. Le nom exact peut varier selon l’interface utilisée.

La procédure générale est la suivante :

1. arrêtez complètement le serveur ;
2. ouvrez les paramètres de version FXServer ;
3. sélectionnez le canal Recommended ou un numéro de build précis ;
4. lancez l’installation ou la mise à jour ;
5. attendez la confirmation de fin d’opération ;
6. redémarrez le serveur ;
7. ouvrez immédiatement la console.

Ne lancez pas plusieurs installations successives et ne redémarrez pas le serveur pendant le remplacement des fichiers.

Le panel met à jour les composants FXServer. Votre server.cfg, vos ressources et les données de votre framework doivent rester distincts, mais vos sauvegardes demeurent indispensables avant toute intervention.

Si vous administrez le serveur avec txAdmin, consultez aussi le guide pour démarrer avec txAdmin.

Ne supprimez pas txData/ pour mettre à jour les artifacts. Ce dossier contient notamment les profils et données de configuration utilisés par txAdmin.

Vérifier le serveur après la mise à jour

Gardez la console ouverte pendant tout le premier démarrage. Vérifiez que FXServer affiche le nouveau numéro de build et que txAdmin devient accessible.

Recherchez ensuite les erreurs suivantes :

SCRIPT ERROR

Couldn't start resource

No such export

Failed to load

CitizenFX fatal error

Une ligne d’avertissement isolée n’empêche pas toujours le serveur de fonctionner. Concentrez-vous sur la première erreur critique et sur les ressources qui refusent de démarrer.

Contrôlez ensuite :

• la connexion d’un joueur ;
• la création ou le chargement du personnage ;
• l’accès à la base MySQL ;
• l’inventaire ;
• les menus principaux ;
• les métiers ;
• les véhicules ;
• les scripts vocaux ;
• les systèmes utilisant OneSync.

OneSync assure la synchronisation d’un grand nombre d’entités et participe au fonctionnement des serveurs accueillant davantage de joueurs. Après la mise à jour, vérifiez que sa configuration n’a pas été désactivée et que les scripts dépendants continuent de fonctionner.

Effectuez un test complet :

1. Démarrer le serveur
2. Se connecter
3. Charger un personnage
4. Sortir un véhicule
5. Tester l'inventaire
6. Tester un métier
7. Se déconnecter
8. Redémarrer
9. Vérifier la persistance des données

Un serveur qui atteint l’état « démarré » dans txAdmin n’est pas nécessairement entièrement opérationnel. Les tests en jeu restent indispensables.

Quand faut-il mettre à jour FXServer ?

Il n’est pas nécessaire d’installer chaque nouveau build dès sa publication. Une fréquence excessive augmente le nombre d’interventions sans apporter systématiquement un bénéfice visible.

Mettez à jour lorsque :

• votre version n’est plus recommandée ou devient obsolète ;
• Cfx.re demande l’utilisation d’un build plus récent ;
• une ressource exige un numéro minimal d’artifact ;
• un correctif résout un problème que vous rencontrez ;
• une fonctionnalité récente de FXServer est nécessaire ;
• vous préparez une mise à jour importante de votre framework.

Pour un serveur public, une méthode prudente consiste à :

1. surveiller les versions recommandées ;
2. lire les prérequis de vos scripts principaux ;
3. tester le nouveau build sur une instance secondaire ;
4. planifier la maintenance ;
5. conserver l’ancien numéro pour un retour arrière.

Ne repoussez pas indéfiniment les mises à jour. Les artifacts trop anciens peuvent générer des avertissements de fin de support et finir par empêcher l’accès normal au serveur.

Dépanner une mise à jour des artifacts

Le serveur ne démarre plus

Consultez le début de la console et identifiez la première erreur. Vérifiez que le téléchargement des artifacts s’est terminé correctement et qu’aucun fichier essentiel n’est manquant.

Effectuez ensuite un retour vers l’ancien numéro de build depuis le panel, puis redémarrez.

Version avant mise à jour : build XXXXX
Version en erreur : build YYYYY
Action : retour temporaire au build XXXXX

Le retour arrière permet de rétablir le service pendant que vous recherchez la cause.

Un script est devenu incompatible

Mettez à jour la ressource concernée depuis sa source officielle. Vérifiez également ses dépendances, son fxmanifest.lua et la version minimale de FXServer demandée.

N’installez pas plusieurs correctifs simultanément. Modifiez une ressource, redémarrez et testez avant de poursuivre.

txAdmin ne s’ouvre plus

Vérifiez que FXServer démarre réellement et que le port de txAdmin n’a pas changé. Consultez la console principale avant de modifier vos profils.

Évitez de supprimer immédiatement txData/, car cette opération peut faire disparaître votre configuration txAdmin.

Le serveur démarre, mais les joueurs ne se connectent plus

Contrôlez :

• la clé de licence Cfx.re ;
• les ports TCP et UDP ;
• les erreurs de ressources ;
• la configuration OneSync ;
• la version minimale exigée par vos scripts ;
• les messages de la console au moment de la connexion.

Les causes les plus courantes après une mise à jour sont un artifact mal installé, un script ancien devenu incompatible ou une configuration qui n’est plus comprise de la même manière.

En résumé

• Les artifacts correspondent aux fichiers exécutables et au moteur FXServer.
• Notez toujours le numéro du build actuel avant une mise à jour.
• Choisissez en priorité la version Recommended pour un serveur public.
• Utilisez Latest lorsqu’un besoin précis le justifie et après des tests.
• Arrêtez complètement le serveur avant de remplacer les artifacts.
• Sauvegardez server.cfg, resources/, txData/ et la base MySQL.
• Effectuez la mise à jour depuis la section FXServer ou artifacts du panel TalCloud.
• Surveillez la console au premier redémarrage.
• Testez les personnages, l’inventaire, les véhicules, les métiers et OneSync.
• Conservez l’ancien numéro de build pour pouvoir revenir rapidement en arrière.
• Ne laissez pas votre serveur fonctionner durablement sur une version obsolète.
• Pour mettre à jour les artifacts FiveM depuis un panel de gestion avec stockage NVMe, Anti-DDoS L3/L4/L7 inclus et support francophone, consultez l’offre serveur FiveM TalCloud.