txAdmin et faux joueurs : guide d'intégration complet

txAdmin est la plateforme de gestion de serveurs FiveM la plus utilisée. Votre personnel et vos modérateurs l'utilisent pour surveiller les sessions des joueurs, vérifier les comptages de joueurs et gérer les connexions en temps réel. Sans intégration txAdmin, votre personnel verrait un décalage entre le comptage de joueurs affiché dans le navigateur de serveurs public et les sessions visibles dans le panneau txAdmin. Ce décalage est un signe révélateur évident. Connecter un service de faux joueurs FiveM à ce panneau permet de garder vos bots visibles comme partie de la population du serveur partout où votre personnel regarde.

Avec FiveFake, les faux joueurs apparaissent dans le panneau web txAdmin et dans la liste des joueurs en jeu, de façon identique à l'affichage des vrais joueurs. C'est tout l'objet de l'intégration txAdmin. Votre personnel voit une liste de joueurs cohérente et rien ne se démarque.

La configuration est simple. Accédez au tableau de bord FiveFake, naviguez vers la page de votre serveur et téléchargez l'artefact correspondant à la version de votre serveur FiveM. Déposez les fichiers résultants dans le dossier de ressources de votre serveur. Activez ensuite l'option d'intégration txAdmin. À partir de ce moment, les faux joueurs sont visibles dans votre panneau txAdmin exactement comme les vrais joueurs.

Ce dont vous avez besoin avant de commencer

1. Un serveur FiveM en cours d'exécution avec txAdmin installé et accessible via son panneau web
2. L'adresse IP publique de votre serveur et le port du serveur (par défaut 30120 sauf si vous l'avez changé)
3. Le port de votre panneau txAdmin (par défaut 40120)
4. Un compte FiveFake avec un abonnement actif d'au moins 15 joueurs
5. Un build d'artefact FiveM compatible : consultez le guide de compatibilité des artefacts pour les plages de builds supportées

Vous n'avez pas besoin de modifier votre server.cfg au-delà de ce qui est déjà requis pour faire fonctionner txAdmin. Les fichiers d'artefact vont dans votre dossier de ressources et le reste de l'intégration est géré depuis le tableau de bord FiveFake.

Activation de l'intégration txAdmin dans le tableau de bord

Dans le tableau de bord FiveFake, accédez à la configuration de votre serveur. Vous y entrez trois informations : l'IP de votre serveur, le port de votre serveur et un libellé d'affichage optionnel pour distinguer ce serveur des autres dans votre compte si vous gérez plusieurs serveurs. Activez ensuite l'option d'intégration txAdmin. Aucune liaison de compte, aucun échange de jeton et aucun flux OAuth n'est requis. La bascule suffit.

Après avoir saisi l'IP et le port, utilisez l'outil de test de connexion dans le tableau de bord avant d'enregistrer. L'outil de test envoie une requête de sondage au point de terminaison de connexion de votre serveur et vérifie s'il reçoit une réponse valide. Si le test échoue, les raisons les plus courantes sont :

• Votre pare-feu serveur bloque les connexions entrantes sur le port 30120 depuis des IP externes
• Votre serveur ne fonctionne pas au moment du test
• Vous avez saisi l'IP LAN au lieu de l'IP publique
• Votre hébergeur utilise un port non standard différent de 30120
• txAdmin fonctionne mais le processus serveur FiveM qu'il gère a planté ou n'a pas encore démarré

À quoi ressemblent les connexions de faux joueurs dans txAdmin

Une fois les connexions actives, ouvrez votre panneau txAdmin et accédez à la liste des joueurs. Vous verrez les sessions de faux joueurs listées aux côtés des éventuelles sessions de vrais joueurs. Chaque connexion affiche un nom de joueur, un identifiant de serveur et un compteur de durée de fonctionnement. Le compteur de durée de fonctionnement des faux joueurs s'incrémente normalement car les sessions sont maintenues en continu.

Noms de joueurs dans la liste de sessions

Les noms qui apparaissent dans txAdmin sont ceux que vous avez configurés dans le tableau de bord FiveFake. Si vous utilisez l'un de nos packs de noms régionaux, les noms refléteront ce pack. Si vous utilisez des noms personnalisés que vous avez téléchargés, ces noms apparaissent. Si vous n'avez pas encore configuré de noms, les connexions utilisent les noms par défaut de notre pack de base, qui sont des noms anglais génériques.

Nous recommandons de configurer les noms avant votre première activation. Voir 30 connexions nommées Player_1 à Player_30 dans votre panneau txAdmin est un signal visuel alarmant pour tout administrateur qui consulte la liste de sessions sans connaître le contexte.

Attribution des identifiants de serveur

Votre serveur FiveM attribue les identifiants de serveur de façon séquentielle au fur et à mesure que les connexions se joignent. Les faux joueurs reçoivent des identifiants de serveur dans le même pool que les vrais joueurs. Si vous avez déjà 5 vrais joueurs connectés lorsque 20 faux joueurs se joignent, les identifiants de serveur pour les faux joueurs seront 6 à 25 ou là où tombe le prochain identifiant disponible. C'est un comportement normal.

