Économisez 20 % avec WELCOMEVoir les promotions
Comment connecter txAdmin à Discord (Guide 2025)

Comment connecter txAdmin à Discord : Statut et liste blanche

Ce que fait l'intégration de Discord de txAdmin

txAdmin est inclus avec les builds actuels de FXServer et son intégration native Discord peut maintenir un statut embed et supporter la whitelist des membres ou rôles Discord. Créez une application Discord dédiée, accordez uniquement les permissions dont le canal de statut a besoin, stockez le token du bot uniquement dans txAdmin, et testez l'intégration dans un guild ou canal de test non-production en premier.

  • Ne jamais coller le jeton du bot dans le chat, les captures d'écran, les tickets ou serveur.cfg.
  • Ne pas accorder la permission d'Administrateur Discord lorsque les permissions de niveau canal Vue, Envoyer, Intégrer et Historique sont suffisantes.
  • Si les étiquettes du portail diffèrent de ce guide, suivez la documentation officielle actuelle de txAdmin Installation page et les fonctionnalités actuelles de txAdmin Paramètres → Discord champs.
  • Faites tourner le jeton immédiatement s'il est exposé, puis mettez à jour txAdmin et retestez l'intégration du statut.

But: Activez l'intégration Discord native de txAdmin pour les intégrations de statut et (facultative) la liste blanche soutenue par Discord.

Fonctionne avec n'importe quelle version FXServer qui inclut txAdminAucun hébergement tiers ni framework de bot requis.

Prérequis

  • Un serveur FiveM en cours d'exécution avec txAdmin activé (Paramètres → Global indique que le panneau est actif).
  • Autorisation de créer une application Discord dans votre Portail des développeurs Discord.
  • Mode développeur activé dans vos paramètres utilisateur Discord (afin que vous puissiez copier les ID de serveur/canal/rôle).
  • Le ID de guilde (serveur) et (éventuellement) un ID de la chaîne où le bot est autorisé à publier.

Étape 1 — Créer l'application Discord et le bot

  1. Ouvrir le Portail des développeurs Discord et cliquez Nouvelle application.
  2. Dans l'application, accédez à Bot → Jeton de réinitialisation et copiez le Jeton de botGardez-le secret.
  3. Sur le même Bot page, activer INTENTION DES MEMBRES DU SERVEUR. Sauvegarder.

Conseil : vous n’avez pas besoin des intentions Présence ou Contenu du message pour les fonctionnalités intégrées de txAdmin.

Étape 2 — Invitez le bot sur votre serveur Discord

  1. Dans le portail du développeur Discord, ouvrez Installation. Configurez un lien d'installation de serveur là-bas ; les anciennes dispositions de portail peuvent afficher l'URL équivalente du OAuth2 Générateur d'URL.
  2. Portées : sélectionner robot et applications.commandes (commandes slash).
  3. Autorisations : sélectionner Voir les chaînes, Envoyer des messages, Intégrer des liens, Lire l'historique des messages.
  4. Utilisez le lien d'installation pour ajouter l'application à un serveur de test Discord en premier, confirmez les scopes et permissions demandés, et seulement alors installez-le dans le guild de production.

Limitez les autorisations. Le bot n'a besoin que de lire, publier et intégrer.

Étape 3 — Connecter le bot dans txAdmin

  1. Ouvrez votre txAdmin panneau Web.
  2. Aller à Paramètres → Discord.
  3. Basculer Activer le bot Discord.
  4. Remplissez les champs :
    • Jeton de bot : collez le jeton de l'étape 1.
    • ID de guilde : votre identifiant de serveur Discord (clic droit sur l'icône du serveur → Copier l'identifiant).
    • ID du canal d'annonces (facultatif) : un identifiant de canal où txAdmin peut publier des avis d'état/de redémarrage.
  5. Sauvegarder.

Ajouter l'intégration du statut en direct

  • Dans le canal Discord de votre choix, saisissez : /statut ajouter
  • txAdmin publiera un intégration persistante qui se met à jour automatiquement avec les informations du serveur.

