FiveM Artifacts et faux joueurs : Guide de compatibilité

Les artifacts FiveM sont des builds de serveur versionnés qui incluent le runtime du serveur de jeu, le chargeur de ressources, et le code de gestion des connexions. Chaque fois que Rockstar pousse une mise à jour GTA ou que l'équipe FiveM déploie des changements de plateforme, le numéro de build d'artifact s'incrémente. La compatibilité des faux joueurs est liée à l'artifact car le comportement de la poignée de main que votre serveur attend change avec chaque génération de build. Garder votre build dans une plage testée est ce qui aide notre service de faux joueurs FiveM — les bots qui remplissent la population de votre serveur — à se connecter de façon fiable.

Cet article explique ce que sont les artifacts, quelles plages de build sont stables pour les connexions de faux joueurs, comment vérifier votre build actuel, comment épingler votre serveur à une version testée, et que faire lorsqu'une mise à jour de jeu change la poignée de main. Pour le contexte plus large, le guide complet des faux joueurs FiveM explique comment l'ensemble du système s'articule.

Ce que sont les artifacts FiveM et pourquoi ils sont importants

Lorsque vous installez un serveur FiveM, vous téléchargez un artifact de serveur : un binaire compilé qui inclut l'exécutable du serveur FiveM (FXServer), le runtime Lua, le système de ressources, et la couche réseau qui gère les connexions des clients. Le numéro de version de l'artifact identifie quel build de tout ce code vous utilisez.

Les builds d'artifact sont publiés sur une base continue. L'équipe FiveM maintient trois canaux de publication : recommended, optional, et latest. Les builds recommended sont les plus stables. Les builds optional incluent des fonctionnalités plus récentes qui ont passé les tests internes mais pas les tests complets des opérateurs. Les builds latest sont à la pointe et incluent des changements qui peuvent ne pas être stables.

La raison pour laquelle les artifacts sont importants pour la compatibilité des faux joueurs est que la poignée de main de connexion est implémentée dans l'artifact. Lorsque l'artifact change la façon dont il valide les connexions entrantes, notre couche de connexion de faux joueurs doit être mise à jour pour correspondre. Si vous mettez à jour votre artifact avant que nous mettions à jour notre couche de connexion, les poignées de main des faux joueurs échouent.

Comment vérifier votre build d'artifact actuel

Il y a trois façons de trouver votre numéro de build d'artifact actuel.

1. Tableau de bord txAdmin : Le numéro de build apparaît en bas à gauche de la page de vue d'ensemble txAdmin sous les informations du serveur.
2. Console du serveur : Exécutez la commande convar_print sv_fxdk_build dans la console du serveur. La sortie inclut le numéro de build d'artifact.
3. Exécutable FXServer : Sur Linux, exécutez ./FXServer --version depuis votre répertoire de serveur. La sortie inclut le numéro de build.

Une fois que vous avez votre numéro de build depuis le tableau de bord txAdmin ou la console du serveur, vérifiez-le par rapport au tableau de compatibilité dans votre tableau de bord FiveFake. Le tableau montre les numéros de build minimum et maximum dans chaque plage testée, le statut (entièrement compatible, compatibilité limitée, ou incompatible), et la date à laquelle chaque plage a été testée pour la dernière fois.

Plages de build stables pour les connexions de faux joueurs

Nous maintenons un tableau de compatibilité en direct dans le tableau de bord car les plages de build changent à mesure que de nouveaux artifacts sont publiés et testés. Le modèle général à travers les générations de build est :

• Builds dans le canal recommended actuel : entièrement testés, la couche de connexion est calibrée pour cette plage.
• Builds de 100 à 200 versions derrière le recommended actuel : généralement compatibles car les paramètres de poignée de main changent rarement dans une version majeure du jeu.
• Builds de plus de 300 versions derrière le recommended actuel : peuvent avoir des lacunes de compatibilité selon ce qui a changé dans les builds intermédiaires.
• Builds sur le canal latest de plus de 50 builds en avance sur le recommended : non testés, le comportement de connexion peut avoir changé avant que nous ayons eu le temps de mettre à jour.

