KB SCRIPTS Aide à la configuration du serveur

GUIDE D’ADMINISTRATION · DISCORD

KB Hub.

Guide de configuration destiné aux propriétaires et administrateurs de serveurs Discord. Il couvre les réglages du serveur, les tickets, la modération, les protections, les outils communautaires et la gestion des liens associés aux membres.

Propriétaires et administrateurs Commandes slash Discord Mis à jour · octobre 2026
01

Qui peut gérer le bot ?

Les droits sont séparés entre configuration du serveur et gestion quotidienne des tickets.

Propriétaire du serveur

Peut configurer le serveur et gérer les tickets. Certaines commandes exigent aussi une permission Discord précise ; les vérifications propres à chaque module restent appliquées.

Administrateur · Gérer le serveur

Peut utiliser les commandes des modules qui autorisent la permission Discord Gérer le serveur. Les permissions varient selon la commande et ne sont pas remplacées par les rôles de support.

Rôle de configuration

Pour les tickets, peut gérer les salons, catégories, rôles de support, journaux et options autorisés. Ne peut pas déléguer ou retirer l’accès à la configuration.

Rôle de support

Peut accéder aux tickets et utiliser les actions de support. Il ne peut pas modifier la configuration du bot, sauf s’il possède aussi un rôle de configuration.

Au premier lancement : seul le propriétaire du serveur peut configurer le bot. Il peut ensuite autoriser certains rôles pour les réglages des tickets. Les autorisations des autres modules sont indiquées dans leurs sections.
02

Avant de configurer

Prépare les rôles et salons Discord d’abord ; les commandes du bot servent ensuite à les relier aux modules.

Rôles séparés

Prévois des rôles distincts pour l’administration, la configuration des tickets, le support, la modération et, si nécessaire, la quarantaine. N’accorde que les permissions utiles.

Salons privés

Crée des salons réservés au staff pour les tickets fermés, les rapports de modération, les signalements et les alertes de sécurité. Vérifie leurs permissions Discord avant de les sélectionner.

Ordre des rôles

Dans les paramètres du serveur, place le rôle du bot au-dessus des rôles qu’il doit attribuer ou gérer. Le bot ne peut pas agir sur des rôles au-dessus du sien.

Vérifier l’état

Utilise /tickets config show pour vérifier les réglages des tickets et /protection etat pour consulter les protections.

Les réglages sont propres à chaque serveur. Les commandes ne changent pas les permissions Discord à ta place, sauf lorsqu’une action précise le fait (par exemple attribuer un rôle ou verrouiller un salon).
03

Démarrage et panneau

Le panneau permet aux membres de choisir le type de demande et d’ouvrir un ticket privé.

/tickets config panel-channel salon

Choisir le salon textuel où le panneau sera publié.

/tickets panel [salon]

Publier ou republier le panneau. Le salon est facultatif : celui configuré est utilisé par défaut.

/settickets [salon]

Ancienne commande de compatibilité pour publier le panneau ; utilise les mêmes autorisations.

/tickets config show

Afficher les salons, réglages, rôles et nombre de catégories configurés sur le serveur.

04

Personnaliser l’apparence

Le titre, le pied de page et la couleur des embeds sont enregistrés séparément sur chaque serveur.

/tickets config panel-title titre

Modifier le titre du panneau déjà publié.

/tickets config panel-title-reset

Rétablir le titre automatique du panneau.

/tickets config panel-footer texte

Définir le pied de page commun aux embeds du bot sur ce serveur.

/tickets config panel-footer-reset

Rétablir le pied de page par défaut.

/tickets config embed-color hex

Choisir une couleur hexadécimale pour les embeds, par exemple #5865F2.

/tickets config embed-color-reset

Rétablir la couleur rouge par défaut.

/tickets config embed-create [salon]

Ouvrir l’assistant de création d’un embed personnalisé (titre, description, image importée et couleur). Si aucun salon n’est indiqué, l’embed est publié dans le salon courant.

