How to Set Up a Discord Whitelist for Your FiveM Server (…

Public: Propriétaires et développeurs de serveurs FiveM
Difficulté: Facile → Intermédiaire
Résultat: Liste autorisée basée sur les rôles utilisant les rôles Discord (avec liste noire facultative), maintenance minimale, commentaires clairs des joueurs.

Note sur les versions: Le dépôt open source FAX/Liste blanche Discord est géré par la communauté et sa dernière mise à jour date de 2022. Il fonctionne toujours sur de nombreux serveurs. Une version commerciale gérée existe ; si vous avez besoin d'assistance ou d'un contrat de niveau de service, n'hésitez pas à l'envisager. Ce guide présente la version gratuite GitHub.

---

TL;DR

1. Créer un Discord Bot → activer Intention des membres du serveur → invitez-le sur votre Discord.
2. Copiez votre ID de guilde (serveur) et ID(s) de rôle.
3. Télécharger: Liste blanche FAX/Discord sur GitHub → le mettre dedans ressources/ → configurer serveur.js.
4. Ajouter assurer DiscordWhitelist à serveur.cfg (ou démarrez dans txAdmin).
5. Test : rejoindre sans le rôle (bloqué) → ajouter un rôle → rejoindre (autorisé).

Tutoriels associés :
• Liste blanche FiveM — Guide complet (txAdmin, scripts, base de données)
• Comment créer des niveaux de dons sur Discord

---

Pourquoi une liste blanche basée sur Discord ?

• Dynamique: Accordez/refuser l'accès en ajoutant/supprimant un rôle Discord — aucune modification ACE ou DB.
• Évolutif: Les mods peuvent gérer l'accès depuis Discord sur mobile.
• Auditable: L'historique des rôles + les journaux de modération montrent qui a autorisé qui.

---

Prérequis

• Un serveur Discord (vous êtes administrateur/propriétaire).
• Serveur FiveM avec txAdmin ou contrôle manuel.
• Les joueurs doivent avoir le Application de bureau Discord en cours d'exécution lors de la connexion (donc FiveM expose un discorde: identifiant).

---

Étape 1 — Créer un bot Discord et activer les intentions

1. Aller à la Portail des développeurs Discord → Nouvelle application → nommez-le (par exemple, Bot de liste blanche FiveMX).
2. Ajouter un bot (Onglet Bot) → Jeton de réinitialisation → copier le Jeton de bot (conservez-le en toute sécurité).
3. Sous Intentions de passerelle privilégiées, activer Intention des membres du serveur. (L'intention de présence n'est pas requise.)
4. Inviter le bot sur votre Discord : OAuth2 → Générateur d'URL → Portées : robotAutorisations : minimales (possiblement nulles, au-delà de l'adhésion). Utilisez l'URL générée et ajoutez-la à votre guilde.

Sécurité: Traitez le jeton du bot comme un mot de passe. pas Envoyez-le sur Git ou partagez-le dans des captures d'écran. Faites-le pivoter en cas de fuite.

---

Étape 2 — Obtenez vos identifiants (guilde et rôles)

• Dans Discord → Paramètres utilisateur → Avancé → Mode développeur: SUR.
• Faites un clic droit sur votre nom du serveur → Copier l'ID du serveur.
• Paramètres du serveur → Rôles → faites un clic droit sur le rôle que vous utiliserez comme liste blanche (par exemple, Liste blanche) → Copier l'ID de rôle.
• (Facultatif) Copiez les identifiants de tous les rôles que vous souhaitez liste noire (par exemple, Interdit).

Gardez-les à portée de main :

• GUILD_ID = 123456789012345678
• WHITELIST_ROLE_IDS = ["111111111111111111", "22222222222222222"]
• BLACKLIST_ROLE_IDS = ["333333333333333333"]

---

Étape 3 — Téléchargez et installez la ressource

1. Télécharger le code postal de Liste blanche FAX/Discord (GitHub).
2. Extrayez sur votre serveur à :
   ressources/[discord]/DiscordWhitelist
3. Vérifiez que le dossier contient au moins :
   • fxmanifest.lua
   • serveur.js
   • paquet.json

serveur.cfg (ou txAdmin Recette / Démarrage):

# Commencez après vos fournisseurs d'identifiants et avant la logique de jointure qui en dépend, assurez-vous que DiscordWhitelist