Personnaliser l'intégration du statut (facultatif)

  • Dans txAdmin → Paramètres → Discord, ouvrir Modifier l'intégration JSON pour éditer le titre, la description, les champs, la vignette, les boutons/liens, etc.

Étape 4 — (Facultatif) Liste blanche Discord dans txAdmin

Vous pouvez contrôler l'accès au serveur par adhésion ou par rôle Discord.

  1. Dans txAdmin, accédez à Paramètres → Gestionnaire de joueurs.
  2. Mode liste blanche : choisissez l'un des éléments suivants :
    • Membre Discord – n’importe qui dans votre Discord peut se joindre.
    • Rôle Discord – seuls les membres avec des identifiants de rôle spécifiés peuvent rejoindre.
  3. Si vous utilisez Rôle Discord, collecter les ID de rôle (Paramètres du serveur → Rôles → clic droit sur le rôle → Copier l'ID).
  4. Ajoutez les ID de rôle aux paramètres de la liste blanche. Sauvegarder.

Approuver/Gérer les demandes :

  • Aller à Gestionnaire de joueurs → Liste blanche pour examiner les demandes et les approbations.

Privilégiez les listes blanches basées sur les rôles pour un meilleur contrôle. Adaptez votre processus d'attribution de rôles Discord en conséquence.

Dépannage

  • L'enregistrement des paramètres Discord expire → Assurer INTENTION DES MEMBRES DU SERVEUR est activé pour votre bot dans le portail des développeurs Discord.
  • Les commandes slash (/status, /info) n'apparaissent pas → Réinviter le bot avec le applications.commandes portée ; assurez-vous qu'il peut voir la chaîne.
  • Le statut ne publie/met pas à jour → Vérifier les autorisations du canal : le bot a besoin Voir la chaîne, Envoyer des messages, Intégrer des liens, Lire l'historique des messages.
  • Aucun message de txAdmin → Vérifiez à nouveau le ID de guilde/ID de canal valeurs et que le mode développeur est activé lors de la copie des identifiants.
  • Bruit dans le canal d'annonces → Quitter ID du canal d'annonces vide dans Paramètres → Discord (txAdmin ne publiera pas automatiquement d'annonces).

Notes de sécurité

  • Traiter le Jeton de bot comme un mot de passe. Changez-le s'il est exposé.
  • Évitez d’accorder des autorisations d’administrateur ou des autorisations inutiles.
  • Limitez le bot à un seul canal de publication lorsque cela est possible.

Guides et ressources connexes

Liste de contrôle rapide (copier/coller)

  • Bot créé ; INTENTION DES MEMBRES DU SERVEUR activé
  • Bot invité avec bot + applications.commandes lunettes de visée
  • Autorisations : Afficher, Envoyer, Intégrer, Lire l'historique
  • Jeton de bot + ID de guilde (et facultatif ID de la chaîne) enregistré dans txAdmin
  • /statut ajouter exécuter dans le canal cible
  • (Facultatif) Mode liste blanche défini sur Membre/Rôle Discord ; identifiants de rôle enregistrés

Liste de contrôle pratique

Utilisez ce guide comme liste de vérification avant de modifier un serveur FiveM en production. Assurez-vous de la version actuelle des artefacts serveur, de la version du framework, des dépendances des ressources, des modifications de la base de données et des fichiers côté client avant d'appliquer la modification.

  • Sauvegardez les fichiers de configuration et les tables de base de données concernés.
  • Appliquez d'abord la modification sur un serveur de test.
  • Surveillez la console du serveur et la console F8 du client pour détecter les erreurs.
  • Vérifiez si la modification affecte les emplois, l'inventaire, les véhicules, les cartes, la voix, les autorisations ou les données des joueurs.
  • Documentez précisément le fichier, la commande ou le paramètre que vous avez modifié afin de pouvoir le rétablir rapidement.

Tests avant production

Après le premier test, connectez-vous avec un compte joueur standard et répétez le processus du point de vue du joueur. Si le sujet concerne les performances, effectuez des mesures avant et après en conservant le même nombre de joueurs, le même parcours et les mêmes ressources. Si le sujet concerne les outils d'administration ou les permissions, vérifiez les utilisateurs autorisés et ceux qui n'y sont pas autorisés.

Erreurs courantes

La plupart des problèmes rencontrés avec FiveM proviennent de dépendances manquantes, d'un cache obsolète, de noms de dossiers incorrects, d'incompatibilités de frameworks ou d'une configuration copiée depuis un autre serveur. Évitez de modifier plusieurs systèmes simultanément ; effectuez une modification, testez-la, puis poursuivez.

Ressources connexes

Pour les ressources prêtes à la production, comparez les ressources payantes dans le Boutique FiveMX. Pour accéder à des ressources gratuites, consultez Scripts FiveM gratuits et tester chaque ressource avant de l'utiliser publiquement.

Notes de déploiement de la production

Avant d'utiliser ce guide sur un serveur FiveM en direct, définissez le résultat exact que vous attendez du changement. Pour Comment connecter txAdmin à Discord, cela signifie vérifier quelle ressource, quel paramètre, quelle commande ou quel flux de travail est affecté et confirmer que le changement s'intègre dans votre cadre actuel, votre version d'artefact et vos règles de serveur. Gardez le déploiement suffisamment petit pour pouvoir l'inverser rapidement si les joueurs signalent des erreurs.

Utilisez un serveur de test avec la même infrastructure, le même schéma de base de données, le même ordre de ressources et les mêmes dépendances clés que le serveur de production. Si le sujet abordé modifie le gameplay, les permissions, les graphismes, le doublage, les véhicules, les cartes, l'inventaire ou le comportement économique, effectuez des tests avec au moins un compte administrateur et un compte joueur. Surveillez la sortie de la console du serveur, les journaux F8 du client et le temps d'accès aux ressources tout en reproduisant exactement le parcours de jeu qui se déroulera sur le serveur de production.

Liste de contrôle de restauration

  • Sauvegardez le fichier de configuration précédent, le dossier de ressources et l'état de la base de données avant toute modification.
  • Notez la version de la ressource, le commit, la page de téléchargement ou la valeur du paramètre que vous avez testée.
  • Redémarrez d'abord uniquement la ressource concernée lorsque cela est possible, puis redémarrez le serveur complet si des dépendances l'exigent.
  • En cas d'erreur, rétablissez la ressource ou le paramètre modifié avant de tester une autre solution.

Conseils d'entretien

Revérifiez cette configuration après chaque mise à jour des artefacts FiveM, du framework ou modification importante des ressources. Une configuration fonctionnelle aujourd'hui peut devenir inutilisable suite à des mises à jour de dépendances, des modifications d'exports, des changements d'événements ou des migrations de base de données. Conservez des notes dans la documentation de votre serveur afin que les futurs administrateurs comprennent les modifications apportées, leurs raisons et comment les reproduire.

Examen en cours

Revérifiez comment connecter txAdmin à Discord après les mises à jour majeures des artefacts FiveM, les changements de framework ou les migrations de ressources. Confirmez que les conseils correspondent toujours au comportement actuel du serveur, que toute source liée reste disponible et que les étapes d'installation correspondent toujours aux fichiers qu'un propriétaire de serveur téléchargera ou configurera réellement.

Pour les serveurs publics, conservez un bref historique des modifications à côté de la documentation du serveur. Indiquez ce qui a été testé, ce qui a changé, les comptes utilisés pour la vérification et la procédure de retour en arrière. Cela facilitera la maintenance future et évitera que les anciennes notes de configuration ne deviennent obscures ou dangereuses pour les joueurs.

Références officielles et vérification finale

Le documentation officielle de txAdmin liste son statut d'intégration Discord et les fonctionnalités de liste blanche. Discord guide d'installation de l'application et Référence OAuth2 et autorisations expliquer les liens d'installation actuels, les portées, les autorisations du bot et la gestion des jetons.

Après avoir sauvegardé les paramètres Discord de txAdmin, vérifiez que le bot apparaît uniquement dans le guild prévu, que l'embed de statut se met à jour, qu'un membre normal ne peut pas exécuter d'actions d'administration, qu'un rôle autorisé passe la whitelist optionnelle, et qu'un rôle refusé reste bloqué.