À noter : le titre, le pied de page et la couleur configurés ici concernent les panneaux et embeds du bot sur ton serveur.
05

Configuration générale

Choisir où les tickets sont rangés, où les événements sont consignés et comment ils se ferment.

/tickets config ticket-parent salon

Placer les tickets dans une catégorie Discord générale.

/tickets config ticket-parent-clear

Retirer la catégorie générale. Les catégories propres aux types de tickets ou la création automatique s’appliqueront.

/tickets config ticket-logs salon
/tickets config ticket-logs-clear

Définir ou désactiver le salon de logs de tickets.

/tickets config member-logs salon
/tickets config member-logs-clear

Définir ou désactiver les logs d’arrivée et de départ des membres.

/tickets config max-open-tickets limite

Limiter les tickets ouverts par membre de 0 à 10. La valeur 0 signifie illimité.

/tickets config transcripts active

Activer ou désactiver les transcriptions automatiques à la fermeture. Un salon de logs de tickets doit être configuré pour les activer.

/tickets config reopen active

Activer ou désactiver la fermeture en lecture seule avec possibilité de réouverture par le support.

Si la réouverture est désactivée, la fermeture supprime le salon du ticket après un court délai. Les limites de tickets, transcriptions automatiques et réouverture sont désactivées par défaut.
06

Catégories de tickets

Chaque entrée correspond à un choix dans le panneau : par exemple facturation, assistance ou signalement.

/tickets categories list

Afficher les catégories, leurs IDs, leurs préfixes, leur emplacement et leur rôle spécifique.

/tickets categories add label description [emoji] [prefix] [support-role] [parent]

Ajouter une catégorie au panneau. L’emoji, le préfixe, le rôle et la catégorie Discord sont facultatifs.

/tickets categories edit id [label] [description] [emoji] [prefix]

Modifier les informations affichées ou le préfixe d’une catégorie. Indiquer au moins un champ.

/tickets categories move id position

Modifier l’ordre des choix dans le panneau ; la position 1 place la catégorie en premier.

/tickets categories remove id

Retirer une catégorie de la configuration du menu.

/tickets categories parent-set id salon
/tickets categories parent-clear id

Définir ou retirer la catégorie Discord utilisée pour ce type de tickets.

/tickets categories support-set id role
/tickets categories support-clear id

Ajouter ou retirer un rôle de support spécifique à cette catégorie.

Nom des salons

Un ticket suit la forme prefix-utilisateur. Exemple : le préfixe facture produit facture-julie.

Catégories Discord automatiques

Sans catégorie Discord dédiée, le bot crée une catégorie privée pour les tickets. Après un déplacement, il supprime l’ancienne catégorie gérée si elle est vide. Une catégorie Discord choisie manuellement n’est pas supprimée automatiquement.

07

Gérer les rôles

Les rôles de configuration et les rôles de support ont des responsabilités différentes.

/tickets roles config-list

Afficher les rôles pouvant modifier la configuration.

/tickets roles config-add role
/tickets roles config-remove role

Autoriser un rôle à configurer le bot ou lui retirer cet accès. Réservé au propriétaire du serveur.

/tickets roles staff-list

Afficher les rôles de support généraux.

/tickets roles staff-add role
/tickets roles staff-remove role

Ajouter ou retirer un rôle pouvant voir et gérer les tickets.

08

Actions dans un ticket

Les boutons de gestion apparaissent dans les salons de tickets et sont réservés au propriétaire et au support autorisé.

  • Réclamer — signaler qu’un membre du support prend le ticket en charge.
  • Renommer — changer le nom du salon du ticket.
  • Fermer — terminer le ticket ; son comportement dépend du réglage de réouverture.
  • Supprimer — supprimer le salon du ticket.
  • Ajouter / retirer un utilisateur — modifier l’accès d’un membre à la conversation.
  • Changer de catégorie — déplacer le ticket, actualiser son préfixe, son nom et ses permissions.
  • Transcrire — créer une transcription à la demande et l’envoyer au salon privé des logs.
  • Réouvrir le ticket — disponible sur les tickets fermés si la réouverture est activée.
