Comment utiliser la console txAdmin pour gérer son serveur FiveM ?
Par Benjamin D. · PDG
· Lecture 10 min
Sommaire
La console txAdmin FiveM est l'interface web livrée avec FXServer qui permet de piloter une instance sans toucher au terminal : démarrage, arrêt, redémarrages programmés, modération des joueurs, lecture des journaux et suivi des temps de tick. Elle tourne sur le port 40120 et s'ouvre dans un navigateur, avec un compte administrateur et des permissions par rôle. Voici comment l'utiliser au quotidien.
À quoi sert txAdmin dans l'administration quotidienne
txAdmin s'intercale entre toi et le processus FXServer. Il le lance, le surveille, le relance s'il crashe, et expose une interface web pour tout le reste. Sans lui, chaque action passerait par une session SSH ou un screen persistant, avec le risque de tuer le processus par erreur.
Concrètement, l'outil regroupe cinq briques : une console live bidirectionnelle, un gestionnaire de joueurs avec historique de sanctions, un planificateur de redémarrages, des graphiques de performance du thread principal, et un éditeur du server.cfg. Le tout est accessible depuis un compte Cfx.re ou un compte local.
Si tu déploies ton projet roleplay sur une machine gérée, la brique txAdmin cohabite très bien avec un panel maison : le panel gère la machine et les sauvegardes, txAdmin gère le jeu. Sur une infrastructure d'hébergement FiveM, les deux consoles restent complémentaires plutôt que redondantes.
Ce que txAdmin ne fait pas
Il ne sauvegarde pas ta base MySQL, ne met pas à jour tes ressources, et ne remplace pas un accès fichier. Les scripts ESX, QBCore ou qbx_core se mettent à jour à la main ou via Git. txAdmin déclenche juste le ensure ou le restart une fois les fichiers en place.
Accéder à la console txAdmin FiveM et verrouiller les accès
Au tout premier démarrage, FXServer affiche dans sa sortie standard une URL locale et un code PIN à quatre chiffres. Ce PIN sert une seule fois, le temps de créer le compte maître. Passé ce délai, il faut relancer le processus pour en générer un nouveau.
cd /home/fivem/server
bash run.sh +set serverProfile default +set txAdminPort 40120Sur une machine Linux, tu accèdes ensuite à l'interface via http://IP_DE_LA_MACHINE:40120/. Si le port ne répond pas, vérifie le pare-feu avant de chercher ailleurs.
sudo ufw allow from TON_IP to any port 40120 proto tcp
sudo ufw status numberedRestreindre l'exposition du port 40120
Laisser 40120 ouvert au monde entier est la première erreur classique. Deux approches propres : limiter la règle pare-feu à ton IP fixe, ou placer l'interface derrière un reverse proxy Nginx avec un certificat TLS et une authentification supplémentaire. La seconde option évite aussi les alertes de navigateur sur le HTTP en clair.
server {
listen 443 ssl;
server_name panel.mondomaine.fr;
location / {
proxy_pass http://127.0.0.1:40120;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}Rôles et permissions des administrateurs
Le menu Admin Manager permet de créer des comptes secondaires liés à un identifiant Cfx.re ou à un Discord. Chaque compte reçoit un jeu de permissions granulaires. Donne le strict nécessaire : un modérateur n'a pas besoin d'écrire dans la console ni d'éditer la configuration.
| Permission | Ce qu'elle autorise | À qui la donner |
|---|---|---|
players.ban | Bannir et lever un bannissement | Staff de modération |
players.kick | Expulser un joueur connecté | Modérateurs juniors |
console.write | Envoyer des commandes dans la console live | Développeurs |
server.cfg.editor | Modifier le fichier de configuration | Direction technique uniquement |
control.server | Démarrer, arrêter, redémarrer l'instance | Direction technique |
players.playermode | Godmode, noclip, téléportation | Support en jeu, avec parcimonie |
Active la double authentification sur le compte Cfx.re associé au compte maître. Un panneau compromis, c'est un wipe de configuration et des bannissements de masse en quelques secondes.
Gérer les joueurs : warns, kicks et bannissements
L'onglet Players liste les connectés en temps réel avec leur ping, leur session et leurs identifiants (license, discord, steam, fivem, ip). Un clic sur un joueur ouvre sa fiche : historique de connexions, notes internes du staff, sanctions passées.
Les quatre actions de modération
- Warn : affiche un avertissement plein écran au joueur, tracé dans son historique. Idéal pour documenter une récidive.
- Kick : déconnexion immédiate avec un motif visible. Utile pour un joueur AFK ou un souci de ressource côté client.
- Ban : temporaire ou permanent, avec un motif. Le bannissement s'applique sur les identifiants sélectionnés.
- Player mode : passe ton propre personnage en noclip ou godmode pour intervenir sur un signalement en jeu.
Le choix des identifiants bannis compte plus que la durée. Bannir uniquement sur l'IP est inefficace face à un VPN, bannir sur la license Rockstar est bien plus solide. La configuration se fait dans les réglages du panneau, section bannissements.
Modèles de sanctions
Les ban templates évitent que chaque membre du staff invente son propre motif. Tu définis une liste de motifs récurrents avec une durée par défaut : cheat, RDM, propos haineux, publicité. Le modérateur choisit dans une liste déroulante, la sanction reste homogène et l'historique devient exploitable.
Whitelist et filtrage des arrivées
txAdmin propose plusieurs modes de whitelist : approbation manuelle par un admin, license déjà approuvée, appartenance à un serveur Discord, ou possession d'un rôle Discord précis. Le mode par rôle Discord est le plus pratique pour un projet roleplay avec candidature, puisque l'attribution du rôle vaut validation.
# Extrait de server.cfg
sv_maxclients 64
sv_hostname "Mon projet RP"
set steam_webApiKey "none"
onesync on
ensure txAdminAPIPlanifier les redémarrages et la maintenance automatique
Un serveur FiveM qui tourne plusieurs jours d'affilée accumule des entités orphanes, des fuites mémoire côté ressources et une dégradation progressive du tick. Le planificateur du panneau règle ce problème en programmant des redémarrages à heures fixes, avec annonces automatiques en jeu.
Configurer le planning
Dans Settings > Restarter, tu saisis les horaires au format 24h séparés par des virgules. Un rythme de quatre redémarrages quotidiens convient à la plupart des projets roleplay chargés, deux suffisent sur une instance légère.
Scheduled restart times : 05:00, 11:00, 17:00, 23:00Les messages d'avertissement s'envoient automatiquement à intervalles décroissants avant l'arrêt. Tu peux les traduire et les personnaliser dans les réglages de localisation. Un joueur prévenu range son véhicule et sauvegarde son inventaire, ce qui réduit les tickets de support post-redémarrage.
Redémarrer une ressource sans couper la partie
La console live accepte les commandes serveur classiques. Pour recharger un script après une modification, inutile de tout arrêter.
refresh
ensure mon_script
restart mon_script
stop mon_scriptAttention avec les frameworks : redémarrer es_extended ou qb-core à chaud casse la plupart des dépendances chargées derrière. Pour ces ressources centrales, un redémarrage complet reste plus sûr.
Faire tourner l'instance en service
Sur une machine que tu administres toi-même, encapsule FXServer dans une unité systemd pour qu'il remonte après un reboot. txAdmin gère la supervision applicative, systemd gère la supervision système.
[Unit]
Description=FXServer avec txAdmin
After=network.target mariadb.service
[Service]
User=fivem
WorkingDirectory=/home/fivem/server
ExecStart=/home/fivem/server/run.sh +set serverProfile default
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.targetsudo systemctl daemon-reload
sudo systemctl enable --now fxserver
sudo systemctl status fxserverSurveiller les performances et repérer les ralentissements
Le tableau de bord affiche la santé du thread principal sous forme de distribution des temps de tick. Tant que la majorité des ticks reste basse, le gameplay est fluide. Dès qu'une part significative dépasse la dizaine de millisecondes, les joueurs ressentent des saccades, des désynchronisations de véhicules et des NPC qui téléportent.
Lire les graphiques sans se tromper de coupable
Un pic isolé au moment d'un redémarrage ou d'une vague de connexions est normal. Ce qui doit alerter, c'est une dérive lente sur plusieurs heures : elle trahit presque toujours une ressource qui accumule des entités ou des boucles Citizen.Wait(0) mal calibrées.
Pour identifier la ressource responsable, la console reste l'outil le plus direct. Croise ensuite avec le moniteur côté client.
# Depuis la console txAdmin
resmon
# En jeu, en tant qu'admin
/resmon 1Les causes fréquentes de chute de tick
- Trop d'entités persistantes : véhicules abandonnés, props laissés par un script de construction.
- Requêtes SQL synchrones dans une boucle, typiques d'un script d'inventaire mal écrit.
- Ressources doublonnées qui écoutent le même événement deux fois.
- Un mode OneSync mal configuré au regard du nombre de connectés attendu.
Le matériel joue aussi. FiveM exploite peu de cœurs mais aime la fréquence : un Ryzen 9 7950X3D avec de la DDR5 ECC et du stockage NVMe tient bien mieux les pics d'un projet chargé qu'un CPU mutualisé à basse fréquence. La latence réseau, elle, dépend du lien et de la protection anti-DDoS en amont.
Sauvegardes et lecture des journaux
txAdmin conserve plusieurs journaux distincts, à ne pas confondre. Le Server Log trace les événements de jeu : connexions, déconnexions, messages, morts, explosions. L'Action Log trace ce que fait le staff : chaque kick, ban et modification de configuration, avec l'auteur et l'horodatage.
Retrouver un incident précis
Les journaux se filtrent par joueur et par type d'événement. Pour instruire un signalement, pars de l'heure indiquée par le plaignant, isole les événements d'explosion ou de dégâts, puis remonte à la fiche du suspect pour consulter son historique complet.
ls -lh txData/default/logs/
tail -n 200 -f txData/default/logs/fxserver.log
grep -i "banned" txData/default/logs/admin.logSauvegarder ce que txAdmin ne sauvegarde pas
La base de données concentre tout ce qui a de la valeur : personnages, inventaires, propriétés, argent. Un dump quotidien automatisé est le minimum absolu.
# crontab -e
0 4 * * * /usr/bin/mysqldump --single-transaction -u backup -p'MDP' esx_db | gzip > /backups/esx_$(date +\%F).sql.gz
30 4 * * * find /backups -name "esx_*.sql.gz" -mtime +14 -deleteAjoute une copie du dossier resources/ et du server.cfg, puis externalise le tout sur un stockage distinct de la machine de jeu. Une sauvegarde stockée uniquement à côté du serveur ne protège de rien. Les sauvegardes automatiques d'un panel comme NexusPanel couvrent cette partie, et le WebFTP permet de récupérer un fichier isolé sans ouvrir de session SSH.
La documentation officielle Cfx.re détaille les options de démarrage et les variables convar utilisables avec le panneau : Source. Pour les projets qui tournent aussi sur le Far West, la logique décrite ici s'applique à l'identique sur un Serveur RedM, et les mêmes réflexes de journalisation valent pour Tous nos serveurs de jeux.
Conclusion
Commence par verrouiller le port 40120 et par distribuer des permissions minimales à ton staff : c'est là que se jouent 90 % des incidents graves. Ensuite seulement, règle le planificateur de redémarrages et branche un dump MySQL quotidien en cron, parce que txAdmin ne touchera jamais à ta base. Et quand le tick s'effondre, ouvre resmon avant d'accuser le matériel : neuf fois sur dix, la ressource fautive est dans la liste.
FAQ
Comment réinitialiser le mot de passe admin de txAdmin ?
Arrête le processus FXServer, puis supprime ou renomme le fichier txData/admins.json. Au redémarrage, txAdmin détecte l'absence de compte administrateur et affiche à nouveau un code PIN à quatre chiffres dans la console. Ouvre l'interface sur le port 40120, saisis ce PIN et recrée un compte maître. Les bannissements et l'historique des joueurs, stockés séparément, ne sont pas affectés par cette manipulation.
Peut-on gérer plusieurs instances FiveM avec un seul txAdmin ?
Non, une instance txAdmin pilote un seul profil de serveur à la fois. Pour en administrer plusieurs, lance autant de processus FXServer que nécessaire, chacun avec son propre serverProfile et son propre port de panneau, par exemple 40120, 40121 et 40122. Chaque instance garde alors ses propres comptes admin, sa configuration, ses journaux et son planning de redémarrages, sans interférence entre les projets.
Pourquoi mes bannissements txAdmin ne bloquent-ils pas les joueurs qui reviennent ?
Vérifie d'abord que la ressource monitor est bien chargée et que le fichier server.cfg ne contient pas un script tiers qui accepte les connexions avant le filtre du panneau. Contrôle ensuite les identifiants retenus lors de la sanction : un bannissement basé uniquement sur l'IP se contourne facilement. Privilégie la license Rockstar, plus stable, et croise-la avec l'identifiant Discord quand la whitelist l'impose.
