Économisez 20 % avec WELCOMEVoir les promotions
Comment configurer une liste blanche Discord pour votre serveur FiveM (…

Comment configurer une liste blanche Discord pour votre serveur FiveM (…

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 la whitelist Discord — exemple
const config = {
 botToken: "PASTE_YOUR_DISCORD_BOT_TOKEN_HERE",
 guildId: "123456789012345678", \/\/ Votre ID de serveur (guild)

 \/\/ Les joueurs doivent avoir au moins UN de ces IDs de rôle pour rejoindre
 whitelistRoles: [
 "111111111111111111", \/\/ Whitelisté
 \/\/ "222222222222222222", \/\/ Staff (optionnel)
 ],

 \/\/ Si un joueur a N'IMPORTE LEQUEL de ces rôles, rejeter la connexion
 blacklistRoles: [
 \/\/ "333333333333333333", \/\/ Banni
 ],

 \/\/ Mettre en cache les données de rôle récupérées pour réduire les appels API Discord (secondes)
 cacheMaxTime: 90,

 \/\/ Messages de report
 messages: {
 noDiscord: "Ouvrez Discord et reconnectez-vous. Votre application Discord doit être en cours d'exécution.",
 notWhitelisted: "Vous n'êtes pas whitelisté. Rejoignez notre Discord : discord.gg\/yourinvite",
 blacklisted: "Accès refusé. Veuillez contacter le staff.",
 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 vérifier l'accès des 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 reconnectez-vous. Votre application Discord doit être en cours d'exécution.",
 notWhitelisted: "Non whitelisté. Postulez dans #how-to-whitelist → discord.gg\/yourinvite",
 blacklisted: "Accès refusé. Contactez le staff 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.