Lorsqu’un ticket change de catégorie, son nom est recalculé avec le préfixe de destination et le nom de son propriétaire, même si le salon avait été renommé auparavant.
09

Transcriptions et confidentialité

Les transcriptions sont accessibles avec un lien privé et sont envoyées dans le salon de logs du serveur concerné.

Contenu

La transcription HTML peut inclure les messages récupérables, leurs auteurs et dates, les rôles actuels, les embeds et les liens de pièces jointes.

Accès au lien

Le lien est un secret d’accès : toute personne qui le possède peut consulter la transcription correspondante. Partage-le uniquement avec les personnes autorisées.

Salon privé requis

Le salon de logs doit être accessible au bot et privé vis-à-vis de @everyone pour recevoir les liens de transcription.

Expiration et suppression

Les transcriptions expirent automatiquement après trois jours. Leur page permet également de télécharger ou supprimer la transcription.

10

Protections automatiques

Configure les seuils par module, puis choisis séparément si l’auto-modération doit observer ou agir.

Démarrage prudent : lance /protection demarrer salon-alertes:#salon-prive, puis vérifie les résultats avant de choisir une sanction avec /protection action. Le mode observation ne supprime pas les messages et n’applique pas de sanctions automatiques. Les actions de l’anti-mentions et de l’anti-raid sont distinctes et peuvent avoir leurs propres réglages déjà actifs.
/protection etat

Afficher l’état de l’auto-modération, les seuils, les journaux, les réglages anti-raid/anti-mentions/anti-nuke et l’état du honeypot.

/protection demarrer [salon-alertes]

Activer l’auto-modération en observation avec les seuils recommandés. Si elle était déjà configurée, ses seuils existants sont conservés. Cette commande ne change pas les réglages séparés d’anti-raid, d’anti-mentions, d’anti-nuke, de quarantaine ou d’urgence. Le salon d’alertes est facultatif.

/protection spam niveau:leger|equilibre|strict

Seuil anti-flood : 10, 6 ou 4 messages dans une fenêtre de 10 secondes. Un seuil strict détecte plus vite, mais peut augmenter les fausses alertes.

/protection messages niveau:leger|equilibre|strict

Règle à la fois les répétitions identiques et le débit des nouveaux membres : léger (5 répétitions ; plus de 8 messages/10 min), équilibré (3 ; plus de 3/10 min), strict (2 ; plus de 2/15 min).

/protection mentions niveau:desactive|leger|equilibre|strict

Seuil de 0, 8, 5 ou 3 mentions par message. Le mode déjà configuré (observation ou suppression) est conservé. Vérifie ce mode avant d’abaisser le seuil.

/protection raid niveau:desactive|leger|equilibre|strict

Alerte à 0, 10, 5 ou 3 arrivées sur une minute. Si une quarantaine est déjà configurée, le bot peut attribuer ce rôle aux membres concernés dès que le seuil est atteint.

/protection nuke niveau:desactive|leger|equilibre|strict

Alerte à 0, 10, 5 ou 3 événements suivis par minute. La détection n’empêche ni ne restaure les changements.

/protection action mode [minutes]

Définir l’action globale des déclenchements automod : observation, suppression, avertissement, timeout temporaire ou vérification par le staff. Le champ minutes ne sert qu’au timeout (1 à 1440 minutes). Les permissions Discord du bot sont vérifiées.

/protection filtre type terme

Ajouter un mot, une expression, une invitation Discord ou un domaine à surveiller. Il faut ensuite que l’auto-modération soit active. Les filtres textuels exigent la disponibilité de l’intent Message Content.

Réglages détaillés et protections associées

/automod etat · activer · action · seuils

Afficher l’état, activer/désactiver le moteur sans effacer ses données, configurer l’action, ou régler précisément les seuils anti-flood, répétitions, mentions et nouveaux membres.

/automod salon-logs salon
/automod regle-ajouter · regles · regle-retirer

