Prendre en main txAdmin

txAdmin est l’interface web d’administration de FiveM, incluse avec les offres FiveM et RedM de CloudFive. Cette page s’adresse à vous si vous venez d’installer un serveur et cherchez où gérer vos joueurs, vos administrateurs et vos redémarrages.

Retenez la répartition des rôles, elle évite beaucoup de confusion :

Outil	Ce qu’il pilote
Le panel CloudFive	La machine : allumer, éteindre, les fichiers, les bases, les sauvegardes, les ports
txAdmin	Le jeu : les joueurs, les administrateurs, les sanctions, les redémarrages planifiés, le déploiement

Attention

Les deux outils agissent sur le même serveur à deux niveaux différents. Si vous arrêtez le serveur depuis le panel, txAdmin s’arrête avec lui. Ne lancez pas une opération dans l’un pendant que l’autre redémarre : laissez la première se terminer. Voir Démarrer, arrêter et redémarrer son serveur.

Accéder à l’interface txAdmin

txAdmin est une interface web servie par votre serveur, sur un port distinct de celui du jeu. Ce port fait partie des allocations de votre serveur dans le panel.

1. Démarrez votre serveur depuis le panel et ouvrez la console.

2. Relevez dans les premières lignes l’adresse d’accès à txAdmin que la console affiche au démarrage : une adresse IP suivie du port de l’interface. Si vous ne la voyez pas, retrouvez le port dans les allocations de votre serveur.

3. Ouvrez cette adresse dans votre navigateur.

4. Au tout premier accès, txAdmin demande un code à usage unique affiché dans la console du serveur. Recopiez-le pour prouver que vous êtes bien l’administrateur de la machine.

5. Créez votre compte maître : identifiant et mot de passe. C’est le compte propriétaire de l’installation, celui qui pourra en créer d’autres.

6. Enregistrez l’adresse en favori.

Le code n’apparaît qu’au démarrage

Si vous avez laissé passer le code à usage unique, redémarrez simplement le serveur : la console l’affiche de nouveau. Il expire au bout de quelques minutes et devient inutile dès que le compte maître existe.

Danger

Le compte maître donne la main sur le serveur de jeu entier. Mettez-y un mot de passe long et unique, et activez la double authentification si l’interface vous le propose. Ne réutilisez jamais le mot de passe de votre espace client.

Déployer un serveur via une recipe

Une recipe est un scénario d’installation automatique : txAdmin télécharge un framework complet, ses ressources, crée les tables dans la base de données et écrit un server.cfg cohérent. C’est de loin le moyen le plus rapide d’obtenir un serveur RP jouable.

Préparez d’abord une base de données MySQL et gardez ses identifiants sous la main : Créer et gérer une base de données.

1. Dans txAdmin, lancez l’assistant de déploiement d’un nouveau serveur.

2. Choisissez une recipe dans la liste proposée — ESX et QBCore y figurent — ou indiquez l’adresse d’une recipe que vous fournissez vous-même.

3. Renseignez les identifiants de la base de données : hôte, port, utilisateur, mot de passe. Reprenez-les tels quels depuis le panel.

4. Laissez le déploiement se dérouler sans fermer l’onglet : il télécharge, extrait et remplit la base. Comptez plusieurs minutes.

5. Relisez le server.cfg généré et complétez-le avec votre clé serveur Cfx.re si elle n’y est pas.

6. Démarrez le serveur et connectez-vous en jeu pour valider.

Danger

Un déploiement écrase le contenu du dossier de données du serveur et vide les tables de la base indiquée. Sur un serveur qui tourne déjà, avec des joueurs et des personnages, c’est une perte définitive. Créez une sauvegarde et exportez votre base avant de lancer un déploiement, jamais après.

Pour ajouter ensuite vos propres scripts par-dessus la base déployée : Ajouter des ressources et des scripts.

Créer et gérer les comptes administrateurs

Un compte txAdmin par personne : c’est la seule façon de savoir qui a banni qui.

1. Ouvrez la section de txAdmin qui gère les administrateurs.

2. Créez un compte, avec un identifiant au nom de la personne.

3. Attribuez des permissions au plus juste : un modérateur a besoin de voir les joueurs et de sanctionner, pas de redéployer le serveur ni de modifier les réglages.

4. Associez son identité de jeu à son compte, pour que ses commandes en jeu soient reconnues.

5. Transmettez-lui son mot de passe initial et demandez-lui de le changer.

Trois principes qui tiennent dans le temps :

