Pour connecter txAdmin à Discord, créez une application et un bot Discord dédiés, invitez-le sur le bon serveur avec uniquement les autorisations dont il a besoin, copiez le jeton du bot dans les paramètres Discord de txAdmin et configurez les messages d'état et l'accès basé sur les rôles comme des fonctionnalités distinctes. Gardez le jeton confidentiel : il authentifie le bot et ne devrait jamais apparaître sur des captures d'écran, des fichiers clients ou un dépôt public.
Distinguez les quatre composants
| Partie | But | Échec typique |
|---|---|---|
| Application et bot Discord | Identité utilisée par txAdmin | Mauvaise application, bot désactivé ou jeton régénéré |
| Statut du serveur | Publie ou met à jour le statut dans un canal choisi | Mauvais canal ou permissions de vue/envoi/intégration manquantes |
| Rôles ou liste blanche | Mappe l'adhésion/les rôles Discord à la règle d'accès configurée | ID de serveur ou de rôle incorrect, hiérarchie des rôles ou exigence relative aux intents des membres |
| Permissions txAdmin | Contrôle qui peut administrer le serveur FiveM | Rôle Discord supposé pour accorder automatiquement les droits txAdmin |
Ne déboguez pas ces éléments comme une seule fonctionnalité. Prouvez d'abord que le bot est en ligne, puis prouvez qu'il peut accéder à un canal, puis ajoutez le comportement de statut, et seulement ensuite testez la logique optionnelle de rôle ou de liste blanche.
Étape 1 : créez une application Discord dédiée
- Ouvrez le portail des développeurs Discord et créez une nouvelle application pour ce serveur.
- Ajoutez un bot à l'application.
- Donnez-lui un nom clair afin que le personnel puisse distinguer la production de la pré-production.
- Générez ou réinitialisez le jeton uniquement lorsque vous êtes prêt à le stocker en toute sécurité.
Un jeton de bot est un secret, pas un ID d'application ou une clé publique. S'il est exposé, réinitialisez-le dans Discord et mettez à jour txAdmin immédiatement. Ne stockez le remplacement que dans le paramètre côté serveur destiné au jeton.
Étape 2 : invitez le bot avec des autorisations minimales
Utilisez le flux d'installation OAuth2 de Discord pour l'application et sélectionnez la portée du bot requise par la configuration actuelle. Commencez avec les permissions de canal les plus petites qui satisfont la fonctionnalité : afficher le canal sélectionné, envoyer des messages, intégrer des liens et lire l'historique des messages là où la mise à jour du statut en a besoin. Évitez Administrateur à moins que l'intégration officielle ne l'exige explicitement et que vous ayez examiné pourquoi.
Restreignez le bot à un canal de statut ou d'administration dédié lorsque cela est pratique. Après l'avoir invité, confirmez qu'il apparaît dans le serveur Discord prévu. Être répertorié comme hors ligne est normal jusqu'à ce que txAdmin se connecte avec succès avec le jeton.
Étape 3 : configurez le bot dans txAdmin
Ouvrez txAdmin en tant qu'administrateur autorisé et localisez les paramètres d'intégration Discord dans votre version installée. Collez le jeton dans le champ du jeton sans guillemets ni espaces supplémentaires. Sélectionnez le serveur et le canal Discord prévus à l'aide des entrées fournies par txAdmin. Enregistrez, puis redémarrez uniquement le composant ou le serveur si l'interface le demande.
Si vous construisez le côté FiveM à partir de zéro, utilisez le chemin de configuration du serveur FiveM premièrement. Discord ne peut pas réparer un FXServer défectueux ou une instance txAdmin inaccessible.
Configurez les messages de statut séparément
Activez la fonction de statut et sélectionnez un canal où le bot peut publier. Commencez par une simple mise à jour de test avant d'ajouter une formulation ou des intégrations personnalisées. Confirmez que le message change lorsque le serveur FiveM démarre, s'arrête ou modifie le nombre de joueurs conformément au comportement documenté par votre version txAdmin.
Si le bot se connecte mais qu'aucun statut n'apparaît, vérifiez l'ID du canal sélectionné et les remplacements spécifiques au canal. Un rôle à l'échelle du serveur peut autoriser l'envoi tandis qu'un remplacement de canal le refuse. Inspectez également la sortie console/journal de txAdmin pour la réponse de l'API Discord plutôt que de régénérer le jeton à plusieurs reprises.
Configurez les rôles ou les règles de liste blanche séparément
L'accès basé sur les rôles nécessite les identifiants exacts du serveur et du rôle Discord attendus par l'intégration. Activez le mode développeur de Discord pour copier les identifiants lorsque la configuration actuelle les demande. Les noms de rôles ne sont pas des identifiants stables et deux rôles peuvent partager un nom similaire.
Testez avec un compte qui a le rôle requis et un autre qui ne l'a pas. Supprimez et rajoutez le rôle, reconnectez-vous et confirmez lorsque l'intégration actualise l'adhésion. Ne supposez pas qu'un rôle Discord accorde automatiquement les autorisations d'administrateur txAdmin ; le modèle d'autorisation propre à txAdmin reste un contrôle distinct, à moins que la fonctionnalité documentée ne les mappe explicitement.
Protégez le jeton et la limite d'autorisation
- Ne collez jamais le jeton dans le chat Discord, un ticket de support visible par d'autres ou une ressource côté client.
- Ne l'enregistrez pas dans Git ni dans une capture d'écran publique.
- Limitez l'accès à l'application du portail des développeurs Discord et aux paramètres txAdmin.
- Réinitialisez le jeton après exposition ou lorsqu'un administrateur ayant accès part.
- Vérifiez régulièrement les autorisations du bot sur le serveur et les canaux.
Liste de contrôle de dépannage
| Symptôme | Vérifier |
|---|---|
| Le bot reste hors ligne | Le jeton appartient au bon bot, ne contient pas d'espaces, n'a pas été réinitialisé, et les journaux txAdmin montrent une tentative de connexion |
| Le bot est en ligne mais ne peut pas publier | Canal sélectionné, autorisations d'affichage/envoi/intégration et remplacements de canal |
| Le statut ne se met jamais à jour | Fonctionnalité de statut activée, canal correct, état txAdmin/FXServer et journal d'intégration |
| Le membre du rôle est rejeté | ID de serveur et de rôle correct, rôle effectivement attribué, comportement d'actualisation et de reconnexion, et tout intent relatif aux membres requis |
| Le membre non autorisé est accepté | Règles d'accès de secours, plusieurs rôles autorisés et configuration des autorisations côté serveur |
| Cela s'est arrêté après une réinitialisation de jeton | txAdmin a toujours l'ancien jeton ; enregistrez le nouveau et redémarrez si nécessaire |
Vérification finale
- Le bot se connecte après un redémarrage propre sans erreurs de jeton.
- Le statut ne s'affiche que dans le canal prévu.
- Le rôle minimum du bot peut mettre à jour le message sans privilèges de serveur plus larges.
- L'utilisateur de test autorisé passe la règle de rôle/liste blanche.
- L'utilisateur de test non autorisé échoue à la même règle.
- Ni l'accès Discord ni un bouton d'interface utilisateur caché ne contournent les propres autorisations d'administrateur de txAdmin.
Une fois que ces vérifications passent indépendamment, l'intégration est plus facile à maintenir : une identité de bot, un secret protégé, un accès au canal étroitement défini et des règles explicites pour le statut, la liste blanche et l'administration.
Documentation de référence
Cfx.re — txAdmin · Source : docs.discord.com · Source : docs.discord.com