Artefacts FXServer : versions, canaux et mises à jour

L'essentiel

Un artefact est le binaire du serveur FiveM, publié par Cfx.re. Sa version détermine les natives disponibles, donc ce que vos ressources peuvent faire. Monter d'artefact peut casser une ressource ancienne ; rester trop bas peut empêcher une ressource récente de démarrer.

Ce qu'est un artefact

FXServer est le serveur FiveM lui-même, et Cfx.re en publie des versions compilées en continu : ce sont les artefacts. Chacun porte un numéro de build.

Cette version n'est pas un détail d'administration : elle fixe l'ensemble des natives — les fonctions que le moteur expose aux scripts. Une ressource qui appelle une native apparue dans un build récent échouera sur un artefact plus ancien.

Les canaux, et lequel suivre

Cfx.re étiquette ses artefacts selon leur maturité : le plus récent, celui qui est recommandé, et des versions marquées comme optionnelles ou critiques.

Pour un serveur en production, la version recommandée est le bon défaut. Le dernier artefact disponible n'a d'intérêt que si une ressource exige explicitement une native récente. Une version marquée critique, elle, se prend sans attendre : c'est l'étiquette que Cfx.re réserve aux correctifs qu'il ne faut pas laisser passer.

Pourquoi une montée de version casse parfois tout

Le sens de l'erreur n'est pas symétrique, et c'est ce qui rend le sujet piégeux. Monter d'artefact peut casser une ressource ancienne qui s'appuyait sur un comportement modifié ou retiré. Descendre peut empêcher une ressource récente de démarrer, parce que la native qu'elle appelle n'existe pas encore.

Conséquence : un artefact ne se change pas « pour être à jour ». Il se change pour une raison — un correctif critique, ou une ressource qui le réclame — et toujours avec une sauvegarde et une lecture des logs de démarrage juste après.

Legacy et Enhanced ont leurs propres artefacts

Les deux builds sont distribués séparément. Un artefact Legacy ne sert pas un serveur Enhanced, et réciproquement : la bascule d'un build à l'autre implique l'autre lignée d'artefacts.

C'est une raison supplémentaire de traiter la bascule de build comme une opération à part entière, et pas comme un réglage. Le détail est dans notre page Legacy ou Enhanced.

Questions fréquentes

Quel artefact choisir pour un serveur en production ?
La version recommandée par Cfx.re, sauf si une ressource exige explicitement un build plus récent. Les versions marquées critiques se prennent sans attendre.
Mon serveur ne démarre plus après une mise à jour d'artefact.
Lisez les logs de démarrage : ils nomment la ressource qui échoue. Revenir à l'artefact précédent est la façon la plus rapide de rétablir le service, le diagnostic peut attendre.
Faut-il mettre à jour régulièrement ?
Non, pas par principe. Un artefact se change pour une raison : un correctif critique, ou une ressource qui réclame une native récente. Changer sans raison, c'est prendre un risque sans gain.
Les artefacts Enhanced sont-ils les mêmes que les Legacy ?
Non, les deux lignées sont distinctes. Changer de build, c'est changer de lignée d'artefacts.

À lire aussi

Toute la documentation FiveM

Lancer un serveur FiveM

txAdmin préinstallé, clé Argentum incluse, builds Legacy et Enhanced au choix. Dès 2,99€/mois, livré immédiatement.

Configurer mon serveur