Configurer le salon des déclenchements et gérer les filtres de contenu. L’historique conserve le motif et un hash du message, pas son contenu original.

/automod exception-ajouter · exception-retirer
/automod historique · faux-positif

Exempter un rôle, un salon ou une catégorie ; consulter les déclenchements et marquer un faux positif sans effacer l’historique.

/security config raid-threshold membres
/security config quarantine-role role
/security config quarantine-clear

Réglages détaillés du seuil de raid et du rôle de quarantaine. Le rôle seul ne bloque pas l’accès : configure ses permissions dans les salons Discord et vérifie que le bot peut l’attribuer.

/security config emergency active
/security config trust-add membre · trust-remove · trust-list

Le mode d’urgence surveille les prochaines arrivées et applique la quarantaine si un rôle est configuré. Les membres de confiance en sont exclus. L’urgence ne verrouille pas les salons.

/security config lockdown active confirmer categorie

Verrouiller ou restaurer les salons textuels. C’est une opération massive distincte, limitée éventuellement à une catégorie, qui exige une confirmation explicite.

/security config incidents
/security config destructive-threshold actions

Consulter les incidents et régler le seuil anti-nuke détaillé. Le bot alerte le staff, mais ne bloque ni ne restaure automatiquement les changements.

Message Content requis : pour analyser les mots, liens, répétitions, le flood et le débit des nouveaux membres, le bot doit recevoir le contenu des messages. Si l’état indique que cette analyse est inactive, demande au responsable du bot d’activer l’intent privilégié Message Content et son paramètre d’exécution. Ce réglage n’est pas disponible dans les commandes du serveur.
Honeypot à haut risque : /honeypot configurer salon-piege salon-logs active immédiatement le bannissement permanent des non-administrateurs qui écrivent dans le salon-piège. Configure-le uniquement si son rôle est parfaitement compris et si le salon porte un avertissement sans ambiguïté. Vérifie avec /honeypot etat et arrête les bannissements avec /honeypot desactiver.
11

Modération et dossiers

Les sanctions sont journalisées. Discord vérifie les permissions et la hiérarchie des rôles avant leur exécution.

/mod config role-add role · role-remove · role-list

Autoriser des rôles à consulter les dossiers de modération. Ce réglage ne donne pas les permissions Discord nécessaires pour appliquer des sanctions.

/mod config logs salon · logs-clear

Choisir ou désactiver le salon des journaux de modération. Prévois un salon accessible uniquement au staff.

/mod config escalade avertissements heures action [minutes]

Définir une escalade après plusieurs avertissements sur une période : revue staff, timeout ou expulsion. Seuil 0 = désactivé. Choisis avec prudence une action automatique et vérifie les permissions du bot.

/mod config escalade-role-add role · escalade-role-remove

Exclure ou réintégrer un rôle dans les règles d’escalade.

/mod warn · timeout · untimeout · kick · ban · tempban · unban

Appliquer une action manuelle à un membre. Motif obligatoire ; les bannissements demandent une confirmation. Le timeout accepte jusqu’à 28 jours et le bannissement temporaire jusqu’à 720 heures.

/mod history membre · case numero · revoke numero motif · note-add numero texte

Consulter l’historique et les dossiers, révoquer un avertissement ou ajouter une note interne.

/mod review numero decision motif · /mod stats [jours]

Clôturer une proposition d’escalade après examen humain et consulter les statistiques de modération.

Permissions habituelles : **Gérer les messages** pour avertir, **Modérer les membres** pour les timeouts, **Expulser des membres** pour expulser et **Bannir des membres** pour bannir/débannir. Le membre qui modère et le bot doivent respecter la hiérarchie des rôles Discord.
12

Signalements et journaux

Utilise des salons privés séparés si les personnes autorisées à consulter les dossiers ne sont pas les mêmes.

/reports config channel salon

Configurer le salon privé où sont publiés les signalements. Le salon est refusé si @everyone peut le voir ; donne au bot Voir le salon, Envoyer des messages, Intégrer des liens et Lire l’historique.

