Ce guide vous accompagne dans la configuration de votre serveur FiveM (multijoueur GTA V) hébergé chez Legion Hosting — de l'obtention de votre clé de licence CFX et la configuration de TXAdmin, à l'édition du server.cfg et la connexion des joueurs.
Avant de commencer : Assurez-vous d'avoir vos identifiants de connexion GPanel depuis votre e-mail de bienvenue et que votre serveur FiveM a été créé dans votre compte. Si vous n'avez jamais démarré de serveur auparavant, lisez d'abord le Guide de démarrage du serveur.
Prérequis
- Un serveur FiveM Legion Hosting (actif dans votre compte)
- Un compte sur le forum Cfx.re (gratuit — nécessaire pour générer votre clé de licence)
- Accès à GPanel
- Le client FiveM installé sur votre PC (fivem.net)
Étape 1 : Obtenir votre clé de licence CFX
Chaque serveur FiveM nécessite une clé de licence unique de Cfx.re (les développeurs de FiveM). Cette clé est gratuite et liée à votre compte Cfx.re.
- Allez sur https://keymaster.fivem.net/ et connectez-vous avec votre compte du forum Cfx.re.
- Cliquez sur New Server (ou Register a new server).
- Remplissez les détails :
- Label : Un nom convivial pour votre serveur (ex. « Mon serveur FiveM Legion »)
- Server IP Address : Entrez l'adresse IP de votre serveur depuis GPanel (voir Comment trouver l'IP et le port de votre serveur)
- Server Type : Sélectionnez le type approprié (généralement « Other / Apache / nginx »)
- Cliquez sur Generate.
- Copiez la clé de licence générée — vous en aurez besoin dans les prochaines étapes.
Gardez votre clé de licence privée. Ne la partagez pas publiquement. Si votre clé est compromise, vous pouvez la révoquer sur la page Keymaster et en générer une nouvelle.
Étape 2 : Premier démarrage du serveur et configuration de TXAdmin
Les serveurs FiveM hébergés chez Legion Hosting incluent TXAdmin — un panneau de gestion web qui fonctionne en parallèle de votre serveur FiveM. Au premier démarrage, TXAdmin vous guidera à travers la configuration initiale.
Démarrer le serveur
- Connectez-vous à GPanel et sélectionnez votre serveur FiveM.
- Allez dans l'onglet Startup et localisez la variable FIVEM_LICENSE (ou similaire). Collez votre clé de licence CFX ici et sauvegardez.
- Allez dans l'onglet Console et cliquez sur Start.
- Surveillez la sortie de la console. Au premier démarrage, le serveur téléchargera les artifacts FiveM nécessaires — cela peut prendre quelques minutes.
- Une fois TXAdmin prêt, vous verrez un message dans la console contenant l'URL de TXAdmin et un code PIN.
Trouver votre URL TXAdmin : TXAdmin fonctionne sur un port différent de celui du serveur de jeu. Vérifiez la sortie de la console ou l'onglet Network du GPanel pour le port TXAdmin. Le format de l'URL est
http://YOUR_SERVER_IP:TXADMIN_PORT.
Terminer la configuration de TXAdmin
- Ouvrez l'URL de TXAdmin dans votre navigateur.
- Entrez le PIN affiché dans la sortie de la console GPanel.
- Créez votre compte administrateur TXAdmin (nom d'utilisateur et mot de passe).
- TXAdmin vous guidera à travers un assistant de configuration :
- Server Name : Choisissez le nom affiché dans le navigateur de serveurs FiveM.
- Deployment Type : Sélectionnez un modèle (ex. « Popular Recipes » pour une base préconfigurée, ou « Remote URL / Template » si vous avez une configuration personnalisée).
- Server Data Folder : Laissez la valeur par défaut sauf si vous avez une raison spécifique de la modifier.
- CFX Key : Si demandé à nouveau, collez votre clé de licence.
- Terminez l'assistant et laissez TXAdmin finir le déploiement des fichiers du serveur. Cela peut prendre quelques minutes.
Sauvegardez vos identifiants TXAdmin. Si vous perdez l'accès à votre compte administrateur TXAdmin, vous devrez supprimer le profil TXAdmin et relancer la configuration. Notez votre nom d'utilisateur et mot de passe.
Étape 3 : Configurer server.cfg
Le fichier server.cfg est le fichier de configuration principal de votre serveur FiveM. TXAdmin en génère un basique lors de la configuration, mais vous voudrez le vérifier et le personnaliser.
Accéder à server.cfg
- Dans GPanel, cliquez sur l'onglet Files.
- Naviguez vers le dossier de données de votre serveur (généralement le répertoire racine ou un dossier créé par le modèle TXAdmin).
- Cliquez sur
server.cfgpour l'ouvrir dans l'éditeur intégré.
Paramètres essentiels
| Paramètre | Description | Exemple |
|---|---|---|
sv_hostname |
Nom du serveur affiché dans le navigateur de serveurs FiveM | "My Legion FiveM Server" |
sv_licenseKey |
Votre clé de licence CFX depuis Keymaster | "cfxk_xxxxxxxxxxxxxxxxxxxx" |
sv_maxclients |
Nombre maximum de joueurs autorisés sur le serveur | 48 |
endpoint_add_tcp |
Adresse et port d'écoute TCP | "0.0.0.0:YOUR_PORT" |
endpoint_add_udp |
Adresse et port d'écoute UDP | "0.0.0.0:YOUR_PORT" |
sv_endpointprivacy |
Masque les adresses IP des joueurs dans la liste des serveurs | true |
sets sv_projectName |
Nom court du projet affiché dans les détails du navigateur de serveurs | "My RP Server" |
sets sv_projectDesc |
Description courte affichée dans les détails du navigateur de serveurs | "A custom roleplay server" |
Un exemple minimal de server.cfg :
# Server Identity
sv_hostname "My Legion FiveM Server"
sets sv_projectName "My RP Server"
sets sv_projectDesc "A custom roleplay server hosted by Legion Hosting"
# License Key
sv_licenseKey "cfxk_YOUR_KEY_HERE"
# Network — use the port assigned in GPanel
endpoint_add_tcp "0.0.0.0:YOUR_PORT"
endpoint_add_udp "0.0.0.0:YOUR_PORT"
# Player Limit
sv_maxclients 48
# Privacy
sv_endpointprivacy true
# Resources
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure chat
Le port doit correspondre à GPanel. Le port dans
endpoint_add_tcp et endpoint_add_udp doit correspondre au port de jeu attribué à votre serveur dans GPanel. Vérifiez l'onglet Network du GPanel pour votre port spécifique.
Étape 4 : Se connecter à votre serveur FiveM
Une fois votre serveur configuré et en cours d'exécution, les joueurs peuvent se connecter en utilisant le navigateur de serveurs FiveM ou une connexion directe.
Connexion directe
- Ouvrez le client FiveM.
- Appuyez sur F8 pour ouvrir la console FiveM, ou cliquez sur le bouton Direct Connect sur l'écran d'accueil.
- Entrez l'IP et le port de jeu de votre serveur au format
IP:PORT. - Cliquez sur Connect.
Trouver votre IP et port : Vérifiez l'onglet Network du GPanel ou consultez Comment trouver l'IP et le port de votre serveur.
Navigateur de serveurs
- Ouvrez le client FiveM et cliquez sur Play.
- Dans le navigateur de serveurs, recherchez le nom de votre serveur (la valeur
sv_hostnamedu server.cfg). - Cliquez sur votre serveur puis cliquez sur Connect.
Le serveur n'apparaît pas dans le navigateur ? Les nouveaux serveurs peuvent mettre 5 à 15 minutes pour apparaître dans la liste des serveurs FiveM après le démarrage. Utilisez la connexion directe en attendant. Vérifiez également que votre
sv_licenseKey est valide et que les ports dans server.cfg correspondent à votre configuration réseau GPanel.
Gérer votre serveur avec TXAdmin
Après la configuration initiale, TXAdmin fournit un tableau de bord web pour la gestion quotidienne du serveur. Accédez-y à http://YOUR_SERVER_IP:TXADMIN_PORT.
| Fonctionnalité | Description |
|---|---|
| Dashboard | Visualisez l'état du serveur, le nombre de joueurs et les métriques de performance en un coup d'œil. |
| Players | Consultez les joueurs en ligne, expulsez ou bannissez des joueurs, consultez l'historique des joueurs. |
| Live Console | Exécutez des commandes serveur en temps réel, comme la console en jeu. |
| Resources | Démarrez, arrêtez et redémarrez des ressources individuelles sans redémarrer le serveur entier. |
| Server Log | Consultez les journaux d'actions pour auditer les actions des joueurs et des administrateurs. |
| CFG Editor | Modifiez server.cfg directement depuis TXAdmin sans utiliser le gestionnaire de fichiers GPanel. |
| Scheduled Restarts | Configurez des redémarrages automatiques à intervalles définis pour maintenir le serveur en bon état. |
Obtenir de l'aide
Si vous avez suivi ce guide et rencontrez toujours des problèmes :
- Copiez les messages d'erreur depuis la console GPanel ou le journal TXAdmin.
- Notez à quelle étape vous êtes bloqué et ce que vous avez déjà essayé.
- Ouvrez un ticket de support à https://legionhosting.net/submitticket.php avec ces informations. Notre équipe vous assistera le plus rapidement possible.
