Créer une whitelist FiveM avec Discord et txAdmin

Temps estimé : 15 minutes
Difficulté : Débutant ⭐
Serveurs compatibles : FiveM sur OuiPanel, canal Legacy (txAdmin)

📋 Introduction

Une whitelist par rôle Discord est la méthode la plus simple pour un serveur RP. Seuls les joueurs qui ont un rôle précis sur votre Discord peuvent se connecter. Vous validez une candidature, le joueur reçoit le rôle et il entre en ville. Pas de licence à recopier, pas de commande à taper.

Ce guide utilise txAdmin, fourni avec votre serveur FiveM chez OuiHeberg, et Toscio, un bot Discord gratuit qui gère les candidatures. Il a été préparé avec l'équipe de Toscio.

🎬 Regardez la mise en place en vidéo (2 min 30 sur YouTube).

✅ Ce qu'il vous faut

Votre serveur FiveM OuiHeberg sur le canal Legacy, qui démarre avec sa clé de licence (voir notre guide Keymaster FiveM)
Un serveur Discord sur lequel vous avez la permission Gérer le serveur
15 minutes

Activez d'abord le mode développeur de Discord dans Paramètres utilisateur → Avancés. Il permet de copier les identifiants dont vous aurez besoin.

🎭 Étape 1 : créer le rôle qui ouvre les portes

Dans Paramètres du serveur → Rôles, créez un rôle Whitelisté. Faites un clic droit dessus puis Copier l'identifiant du rôle. Gardez ce numéro sous la main.

🤖 Étape 2 : créer un bot Discord pour txAdmin

txAdmin vérifie les rôles grâce à un bot Discord que vous créez vous-même.

Sur le portail développeur de Discord, cliquez sur New Application.
Dans l'onglet Bot, cliquez sur Reset Token puis copiez le jeton. Gardez-le secret, car il donne le contrôle complet du bot.
Toujours dans Bot, activez Server Members Intent et enregistrez. Sans cette option, txAdmin ne voit pas les rôles.
Dans l'onglet OAuth2 → URL Generator, cochez bot, ouvrez le lien généré et invitez le bot sur votre Discord.

🛡️ Étape 3 : activer la whitelist dans txAdmin

Ouvrir txAdmin

Chez OuiHeberg, txAdmin s'ouvre dans votre navigateur, à l'adresse IP de votre serveur suivie de son port txAdmin. Ce port est indiqué dans OuiPanel.

Dans OuiPanel, ouvrez votre serveur FiveM puis Configuration → Gestion des ports. Votre serveur a deux ports. Le port principal sert aux joueurs, le second est celui de txAdmin.
Dans Configuration → Paramètres du serveur, vérifiez que TXADMIN_ENABLE vaut 1 et que TXADMIN_PORT contient ce second port. Si vous changez une valeur, redémarrez le serveur.
Ouvrez l'adresse dans votre navigateur, avec l'IP et le port txAdmin de votre serveur. Par exemple http://203.0.113.10:40120.
À la première connexion, txAdmin demande un code PIN. Il s'affiche dans la Console de votre serveur sur OuiPanel.

💡 txAdmin n'existe que sur le canal Legacy de FiveM. Sur le canal Enhanced, le serveur fonctionne sans txAdmin. Le canal se choisit dans Configuration FiveM, sur OuiPanel.

Connecter le bot et choisir le mode de whitelist

Dans txAdmin, ouvrez Settings.

Onglet Discord : activez Discord Bot, collez le jeton dans Token et l'identifiant de votre serveur Discord dans Guild/Server ID. Pour l'obtenir, faites un clic droit sur le nom du serveur puis Copier l'identifiant du serveur. Enregistrez.
Onglet Whitelist : dans Allowlist Mode, choisissez Discord Server Roles. Collez l'identifiant du rôle dans Allowlisted Discord Roles. Dans Allowlist Instructions, indiquez aux joueurs où postuler. Enregistrez.

⚠️ Donnez-vous le rôle Whitelisté, ainsi qu'à votre staff, avant de vous reconnecter. Sinon txAdmin vous refusera aussi.

📝 Étape 4 : gérer les candidatures sur Discord avec Toscio

Il reste à donner le rôle aux joueurs acceptés. Toscio s'en charge.

Ajoutez Toscio à votre Discord depuis toscio.com.
Dans Paramètres du serveur → Rôles, placez le rôle Toscio au-dessus de Whitelisté. Un bot ne peut donner que les rôles situés sous le sien.
Tapez /toscio setup et choisissez le modèle Whitelist RP, le salon où les joueurs postulent, un salon privé pour votre staff et le rôle Whitelisté.

Les joueurs cliquent sur Postuler et remplissent le formulaire. Votre staff accepte, refuse avec un motif ou ouvre un entretien privé, par exemple pour la douane. À l'acceptation, Toscio donne le rôle et prévient le joueur en message privé. Il peut se connecter tout de suite.

Les questions (âge, personnage, background, règlement…) se modifient dans le dashboard de Toscio. Pour trouver des idées, consultez ces 53 questions de whitelist GTA RP.

🎁 1 mois de Premium Toscio offert aux clients OuiHeberg. Sur app.toscio.com, ouvrez votre serveur, allez sur la page Premium et saisissez le code OUIHEBERG. Aucune carte bancaire n'est demandée.

❓ Problèmes fréquents

« You do not have the discord identifier »

Le joueur doit ouvrir l'application Discord sur son PC, pas la version web, avant de lancer FiveM.

Un joueur accepté est quand même refusé

Vérifiez l'identifiant du rôle dans l'onglet Whitelist de txAdmin. Vérifiez aussi que le joueur se connecte avec le même compte Discord que pour sa candidature.

Toscio n'arrive pas à donner le rôle

Remontez le rôle Toscio au-dessus de Whitelisté dans les rôles de votre Discord.

txAdmin n'enregistre pas les réglages Discord

Activez Server Members Intent dans l'onglet Bot du portail développeur de Discord.

La page de txAdmin ne s'ouvre pas

Vérifiez que votre serveur est sur le canal Legacy et que TXADMIN_ENABLE vaut 1. Utilisez le port txAdmin, pas le port de jeu, et une adresse en http://, pas en https://.

Pour les autres cas, consultez le tuto complet sur toscio.com.

🚀 Pas encore de serveur ?

Notre hébergement FiveM installe votre serveur en quelques minutes, avec txAdmin et le choix de la version d'artifact.

Besoin d'un serveur GTA/FiveM ?

Découvrez nos offres d'hébergement GTA V / FiveM dès 2,99 €/mois, serveur prêt en 60 secondes.

Voir les offres