Comment épingler votre version d'artifact

Épingler votre artifact à un numéro de build spécifique empêche les mises à niveau accidentelles qui cassent la compatibilité des faux joueurs. L'approche varie selon la façon dont votre serveur est hébergé.

Épinglage via txAdmin

txAdmin a une fonctionnalité intégrée de gestion des artifacts. Dans la section paramètres du serveur, vous pouvez définir la version de l'artifact à un numéro de build spécifique. txAdmin ne mettra pas à jour automatiquement l'artifact au-delà de ce build. Lorsque vous voulez mettre à jour, vous changez manuellement la version épinglée et appliquez le changement.

Épinglage via gestion directe des fichiers

Si vous gérez votre serveur sans txAdmin ou avec une configuration personnalisée, l'épinglage se fait en téléchargeant le build d'artifact spécifique directement depuis la page des artifacts FiveM et en le plaçant dans votre répertoire de serveur. N'exécutez pas de scripts de mise à jour automatique qui récupèrent le dernier artifact au démarrage.

La page de téléchargement des artifacts FiveM sur runtime.fivem.net/artifacts/fivem/ liste tous les builds disponibles pour Windows et Linux. Vous pouvez télécharger n'importe quel build historique par son numéro de build. Sauvegardez le numéro de build de votre configuration stable actuelle pour pouvoir y revenir si une mise à jour cause des problèmes.

Ce qui se passe quand une mise à jour de jeu casse la compatibilité

Quand une mise à jour GTA majeure est publiée, elle change généralement la version du jeu côté client que les clients FiveM doivent correspondre pour se connecter aux serveurs. Cela se propage à l'artifact du serveur sous forme d'un nouveau build qui inclut une validation de connexion mise à jour pour la nouvelle version du jeu. Si notre couche de connexion n'a pas été mise à jour pour la nouvelle version du jeu, les poignées de main des faux joueurs échouent parce que la version du client que nos connexions rapportent n'est plus acceptée.

Notre processus de mise à jour après un changement de version de jeu :

1. Nous détectons la nouvelle version du jeu depuis les canaux de publication publics FiveM dans les heures suivant la publication de la mise à jour.
2. Notre équipe valide quels builds d'artifact sont affectés et quels sont les changements de paramètres de poignée de main.
3. Nous mettons à jour notre couche de connexion pour gérer les nouveaux paramètres de version.
4. Nous testons contre des serveurs exécutant le nouveau build d'artifact recommended.
5. Nous déployons la couche de connexion mise à jour sur nos nœuds de production.
6. Nous annonçons la mise à jour dans le Discord et sur la page de statut du tableau de bord.

Ce processus prend généralement 24 à 48 heures depuis la publication de la mise à jour du jeu jusqu'à ce que notre mise à jour de la couche de connexion soit en production. Pendant cette fenêtre, les connexions de faux joueurs sur des serveurs qui ont mis à jour leur artifact pour correspondre à la nouvelle version du jeu peuvent échouer ou avoir une fiabilité réduite.

Gérer les mises à jour d'artifact sans perturber vos faux joueurs

L'approche la plus sûre pour les mises à jour d'artifact lorsque vous utilisez des faux joueurs est un processus en trois étapes :

1. Attendez que l'équipe FiveM désigne un build comme recommended après une mise à jour de jeu.
2. Vérifiez le tableau de compatibilité du tableau de bord FiveFake pour confirmer que le build recommended est dans notre plage testée.
3. Seulement alors mettez à jour votre artifact et reconfigurez vos faux joueurs si nécessaire.