/reports list · view numero · assign numero [moderateur]

Parcourir les dossiers ouverts, consulter un dossier ou en attribuer la prise en charge.

/reports status numero etat motif · request-info numero question

Faire évoluer un dossier ou demander des précisions au signalant, qui pourra utiliser /report-complement.

/reports note numero texte · close numero motif

Ajouter une note interne ou clôturer un dossier avec un motif. Les notes sont visibles uniquement par le staff autorisé.

/logs config channel salon · show · clear

Configurer, vérifier ou désactiver le journal d’audit Discord. Le bot journalise notamment des événements de messages (sans leur contenu), salons, rôles et bannissements.

/logs config retention jours
/logs search jours [type] · /logs export jours [type]

Régler la conservation de 1 à 3650 jours, puis rechercher ou exporter en JSON les événements d’une période de 1 à 90 jours.

Les incidents de sécurité, les dossiers de sanctions et les événements d’audit sont des journaux différents : choisis le salon et les accès adaptés pour chacun. Le contenu des messages n’est pas conservé dans les événements d’auto-modération ni dans les changements de messages audités.
13

Accueil et vérification des membres

Les rôles ne modifient pas les permissions des salons automatiquement : configure leurs accès dans Discord.

/community config welcome-channel salon · welcome-message texte
/community config welcome-reset

Configurer le salon et le texte de bienvenue, ou désactiver le message. Variables : {user}, {username}, {server}, {memberCount}.

/community config goodbye-channel salon · goodbye-message texte · goodbye-reset

Configurer ou désactiver le message publié lors du départ d’un membre. Les mêmes variables sont disponibles.

/community config join-role role · join-role-clear

Attribuer ou arrêter d’attribuer un rôle d’accueil non privilégié aux nouveaux membres.

/community roles add role · remove role · list · publish salon

Gérer jusqu’à 25 rôles non privilégiés sélectionnables par les membres et publier leur menu. Retirer un rôle du menu ne le retire pas aux membres qui le possèdent déjà.

/community verification role role · rules texte · publish salon · clear

Configurer le rôle donné après acceptation du règlement, rédiger le texte et publier le panneau. clear désactive le panneau sans retirer les rôles déjà attribués.

/community temporary-role grant membre role heures · list · cancel numero

Attribuer un rôle non privilégié pour une durée de 1 à 720 heures, lister les attributions actives ou annuler une expiration. Annuler l’expiration ne retire pas le rôle déjà attribué.

/community reminder schedule salon date message · list · cancel numero

Programmer un rappel dans un salon entre une minute et un an à l’avance. La date future doit être au format ISO 8601 avec fuseau, par exemple AAAA-MM-JJTHH:MM:SS+HH:MM. Les mentions ne sont pas déclenchées automatiquement.

Les réglages de communauté sont réservés au propriétaire ou aux administrateurs ayant la permission **Gérer le serveur**. Les rôles attribués par le bot doivent rester non privilégiés et être placés sous le rôle du bot dans la hiérarchie Discord.
14

Rendez-vous et vocaux temporaires

Les rendez-vous publient des annonces et rappels ; les vocaux temporaires sont créés lorsqu’un membre rejoint un salon déclencheur.

/rdv programmer vocal annonces

Ouvrir l’assistant de rendez-vous. Choisis un vocal et un salon d’annonces, puis saisis le début en JJ/MM/AAAA HH:MM et la fin en HH:MM, heure de Paris. Sélectionne les membres/rôles destinataires et les rappels souhaités.

/rdv liste · /rdv annuler numero
/rdv config role-add role · role-remove role · role-list

Consulter ou annuler les rendez-vous et autoriser des rôles à les programmer. Les rôles destinataires doivent pouvoir être mentionnés, ou le bot doit avoir la permission correspondante dans le salon d’annonces.

/vocal-configurer salon_creation [salon_creation_2] [categorie] [salon_logs] [acces] [limite] [nom] [role_admin] [role_admin_2]

