Installation & premier démarrage
Le parcours recommandé est simple : ajouter le bot, vérifier sa position dans la hiérarchie Discord, se connecter au dashboard, puis activer seulement les modules utiles.
Discord & permissions
Une grande partie des erreurs d’un bot Discord viennent de la hiérarchie ou des permissions, pas du code.
| Action | Permission Discord habituelle | Point à vérifier |
|---|---|---|
| Ban / kick | Ban Members / Kick Members | Le rôle du bot doit être au-dessus de la cible. |
| Timeout / mute | Moderate Members | La cible ne doit pas être au-dessus du bot. |
| Rôles | Manage Roles | Le bot ne peut gérer que les rôles placés sous son rôle. |
| Salons / logs | View Channel + Send Messages | Vérifier les permissions du salon et des catégories. |
| Webhooks / notifications | Selon le module | La permission doit exister dans le salon cible. |
Dashboard
Le dashboard canonique est /app. La landing publique et la documentation ne remplacent jamais cette interface.
Choisissez un serveur où votre compte possède les droits nécessaires.
Chaque serveur possède sa propre configuration.
Les pages qui modifient une configuration indiquent quand une action doit être sauvegardée.
Le dashboard ne contourne pas les permissions Discord du membre connecté.
Modération
SentriX regroupe les actions staff courantes : avertissement, timeout, unmute, kick, ban et autres outils exposés par la surface de commandes.
Les commandes peuvent exister en préfixe et en slash selon la surface active. Consultez /commands pour l’état réel.
Donnez une raison claire et une durée valide pour les sanctions temporaires.
Selon l’action, SentriX peut prévenir le membre et conserver une trace staff.
Configurez les logs de modération pour garder le contexte de chaque action.
Sécurité & AutoMod
Les protections automatiques complètent la modération manuelle. Elles doivent être adaptées au serveur afin d’éviter les faux positifs.
Détecte les répétitions ou volumes anormaux selon la configuration.
Filtre les liens selon les règles et listes autorisées configurées.
Surveille certains comportements sensibles et changements rapides.
Les permissions et la hiérarchie sont vérifiées avant les actions sensibles.
Tickets
Le système de tickets permet de créer des panneaux, types de demandes, formulaires et flux staff.
Logs
Les logs donnent au staff une trace des événements importants. Une catégorie peut être routée vers un salon précis.
Sanctions, timeout, unmute et actions staff.
Événements de messages, arrivées, départs et changements utiles.
Salons, rôles, vocal, ressources et autres catégories prises en charge.
Le bot doit voir le salon et pouvoir y envoyer des messages.
Rôles
SentriX peut automatiser l’attribution de rôles et proposer des interactions de rôle selon les modules activés.
Bienvenue & départs
Configurez les messages d’arrivée et de départ, leur salon et leur présentation. Testez le rendu avant de l’activer pour tous les membres.
Niveaux
Le système de niveaux suit la progression communautaire lorsque le module est activé.
La progression dépend des règles actives sur le serveur.
Les membres peuvent comparer leur progression via les surfaces prévues.
Des rôles ou avantages peuvent être liés à certains niveaux.
Désactiver un système ne doit pas supprimer arbitrairement les données persistantes prévues.
Économie
Le module économie peut gérer monnaie, portefeuille, banque, récompenses, boutique de rôles et activités.
Nom, pluriel et symbole sont configurables.
Dépôt et retrait utilisent les règles du serveur.
Prix, stock, promotions et rôles peuvent être configurés.
Les systèmes automatiques doivent limiter les abus sans bloquer l’usage normal.
Jeux
SentriX inclut plusieurs activités communautaires reliées aux systèmes de progression ou d’économie lorsqu’ils sont configurés.
Musique
Le module musique peut rejoindre un salon vocal, gérer une file et travailler avec des playlists selon les fournisseurs actifs.
Notifications
Les intégrations de notification publient les nouvelles activités des sources configurées, dans les salons et avec les mentions autorisées.
Automatisations
Les automatisations réduisent les tâches répétitives du staff.
Ajout d’emojis selon des mots-clés ou règles.
Mise en avant des messages selon les réactions.
Publication planifiée ou maintien d’un message important.
Création et gestion de salons vocaux liés à un hub.
IA & langage naturel
L’assistant SentriX peut comprendre certaines demandes naturelles et les relier à des actions ou à la documentation. Les permissions restent obligatoires.
Une demande comme une sanction doit vérifier les permissions avant exécution.
L’assistant peut orienter vers setup, help, dashboard ou une section de configuration.
Les actions sensibles doivent rester explicites et vérifiables.
L’IA ne doit pas inventer une commande ou contourner les règles Discord.
Dépannage
Commencez toujours par identifier si le problème vient de Discord, du dashboard, d’une permission ou du bot.
Commandes slash et préfixe
SentriX répond aux deux formes. Les commandes slash s’écrivent avec / et sont proposées par Discord ; les commandes préfixées s’écrivent avec + dans un message normal.
Autocomplétion Discord, arguments guidés, visibles par tout le monde dans la barre de saisie.
SentriX fonctionne uniquement avec les commandes / : tapez / dans Discord pour les voir.
Une commande disponible sous les deux formes exécute le même code et applique les mêmes permissions.
/help dans Discord, ou la page Commandes qui lit les commandes réellement chargées.
Permissions, OAuth et hiérarchie
La plupart des refus viennent de Discord, pas de SentriX. Deux mécanismes distincts se cumulent.
Côté Discord
SentriX ne peut agir que dans la limite de ses propres permissions, et seulement sur les membres dont le rôle le plus haut est en dessous du sien. Un membre placé plus haut dans la liste des rôles ne peut être ni banni, ni expulsé, ni réduit au silence, quelle que soit la configuration.
+permissions explique ce qui manque dans un cas précis.Côté dashboard
La connexion au dashboard passe par Discord OAuth : /login redirige vers Discord, Discord renvoie vers /oauth/callback, et la session ouverte donne accès à /app. SentriX ne voit que les serveurs que Discord accepte de lui communiquer pour votre compte, et n’affiche que ceux où vous disposez des droits d’administration.
Questions fréquentes
Les réponses ci-dessous décrivent le fonctionnement réel, pas une intention.
Et les commandes avec « + » ?
Elles ont été supprimées : toutes les fonctions sont disponibles en commandes /.
Pourquoi une commande n’apparaît-elle pas ?
Soit elle est réservée à un rôle ou au propriétaire, soit le module correspondant n’est pas activé sur le serveur. /help ne montre que ce qui vous est accessible.
Que se passe-t-il pendant un redémarrage ?
SentriX fonctionne sur deux instances dont une seule sert à la fois. Pendant une bascule, une page publique peut indiquer que ses données ne sont pas disponibles plutôt que d’afficher un chiffre faux.
Comment tout arrêter en urgence ?
/security panic coupe les actions sensibles immédiatement. /setup permet ensuite de revoir la configuration.
Support
Le centre de support rassemble les problèmes les plus fréquents, un diagnostic guidé et de quoi produire un rapport copiable à joindre à une demande.