Vérification de la stabilité de la connexion

Après l'activation, attendez 90 secondes, puis vérifiez trois choses pour confirmer que l'intégration est saine :

1. Le comptage de joueurs dans le tableau de bord FiveFake correspond au nombre que vous avez configuré
2. La liste de joueurs txAdmin affiche le nombre correct de sessions actives
3. Le navigateur de serveurs CFX (servers.fivem.net) affiche le comptage de joueurs de votre serveur mis à jour pour inclure les nouvelles connexions

La mise à jour du navigateur de serveurs CFX peut prendre jusqu'à 5 minutes car il interroge selon son propre calendrier. Ne vous attendez pas à ce que le comptage du navigateur soit mis à jour au moment où vous activez. Le panneau txAdmin se met à jour en temps réel.

Si le comptage dans le tableau de bord FiveFake affiche le nombre correct mais que txAdmin en montre moins, votre serveur applique peut-être une limite de débit de connexion. Par défaut, txAdmin et FiveM n'imposent pas de limites de débit de connexion strictes pour de petits comptages, mais certains frameworks de serveur ou scripts personnalisés en ajoutent. Vérifiez dans la console de votre serveur s'il y a des messages de rejet de connexion.

Erreurs courantes et leur signification

Connexions n'apparaissant pas dans txAdmin

Si vous activez des faux joueurs mais ne voyez rien dans txAdmin après 2 minutes, la connexion échoue avant d'atteindre l'étape de session de joueur. Vérifiez dans la console de votre serveur s'il y a des entrées de rejet de connexion. La cause la plus courante est une ressource sur votre serveur qui bloque les connexions depuis des plages d'IP qu'elle ne reconnaît pas. Certaines ressources anti-cheat ou anti-exploit ont des listes d'autorisation d'IP. Notre infrastructure de connexion utilise une plage d'IP définie que vous pouvez mettre en liste d'autorisation dans ces ressources.

Connexions apparaissant puis se déconnectant

Si les connexions apparaissent dans txAdmin pendant quelques secondes puis disparaissent, une ressource sur votre serveur expulse les connexions après la jonction initiale. Les coupables les plus courants sont les scripts de validation de session qui vérifient une licence de jeu valide, les scripts qui vérifient les versions des logiciels client ou les gestionnaires de validation de connexion personnalisés. Identifiez quelle ressource déclenche l'événement d'expulsion en vérifiant le journal d'expulsions txAdmin pour l'identifiant de joueur et la raison d'expulsion.

Comptage de joueurs visible dans le tableau de bord mais pas dans le navigateur

C'est presque toujours un problème de timing. Le navigateur de serveurs CFX ne se met pas à jour en temps réel. Attendez 5 à 10 minutes après l'activation avant de vérifier le comptage du navigateur. Si le comptage ne se met toujours pas à jour après 15 minutes, vérifiez que votre serveur est bien listé dans le navigateur en le cherchant directement. Certains serveurs sont non listés par choix ou mauvaise configuration, auquel cas les faux joueurs n'apparaîtront pas dans les résultats publics du navigateur même s'ils sont connectés.

Versions d'artefacts et compatibilité

Les artefacts FiveM sont les builds versionnés du binaire serveur FiveM. La compatibilité entre les services de faux joueurs et les artefacts FiveM n'est pas garantie sur tous les numéros de build. Lorsque FiveM met à jour son protocole de négociation de connexion, les services de faux joueurs qui n'ont pas mis à jour leur logique de connexion échoueront à établir des sessions.

Nous testons les nouvelles versions d'artefacts avant qu'elles deviennent stables dans le sélecteur d'artefacts txAdmin. Lorsqu'un nouveau build casse la compatibilité, nous publions un correctif dans les 24 heures. Si vous êtes sur un build qui n'est pas dans notre plage testée, le tableau de bord affichera un avertissement de compatibilité avant que vous tentiez d'activer. Ne contournez pas cet avertissement sans en lire les détails.

Gestion de plusieurs serveurs dans un seul compte

Si vous exploitez plusieurs serveurs FiveM, vous pouvez tous les gérer depuis un seul compte FiveFake. Chaque serveur obtient sa propre entrée de configuration avec des comptages de joueurs, des plannings et des packs de noms indépendants. La facturation est par joueur sur tous les serveurs actifs, donc votre coût quotidien total est la somme de tous les comptages de joueurs configurés.

Le tableau de bord affiche le statut actif de chaque serveur, le comptage actuel de joueurs et l'état de santé des connexions de façon indépendante. Si un serveur a un problème de configuration, cela n'affecte pas les autres. Vous pouvez mettre en pause les faux joueurs d'un serveur tout en maintenant un autre actif.

Prochaines étapes

Une fois vos connexions stables dans txAdmin, l'étape suivante est de configurer un planning qui reflète le comportement réel des joueurs pour votre région. Un comptage de joueurs fixe sur 24 heures est l'erreur la plus courante après la configuration initiale.