Configurer un ou deux salons déclencheurs, l’emplacement, le mode public/privé, la capacité, le modèle de nom et jusqu’à deux rôles administrateurs. Variables de nom : {user} et {username}. Capacité 0 = illimitée.

/vocal-gerer salon · /vocal-renommer salon nom
/vocal-acces salon · /vocal-supprimer salon

Ouvrir le panneau de gestion, renommer, régler la confidentialité/les accès ou supprimer un vocal temporaire. Le propriétaire du vocal peut gérer son propre salon ; la suppression demande une confirmation.

Un vocal temporaire vide est supprimé automatiquement. Le bot a besoin de **Gérer les salons** et **Déplacer les membres** ; place son rôle assez haut pour appliquer les permissions aux rôles concernés. Les rappels de rendez-vous nécessitent que le processus du bot fonctionne à l’heure prévue.
15

Automatisations et statistiques

Les automatisations disponibles sont volontairement limitées à l’envoi de messages prédéfinis.

/automation create nom declencheur salon message

Créer un message déclenché par une arrivée, un départ, une alerte de mentions ou un signal anti-raid. Variables disponibles : {user}, {username}, {server}, {channel}.

/automation list · toggle numero active · remove numero · history

Consulter, activer/désactiver, supprimer une règle ou consulter ses exécutions. Aucun code ou script personnalisé n’est exécuté.

/stats view jours · /stats export jours
/mod stats [jours]

Afficher ou exporter les statistiques disponibles sur 1 à 90 jours. Les données commencent à être collectées après activation du bot et ne reconstituent pas le passé.

16

Outils d’administration du serveur

Ces commandes aident à vérifier ou préparer des éléments Discord sans remplacer les paramètres du serveur.

/server-admin channel create nom type [categorie]
/server-admin channel edit salon [nom] [sujet] · channel check salon

Créer ou modifier un salon, ou inspecter les permissions effectives du bot dans un salon.

/server-admin role create nom [couleur] · role edit role [nom] [couleur] · role check role

Créer ou renommer un rôle non privilégié, régler sa couleur et inspecter ses permissions. Ces commandes ne donnent pas de permissions sensibles.

/server-admin snapshot save · list · compare numero · export numero

Créer un instantané logique des salons et rôles, le lister, le comparer à l’état actuel ou l’exporter en JSON privé.

/server-admin snapshot restore numero appliquer:false
/server-admin snapshot restore numero appliquer:true

Prévisualiser, puis confirmer une restauration non destructive. Elle ne supprime aucun élément et ne restaure ni les messages ni les permissions/overwrites Discord ; examine la comparaison avant confirmation.

17

Enregistre plusieurs adresses nommées sur la fiche d’un membre pour les retrouver depuis Discord ou le panel.

/ajouterlien utilisateur lien nom

Associer au membre choisi une URL HTTP ou HTTPS et un nom facile à reconnaître. Chaque membre peut avoir jusqu’à 25 liens par serveur.

/voirliens utilisateur

Afficher les liens enregistrés pour ce membre, avec leur nom, leur ID et leur adresse.

/modifierlien utilisateur

Choisir un lien dans la liste, puis modifier son nom et son adresse.

/supprimerlien utilisateur id_ou_nom

Supprimer un lien en indiquant son ID ou son nom exact. Si plusieurs liens portent ce nom, utilise l’ID affiché par /voirliens.

Depuis le panel

Dans Liens des membres, recherche un membre par pseudo, mention ou ID, sélectionne-le pour afficher ses liens, puis ajoute, modifie ou supprime une adresse.

Accès réservé au staff

Les commandes et la gestion dans le panel sont réservées au propriétaire du serveur et aux membres ayant la permission Discord Gérer le serveur. Les réponses des commandes sont privées.

Ces liens sont propres au serveur et au membre sélectionné. Toute personne autorisée à gérer cette fonction peut consulter les adresses enregistrées ; évite d’y stocker des liens dont le partage n’est pas approprié.

Une question sur la configuration du bot ?

Nous contacter sur Discord