Si vous devez mettre à jour votre artifact immédiatement pour d'autres raisons (un bug critique de serveur, un problème de compatibilité de ressource), mettez en pause votre planification de faux joueurs avant la mise à jour. Après la mise à jour, vérifiez que vos faux joueurs se reconnectent avant de reprendre la planification.

Interaction entre antidétection et version d'artifact

La compatibilité de la version d'artifact est directement liée à l'efficacité de l'antidétection. Les paramètres de connexion qui rendent nos faux joueurs légitimes aux systèmes d'anticheat sont calibrés pour des builds d'artifact spécifiques. Utiliser notre couche de connexion contre une version d'artifact en dehors de notre plage testée ne risque pas seulement des échecs de connexion. Cela risque aussi des connexions qui se comportent assez correctement pour se connecter mais assez incorrectement pour être signalées lors de la validation anticheat.

C'est l'argument le plus fort pour rester dans notre plage d'artifact compatible documentée : il ne s'agit pas seulement de savoir si vos joueurs se connectent, mais s'ils se connectent d'une manière qui passe les vérifications que votre système anticheat exécute.

Considérations pour les artifacts Windows versus Linux

Les artifacts FiveM sont disponibles pour Windows et Linux. La plupart des hébergeurs qui proposent des plans de serveur FiveM utilisent Linux. Les numéros de build d'artifact sont les mêmes sur les deux plateformes, mais il y a parfois des bugs spécifiques à la plateforme où un build se comporte différemment sur Windows versus Linux. Nos tests de compatibilité couvrent les deux plateformes, et le tableau de compatibilité du tableau de bord note les problèmes spécifiques à la plateforme lorsqu'ils existent.

Les connexions de faux joueurs FiveFake sont agnostiques à la plateforme de notre côté car ce sont des connexions réseau à votre endpoint de serveur, pas des intégrations avec le système d'exploitation de votre serveur. Ce qui compte, c'est le numéro de build d'artifact et le comportement de la poignée de main, pas si votre hébergeur utilise Windows ou Linux.

Comment signaler un problème de compatibilité

Si vous utilisez une version d'artifact que notre tableau de bord indique comme compatible mais que vos faux joueurs ne se connectent pas, les informations les plus utiles que vous pouvez fournir lors de l'ouverture d'un ticket de support sont :

1. Votre numéro de build d'artifact (vérifiez la vue d'ensemble txAdmin ou la console du serveur).
2. Le message d'erreur ou la raison d'expulsion affichée dans votre console txAdmin pour les connexions échouées.
3. Si le problème a commencé après une mise à jour d'artifact spécifique ou était présent dès votre première activation.
4. Quels systèmes anticheat fonctionnent sur votre serveur et leurs numéros de version si disponibles.
5. Si le problème affecte tous les faux joueurs ou seulement certains (les échecs de connexion partiels indiquent des limites de slots, les échecs complets indiquent des problèmes de poignée de main).

Les problèmes de compatibilité signalés avec ces informations sont généralement résolus dans les 24 heures car ces informations diagnostiques nous permettent de reproduire immédiatement le problème sur notre infrastructure de test. Quand le problème s'avère être une activation lente plutôt qu'un échec de compatibilité, le guide de la vitesse d'activation détaille les causes courantes.

Prochaines étapes

Si vous configurez un nouveau serveur et souhaitez vous assurer que votre configuration txAdmin est correcte avant d'activer les faux joueurs, le

couvre le processus de configuration complet de connexion incluant la sélection d'artifact et la configuration du panneau txAdmin.

Une fois que vous connaissez la version d'artifact que votre serveur utilise et que vous avez confirmé la compatibilité, les fichiers FiveFake dont vous avez besoin se trouvent sur la page de votre serveur dans le tableau de bord FiveFake. Chaque page de serveur dispose d'un bouton de téléchargement. Cliquez dessus, sélectionnez la version d'artifact correspondant à votre build de serveur FiveM, et déposez les fichiers résultants dans votre dossier de ressources.