Whitelist FiveM avec Discord et txAdmin : le tuto complet
Avec txAdmin, ta whitelist FiveM peut reposer sur un simple rôle Discord : un joueur qui a le rôle @Whitelisté se connecte, les autres sont refusés à l’entrée. Ajoute un bot de candidature qui donne ce rôle quand ton staff accepte, et accepter une WL suffit à whitelister le joueur. Plus de licence à copier, plus de commande en console.
Ce tuto te prend 15 minutes, de zéro à ta première WL acceptée.
Comment ça marche
Trois pièces, chacune avec un seul rôle :
| Pièce | Ce qu’elle fait |
|---|---|
| Le rôle @Whitelisté | La clé d’entrée de ton serveur FiveM |
| Toscio | Reçoit les candidatures sur Discord et donne le rôle quand le staff accepte |
| txAdmin | Vérifie le rôle à chaque connexion et refuse ceux qui ne l’ont pas |
Côté joueur, ça donne : il rejoint ton Discord, clique sur Postuler, remplit la WL, reçoit « candidature acceptée » en MP, lance FiveM et se connecte. Personne du staff n’a eu à ouvrir txAdmin.
Ce tuto suit les menus de txAdmin 8, livré avec les versions récentes de FXServer. Les intitulés de txAdmin sont en anglais : on les garde tels quels pour que tu les retrouves.
Avant de commencer
Il te faut :
- un serveur FiveM avec txAdmin, et un compte txAdmin qui peut modifier les réglages ;
- les droits Gérer le serveur sur ton Discord ;
- le mode développeur de Discord, pour copier des identifiants : Paramètres utilisateur → Avancés → Mode développeur.
1. Crée le rôle @Whitelisté
- Sur ton Discord, ouvre Paramètres du serveur → Rôles → Créer un rôle.
- Nomme-le Whitelisté (ou WL, Citoyen… le nom n’a pas d’importance).
- Fais un clic droit sur le rôle puis Copier l’identifiant du rôle. Garde ce numéro de côté.
Tu as une étape de douane ou des visiteurs ? Crée aussi un rôle @Visiteur : Toscio pourra le retirer au moment d’accepter la WL.
2. Crée le bot Discord de txAdmin
txAdmin a besoin de son propre bot pour lire les rôles de tes joueurs. Ce n’est pas Toscio : c’est un bot à toi, qui ne sert qu’à txAdmin.
- Va sur le portail développeur de Discord et clique sur New Application. Donne-lui le nom de ton serveur.
- Dans l’onglet Bot, clique sur Reset Token et copie le jeton. Ne le partage jamais : il donne le contrôle du bot.
- Toujours dans Bot, active Server Members Intent et enregistre. Sans lui, txAdmin ne voit pas les rôles.
- Dans OAuth2 → URL Generator, coche le scope bot, ouvre le lien généré et ajoute le bot à ton serveur Discord.
Si l’enregistrement des réglages Discord échoue ou tourne dans le vide dans txAdmin, c’est presque toujours le Server Members Intent qui n’est pas activé.
3. Branche le bot dans txAdmin
- Dans txAdmin, ouvre Settings, onglet Discord.
- Active Discord Bot.
- Colle le jeton dans Token.
- Dans Guild/Server ID, colle l’identifiant de ton serveur Discord (clic droit sur le nom du serveur, Copier l’identifiant du serveur).
- Enregistre.
4. Passe txAdmin en whitelist par rôle Discord
- Toujours dans Settings, ouvre l’onglet Whitelist.
- Dans Allowlist Mode, choisis Discord Server Roles.
- Dans Allowlisted Discord Roles, colle l’identifiant du rôle @Whitelisté. Tu peux en mettre plusieurs, séparés par des virgules (par exemple @Whitelisté et @Staff).
- Dans Allowlist Instructions, explique aux joueurs refusés comment postuler, par exemple : « Rejoins discord.gg/tonserveur et postule dans #candidater. »
- Enregistre.
Dès maintenant, txAdmin refuse tout joueur qui n’a pas le rôle. Pense à te le donner, à toi et à ton staff, avant de tester.
5. Reçois les candidatures avec Toscio
Il reste à automatiser la remise du rôle.
- Ajoute Toscio à ton Discord.
- Dans Paramètres du serveur → Rôles, glisse le rôle Toscio au-dessus de @Whitelisté. Discord ne laisse un bot donner que les rôles placés sous le sien.
- Lance
/toscio setupavec :modele: Whitelist RP (FiveM, GTA RP…) ;salon: le salon où les joueurs postulent, par exemple#candidater;salon-staff: un salon privé pour ton équipe WL, par exemple#wl-staff;role: @Whitelisté ;role-staff: ton rôle de staff WL, si tu en as un.
Toscio publie le panneau avec le bouton Postuler et te confirme où arriveront les candidatures. Ton premier formulaire profite de 7 jours de Premium offerts, sans carte bancaire : la WL complète avec toutes ses questions.
Pour choisir tes questions, pioche dans les 53 questions whitelist GTA RP, puis modifie le formulaire dans l’éditeur. Dans les réglages du formulaire, tu peux aussi faire retirer @Visiteur à l’acceptation.
6. Teste tout le parcours
Avec un deuxième compte Discord, ou un ami :
- Clique sur Postuler, remplis la WL et envoie-la.
- Dans
#wl-staff, clique sur Accepter sur la fiche de candidature. - Vérifie que le compte a bien reçu @Whitelisté et le message privé de confirmation.
- Ouvre l’application Discord sur le PC, lance FiveM et connecte-toi : tu entres.
- Retire le rôle et réessaie : txAdmin te refuse avec ton message d’instructions.
Ce que voit ton staff
Chaque WL arrive dans le salon du staff avec les réponses, l’âge du compte Discord et la date d’arrivée sur le serveur, et trois boutons :
- Accepter : Toscio donne @Whitelisté et prévient le joueur en MP, dans sa langue. Il peut se connecter tout de suite.
- Refuser : avec un motif, pour que le joueur sache quoi retravailler. Un délai de 24 h (réglable) bloque les WL renvoyées en boucle.
- Entretien : un fil privé s’ouvre avec le joueur. Pratique pour caler le passage à la douane en vocal, puis accepter après l’oral.
Les erreurs fréquentes
| Message ou symptôme | Cause | Solution |
|---|---|---|
| « You do not have the discord identifier » | FiveM ne trouve pas le compte Discord du joueur | Ouvrir l’application Discord sur le PC (pas dans le navigateur) avant de lancer FiveM |
| « You are required to join our Discord server » | Le joueur n’est pas sur le Discord configuré dans txAdmin | Vérifier le Guild/Server ID, et que le joueur a rejoint le bon serveur |
| « You do not have a allowlisted role » | Le joueur n’a pas le rôle, ou l’identifiant collé est faux | Vérifier l’identifiant du rôle dans l’onglet Whitelist |
| L’acceptation échoue dans Toscio | Le rôle Toscio est sous @Whitelisté | Remonter le rôle Toscio dans Paramètres du serveur → Rôles |
| txAdmin n’enregistre pas les réglages Discord | Intent manquant | Activer Server Members Intent sur le portail développeur |
Le joueur utilise le même compte Discord que celui qui a postulé ? C’est indispensable : txAdmin vérifie le rôle du compte Discord ouvert sur son PC.
Et la whitelist par licence ?
txAdmin propose aussi le mode Approved License : chaque joueur doit être validé à la main dans la page Allowlist de txAdmin, avec un identifiant de demande. Ça marche, mais quelqu’un du staff doit faire la manip pour chaque joueur, en plus de lire sa candidature.
Avec le rôle Discord, la décision et l’accès ne font qu’un. Ça veut aussi dire que retirer le rôle suffit à retirer l’accès, que tu peux whitelister ton staff avec un second rôle, et que tout l’historique des WL reste dans Discord.
Pour aller plus loin
- Recours de ban : un joueur banni de ton Discord ne peut plus postuler. Avec le formulaire web et les recours de ban, il fait appel depuis une page web et Toscio le débannit si ton staff accepte.
- Votes du staff : plusieurs membres de l’équipe WL votent sur chaque candidature, et Toscio décide quand le nombre de votes est atteint.
- Plusieurs formulaires : WL civile, candidature LSPD, EMS, staff… Chacun avec son rôle et son salon. Voir le cas whitelist FiveM.
Questions
Comment faire une whitelist FiveM avec Discord ?
Dans txAdmin, active le bot Discord (onglet Discord), puis choisis le mode « Discord Server Roles » dans l’onglet Whitelist et colle l’identifiant de ton rôle @Whitelisté. Seuls les joueurs qui ont ce rôle sur ton Discord peuvent se connecter. Un bot de candidature comme Toscio donne ce rôle quand ton staff accepte la candidature.
Pourquoi le joueur reçoit « You do not have the discord identifier » ?
FiveM n’a pas trouvé son compte Discord. Le joueur doit ouvrir l’application Discord sur son PC (pas la version navigateur) avant de lancer FiveM, puis se reconnecter.
Faut-il un bot Discord en plus de Toscio pour txAdmin ?
Oui. txAdmin utilise son propre bot, que tu crées sur le portail développeur de Discord, pour lire les rôles des joueurs. Toscio, lui, gère les candidatures et donne le rôle. Les deux tournent côte à côte sans se gêner.
Comment retirer la whitelist à un joueur ?
Retire-lui le rôle @Whitelisté sur Discord. txAdmin vérifie le rôle à chaque connexion : le joueur sera refusé à sa prochaine tentative.
La whitelist par rôle Discord marche avec ESX et QBCore ?
Oui. La vérification est faite par txAdmin au moment de la connexion, avant que le framework entre en jeu. Peu importe que ton serveur tourne sous ESX, QBCore, Qbox ou un framework maison.