Dans txAdmin → Ressources, marque Liste blanche Discord pour démarrer au démarrage (si vous gérez les ressources via l'interface utilisateur).

Vous planifiez votre stratégie d’accès ? Lisez notre guide plus complet : Liste blanche FiveM — Guide complet (txAdmin, scripts, base de données) pour les alternatives (ACE, DB, hybride) et quand utiliser chacune d'elles.

---

Étape 4 — Configurer serveur.js

Ouvrir ressources/[discord]/DiscordWhitelist/server.js et définissez le bloc de configuration. Le fichier peut déjà contenir un objet de configuration simple ; ajustez les valeurs en conséquence. Une configuration typique ressemble à ceci :

// Configuration de DiscordWhitelist — exemple const config = { botToken: "PASTE_YOUR_DISCORD_BOT_TOKEN_HERE", guildId: "123456789012345678", // Votre identifiant de serveur (guilde) // Les joueurs doivent avoir au moins UN de ces identifiants de rôle pour rejoindre whitelistRoles: [ "11111111111111111", // Liste blanche // "22222222222222222", // Personnel (facultatif) ], // Si un joueur a L'UN de ces rôles, rejetez la connexion blacklistRoles: [ // "33333333333333333", // Banni ], // Mettre en cache les données de rôle récupérées pour réduire les appels à l'API Discord (secondes) cacheMaxTime: 90, // Messages de report messages: { noDiscord: "Ouvrez Discord et rejoignez-nous. Votre L'application Discord doit être en cours d'exécution.", notWhitelisted: "Vous n'êtes pas sur liste blanche. Rejoignez notre Discord : discord.gg/yourinvite", blacklisted: "Accès refusé. Veuillez contacter le personnel.", welcome: "Bienvenue — vous êtes vérifié. Chargement…" }, };

Conseil de monétisation : Si votre serveur utilise des avantages, associez-les à Niveaux de dons Discord pour automatiser les avantages basés sur les rôles pour les supporters/donateurs.

Enregistrez le fichier.

---

Étape 5 — Redémarrer et tester

1. Redémarrage juste la ressource ou le serveur entier : txAdmin → Redémarrer la ressource ou console rafraîchir alors redémarrer DiscordWhitelist.
2. Test négatif: Essayez de vous connecter sans le rôle de la liste blanche → vous devriez voir le message de report et être expulsé.
3. Test positif: Accordez-vous le rôle de liste blanche → reconnectez-vous → vous devriez être autorisé à entrer.

---

Facultatif : rôles multiples et contournement du personnel

• Ajouter plusieurs rôles de liste blanche pour permettre plusieurs entonnoirs (par exemple, Donateur, Police, EMS).
• Ajouter rôles de liste noire pour les blocages durs indépendamment de la liste blanche (par exemple, Interdit).
• Vous pouvez inclure un rôle du personnel dans rôles de liste blanche pour garantir l'accès aux administrateurs.

---

Conseils opérationnels

• Automation:Connectez l'attribution de rôle Discord à votre formulaires de demande ou approbations de billets (par exemple, avec un bot, Google Forms → webhook → ajout de rôle).
• UX du joueur: Épingler un #Comment créer une liste blanche postez avec les exigences de rôle ✅ et votre invitation au serveur.
• Modération: Enregistrer les changements de rôle dans un journal privé #mod-journaux canal.

---

Dépannage

« Bot hors ligne » ou ne met jamais à jour les rôles

• Jeton incorrect ou bot non invité dans la bonne guilde.
• Intention des membres du serveur non activé.
• Le pare-feu bloque le HTTPS sortant de votre hébergeur de jeu (autorise l'API Discord).

« Aucun identifiant Discord trouvé » / tout le monde bloqué

• Les joueurs doivent exécuter le Application de bureau Discord avant de lancer FiveM. Demandez-leur de redémarrer Discord, puis FiveM.

Les changements de rôle ne s'appliquent qu'après un redémarrage

• Réduire cacheMaxTime à 30–60 secondes.
• Si vous le définissez extrêmement bas et que vous constatez toujours des retards, vérifiez les limites de débit et évitez de redémarrer fréquemment.

Erreur 403/Autorisations lors de la récupération des membres de la guilde

• Assurez-vous que le bot est dans la guilde cible et L'intention des membres du serveur est activée.
• Le bot fait pas besoin d'autorisations d'administrateur pour lire les rôles des membres.

Utilisation élevée de l'API / limitation du débit

• Augmenter cacheMaxTimeÉvitez les redémarrages/expulsions en masse qui spamment les appels API.

---

Meilleures pratiques de sécurité

• Stocker le Jeton de bot En dehors du contrôle de version. Si vous hébergez vous-même vos configurations, pensez à les lire depuis une variable d'environnement ou une variable server.cfg, et non en texte brut validé dans Git.
• Tourner le jeton s'il est divulgué.
• Restreindre qui a accès en écriture à la ressource.

---

Désinstaller / Désactiver

• Retirer assurer DiscordWhitelist depuis serveur.cfg (ou désactiver dans txAdmin → Ressources).
• Supprimer le dossier de ressources/ si vous le mettez hors service.

---

FAQ

Les joueurs ont-ils besoin de Discord en cours d'exécution ?
Oui. Sans le discorde: identifiant, le script ne peut pas vérifier les rôles.

De quelles intentions ai-je besoin ?
Seulement Intention des membres du serveur.

Puis-je utiliser plusieurs rôles de liste blanche ?
Oui. L'accès est accordé si l'utilisateur a n'importe lequel des rôles répertoriés.

Puis-je refuser catégoriquement certains rôles ?
Oui. Ajoutez-les à rôles de liste noire.

Cela a cessé de fonctionner après avoir changé de rôle.
Inférieur cacheMaxTime, puis testez à nouveau. Assurez-vous que le bot est en ligne avec le bon jeton et la bonne guilde.

Existe-t-il une version maintenue ?
Oui. Une édition commerciale, activement maintenue, existe si vous avez besoin de mises à jour/d'assistance.

---

Annexe — Exemple serveur.cfg

# La liste blanche Discord garantit DiscordWhitelist # (facultatif) placez les ressources Discord associées ici sous forme de bloc # assurez-vous que discord_perms # garantit discordrolesync

Annexe — Exemple de message de joueur (reports)

Gardez les messages courts et exploitables :

messages : { noDiscord : « Ouvrez Discord et rejoignez-le. Votre application Discord doit être active. », notWhitelisted : « Non sur liste blanche. Postulez via #how-to-whitelist → discord.gg/yourinvite », blacklisted : « Accès refusé. Contactez l'équipe via un ticket. », welcome : « Vérifié — chargement de la ville… » }

---

Journal des modifications (rédaction)

• v1.1 — Ajout de liens internes naturels vers les niveaux de don, le guide complet de la liste blanche FiveM et le téléchargement GitHub.
• v1.0 — Guide initial : création de bot, intentions, identifiants, installation, configuration, tests, FAQ.