• Ne partagez jamais le compte maître. Si deux personnes l’utilisent, l’historique des actions ne vaut plus rien. Et retirez les accès le jour du départ, pas la semaine suivante.
• Séparez les droits du jeu et ceux de la machine. Un modérateur n’a pas besoin du panel. S’il lui faut un accès aux fichiers, créez-lui un sous-utilisateur avec des droits limités.
• Les droits en jeu se déclarent dans le server.cfg (add_principal, add_ace) : txAdmin gère l’interface web, le server.cfg gère les commandes en jeu.

Sanctions : avertissements, kicks et bans

txAdmin tient une fiche par joueur : ses identifiants, ses connexions passées, ses sanctions. C’est là que se passe la modération.

Sanction	Effet	Quand l’utiliser
Avertissement	Message affiché au joueur, trace conservée	Premier écart, règle mal comprise
Kick	Déconnexion immédiate, retour possible aussitôt	Couper court à une situation en cours
Ban temporaire	Connexion refusée pendant une durée choisie	Récidive, infraction sérieuse
Ban définitif	Connexion refusée sans limite de durée	Triche, propos haineux, nuisance répétée

1. Ouvrez la liste des joueurs et retrouvez le joueur, connecté ou non, par son nom ou son identifiant.

2. Ouvrez sa fiche et lisez son historique.

3. Choisissez la sanction, et saisissez une raison explicite. Vous la relirez dans six mois, en pleine contestation.

4. Pour un ban, choisissez la durée. Dans le doute, préférez une durée longue à un ban définitif.

5. Vérifiez que la sanction apparaît bien dans l’historique.

Note

Un ban porte sur les identifiants d’un joueur, pas sur une personne : un joueur déterminé revient avec un autre compte. Pour un serveur sensible, la vraie réponse est une whitelist — txAdmin propose plusieurs modes d’admission, qui filtrent les arrivées au lieu de les sanctionner après coup.

Attention

Ne vous bannissez pas vous-même et ne bannissez pas un administrateur « pour tester ». La levée passe par txAdmin : si vous perdez l’accès à l’interface au même moment, la situation devient pénible à démêler.

Surveiller les performances et les redémarrages

txAdmin montre en continu la santé du serveur : temps de calcul par tick, nombre de joueurs, consommation mémoire.

• Le temps par tick est l’indicateur à regarder. Quand il monte, le serveur a plus de travail qu’il ne peut en faire dans le temps imparti, et les joueurs ressentent du retard. Pour chercher la cause : Optimiser les performances.
• Les journaux conservent les actions des administrateurs, les arrêts et les redémarrages. C’est la première chose à consulter après un incident.

txAdmin permet aussi de programmer des redémarrages, avec un avertissement aux joueurs avant la coupure.

1. Ouvrez les réglages de txAdmin, à la section des redémarrages planifiés.

2. Ajoutez un ou deux horaires creux — la nuit, tôt le matin. Un serveur FiveM supporte mal de tourner des jours entiers sans repartir.

3. Vérifiez que les messages d’avertissement sont actifs, pour que personne ne soit coupé en pleine action.

4. Enregistrez, puis contrôlez le lendemain que le redémarrage a bien eu lieu dans les journaux.

Un seul planificateur

Le panel dispose aussi d’un planificateur de tâches. Programmez vos redémarrages dans txAdmin ou dans le panel, pas dans les deux : deux redémarrages qui se chevauchent peuvent corrompre une écriture en cours.

Si ça ne marche pas

L’interface txAdmin ne s’ouvre pas. Vérifiez d’abord que le serveur est démarré : txAdmin ne tourne que lorsque le serveur tourne. Vérifiez ensuite que vous utilisez le port de l’interface et non celui du jeu — voir Ports et allocations.

Le code à usage unique est refusé. Il a expiré. Redémarrez le serveur pour en obtenir un nouveau, et utilisez-le dans la minute.

Vous avez perdu le mot de passe du compte maître. Il ne se récupère pas depuis l’interface. Ouvrez un ticket de support en précisant le service concerné : la réinitialisation se fait sur les fichiers du serveur.

Le déploiement par recipe s’arrête en cours de route. C’est presque toujours la base de données : identifiants erronés, ou aucune base créée. Reprenez Créer et gérer une base de données.

Le serveur redémarre en boucle depuis txAdmin. Arrêtez-le depuis le panel pour casser la boucle, puis lisez la console : une ressource en erreur fait échouer le démarrage, et txAdmin réessaie. Voir Console et logs.

Si rien ne débloque la situation, le support est joignable 7 j/7 : Contacter le support.