Aller au contenu principal

Activer et configurer txAdmin

Guide txAdmin pour Serveurs FiveM sur RedHeberg

txAdmin est l'interface d'administration web officielle recommandée pour les serveurs FiveM. Elle simplifie considérablement la gestion de votre serveur de jeu grâce à une interface intuitive accessible via navigateur.

Qu'est-ce que txAdmin ?

txAdmin est un panel d'administration web moderne qui permet de gérer votre serveur FiveM de manière centralisée. Il offre des fonctionnalités avancées comme la gestion des joueurs, le redémarrage automatique, les sauvegardes, et bien plus.

Inclusion native

txAdmin est inclus nativement dans les artifacts FiveM modernes, aucune installation séparée n'est nécessaire.

Installation et Configuration Initiale

1. Préparation du Serveur

Connectez-vous à votre VPS RedHeberg et préparez l'environnement :

# Mise à jour du système
sudo apt update && sudo apt upgrade -y

# Installation des dépendances
sudo apt install curl wget git unzip -y

# Création du répertoire FiveM
mkdir ~/fivem-server
cd ~/fivem-server

2. Téléchargement de FiveM Server

# Téléchargement de la dernière version
wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/$(curl -s https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/ | grep -oP 'fx-\d+-[a-f0-9]+' | tail -1)/fx.tar.xz

# Extraction
tar -xf fx.tar.xz
rm fx.tar.xz

# Permissions d'exécution
chmod +x run.sh

3. Configuration du Serveur

Créez le fichier de configuration :

# Création du fichier server.cfg
cat > server.cfg << 'EOF'
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# Interface txAdmin (accessible sur le port 40120)
set txAdmin-interface true
set txAdmin-port 40120
set txAdmin-bind "0.0.0.0"

# Configuration de base
sv_hostname "Mon Serveur FiveM - RedHeberg"
sv_maxclients 32
set steam_webApiKey "VOTRE_CLE_STEAM_API"
set sv_licensekey "VOTRE_LICENSE_KEY_FIVEM"

# Ressources par défaut
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
EOF

4. Premier Démarrage avec txAdmin

# Lancement du serveur avec txAdmin
./run.sh +exec server.cfg

Accès à l'Interface txAdmin

Une fois le serveur démarré, txAdmin est accessible via votre navigateur :

http://YOUR_SERVER_IP:40120
Configuration réseau

Assurez-vous que le port 40120 est ouvert dans votre pare-feu pour accéder à l'interface txAdmin.

Assistant de Configuration Initial

Lors de votre première connexion, txAdmin vous guide à travers l'assistant de configuration :

  1. Création du compte administrateur

    • Nom d'utilisateur
    • Mot de passe sécurisé
    • Email de contact
  2. Configuration du serveur

    • Nom du serveur
    • Description
    • Tags et métadonnées
  3. Sélection des ressources

    • Ressources de base recommandées
    • Mods et scripts personnalisés

Utilisation des Templates de Serveur

txAdmin propose plusieurs templates prêts à l'emploi pour démarrer rapidement :

Importation d'un Template

  1. Dans l'interface txAdmin, naviguez vers Settings > Server
  2. Cliquez sur Recipe Deployer
  3. Sélectionnez un template :
    • CFX Default : Configuration minimale
    • PlumeESX : Serveur Roleplay ESX complet
    • QBCore : Framework QBCore populaire
    • Custom : Import d'une configuration personnalisée
# Structure recommandée pour un template personnalisé
mkdir -p ~/fivem-templates/mon-template
cd ~/fivem-templates/mon-template

# Fichier de recette
cat > recipe.yaml << 'EOF'
name: Mon Template Custom
version: 1.0.0
author: Mon Pseudo
description: Template personnalisé pour serveur RP

server_data:
resources:
- esx_core
- esx_menu_default
- skinchanger
- esx_skin
EOF

Gestion des Joueurs

Interface de Gestion

L'onglet Players offre une vue complète des joueurs connectés :

FonctionDescriptionAction
KickExpulser temporairementClic droit > Kick
BanBannissement permanentClic droit > Ban
WarnAvertissementClic droit > Warn
SpectateObserver le joueurClic droit > Spectate
MessageMessage privéClic droit > DM

Actions en Lot

# Commandes console pour actions groupées
txaKickAll "Redémarrage serveur dans 2 minutes"
txaBanList "Affichage de la liste des bans"
txaUnban ID_JOUEUR "Levée de ban"

Gestion des Permissions

txAdmin permet de créer différents niveaux d'accès :

  1. Master Admin : Contrôle total
  2. Admin : Gestion joueurs et serveur
  3. Moderator : Gestion joueurs uniquement
  4. View Only : Consultation des logs

Gestion des Ressources

Redémarrage des Ressources

Via l'interface web :

  1. Resources > Liste des ressources actives
  2. Sélectionner la ressource à redémarrer
  3. Actions > Restart Resource

Via console :

# Redémarrage d'une ressource spécifique
restart esx_core

# Redémarrage de toutes les ressources
restart *

# Arrêt d'une ressource
stop nom_ressource

# Démarrage d'une ressource
start nom_ressource

Monitoring des Performances

txAdmin surveille automatiquement :

  • CPU Usage : Utilisation processeur par ressource
  • Memory Usage : Consommation mémoire
  • Network : Trafic réseau généré
  • Players Count : Nombre de joueurs connectés

Planifications et Automatisation

Configuration des Redémarrages Automatiques

  1. Settings > Scheduler
  2. Add Schedule pour créer une nouvelle planification :
{
"name": "Redémarrage quotidien",
"type": "restart",
"cron": "0 6 * * *",
"announcement": {
"enabled": true,
"message": "Redémarrage automatique dans 5 minutes",
"delay": 300
}
}

Scripts de Maintenance

# Script de sauvegarde automatique
cat > ~/scripts/backup-server.sh << 'EOF'
#!/bin/bash
DATE=$(date +%Y%m%d_%H%M%S)
BACKUP_DIR="/home/backups"
SERVER_DIR="/home/fivem-server"

mkdir -p $BACKUP_DIR
tar -czf "$BACKUP_DIR/fivem_backup_$DATE.tar.gz" $SERVER_DIR
find $