ModKit, du premier clic au Discord qui tourne tout seul.

1. Avant de commencer
2. Inviter ModKit
3. Ouvrir le panel
4. Installer : Discord neuf ou existant
5. L'arrivée d'un membre
6. Règlement, accueil et panneaux
7. Tickets et aide vocale
8. La sécurité, au quotidien
9. Membres : fiches, auto-rôles, sanctions
10. Animer : niveaux, annonces, tirages, streams
11. Sauvegardes
12. Ménage des salons, et le droit à l'oubli
13. Plusieurs Discords, plusieurs personnes
14. Les commandes sur Discord
15. Quand quelque chose cloche
16. Partir, et tes données

Il te faut un compte Discord qui a « Gérer le serveur » sur le Discord à équiper. C'est ce droit qui permet d'inviter ModKit et d'ouvrir son panel. Rien d'autre : pas de compte à créer, pas de carte bancaire, pas de version « pro ».

Ce que ModKit ne fera jamais, quel que soit le réglage : supprimer un salon ou un rôle que tu as créé toi-même, bannir quelqu'un de sa propre initiative (une seule exception, que tu actives toi-même, en section 8), mélanger deux Discords, ou lire ce que ModKit sait d'une personne sur un autre serveur. Si un jour il te semble faire l'un de ces quatre, c'est un bug : dis-le sur le Discord TeamKit, c'est là que le support se fait.

Une règle pour tout le guide : tout ce qui touche à la structure passe par un aperçu avant d'être appliqué, et tout ce qui touche à une personne passe par un clic humain. ModKit prépare, tu décides.

Sur modkit.teamkit.fr, « Ajouter à mon Discord » ouvre la page d'autorisation de Discord. Tu choisis le serveur, tu lis la liste des permissions, tu valides. ModKit arrive sur le Discord et t'envoie le lien de ton panel.

Trois niveaux de permissions, à toi de choisir

• Minimal (le lien par défaut) : 22 permissions précises. Ni « Bannir des membres », ni « Administrateur ». Tout fonctionne, sauf ce qui exige ces deux droits.
• Étendu : le minimal, plus « Gérer le serveur » (l'audit peut alors relire tes invitations et corriger les réglages du serveur) et « Bannir des membres » (le bouton 🔨 de la Vigie, et la riposte anti-raid si tu l'actives).
• Administrateur : tout. Ça marche, mais c'est plus que ce que ModKit demande, et l'audit te le rappellera à chaque passage.

Tu peux changer d'avis à tout moment : Panel → Structure → Permissions du bot montre ce que ModKit a aujourd'hui, ce que chaque droit débloque, et les trois liens de réinvitation. Réinviter ne réinstalle rien : les réglages restent.

« Me connecter » sur la page d'accueil, avec ton compte Discord. Le panel ne montre que les Discords où tu as « Gérer le serveur » et où ModKit est installé, plus ceux où quelqu'un t'a invité (section 13). Tu restes connecté sept jours.

En haut, le sélecteur de serveur ; à gauche, le menu en six groupes : Pilotage (vue d'ensemble, journaux), Structure (installation, salons, panneaux, sauvegardes), Membres, Protection, Animation, Ton espace. Chaque groupe se replie d'un clic sur son titre, et le menu retient ton choix.

La visite guidée. À ta première ouverture d'un Discord, ModKit propose de te faire faire le tour : une zone du panel est éclairée, le reste s'assombrit, et une bulle explique à quoi elle sert. Deux visites — Découvrir le panel et Créer ton premier Discord, deux minutes chacune. Échap pour sortir, le bouton 🧭 Visite en haut pour les relancer quand tu veux. Elle ne s'impose qu'une fois par Discord ; une étape dont la zone n'existe pas chez toi est sautée sans rien dire.

Si le bot est hors ligne, le panel l'affiche en bandeau et continue de te montrer la configuration et le journal : ils sont lus dans la base, pas demandés au bot.

La visite guidée — le bouton 🧭 Visite de la barre haute. Elle assombrit la page, éclaire la zone dont elle parle et l'explique en une bulle : Découvrir le panel fait le tour des menus en neuf étapes, Créer ton premier Discord t'emmène sur Installation et déroule les trois étapes jusqu'au bouton Construire. Échap sort, les flèches avancent et reculent. Elle se propose toute seule la première fois que tu ouvres un Discord, puis plus jamais : c'est toi qui la relances.

Deux situations, deux chemins. Dans les deux cas, Construire ne supprime rien : il crée ce qui manque, renomme ce qu'il a créé, et laisse tout le reste tel quel. Une seule commande supprime ta structure : « Vider tout le serveur », dans /reinitialiser — réservée à qui a la permission Administrateur, après une sauvegarde complète et le nom du serveur recopié. Elle ne se lance jamais toute seule.

A. Un Discord neuf, ou qu'on veut restructurer

1. Structure → Installation : choisis un gabarit. Onze sont livrés, un par type de communauté (tableau ci-dessous). Le gabarit décide des rôles, des catégories, des salons, des permissions, et des textes des panneaux.
2. Retouche-le si tu veux : renommer un salon, en retirer un, changer une catégorie. L'aperçu compare le plan à ton Discord et dit exactement ce qui sera créé, ce qui existe déjà, et ce qui reste hors gabarit.
3. Construire. ModKit crée les rôles puis les salons, pose les permissions, et publie les panneaux : règlement avec son bouton, mot d'accueil, ouverture des tickets, aide vocale. Le bilan liste ce qui a été fait, et ce qui n'a pas pu l'être, avec la raison.
4. Une sauvegarde est prise avant toute construction. Si le résultat ne te plaît pas, Sauvegardes → Restaurer ramène l'état d'avant.

La même chose se fait depuis Discord avec /setup (aperçu puis validation) et /gabarit (choisir le point de départ).

B. Un Discord qui existe déjà, et qu'on garde tel quel

1. Choisis le gabarit vierge, ou fais relever ton Discord : ModKit lit ta structure actuelle et en fait un gabarit personnel, que tu peux ensuite retoucher et réappliquer.
2. Structure → Associer mes salons : dis à ModKit lequel de tes salons joue chaque rôle. Ton salon des tickets peut s'appeler #support ou #sos, peu importe : ModKit cherche celui que tu lui désignes, pas un nom. « Détecter mes salons » propose des correspondances d'après les noms ; tu corriges.
3. Sur la page Installation, le bandeau « Fonctions de ModKit » montre chaque fonction : verte quand elle est branchée sur un salon, grise quand elle attend la construction, éteinte quand il manque le salon. Cliquer sur une pastille ouvre le choix du salon.

Les quinze fonctions, et le salon que chacune attend

Les onze gabarits

Chaque gabarit cache ses salons à @everyone et les ouvre par le rôle Membre (Citoyen, Survivant, Viewer, Adhérent·e selon le gabarit) : un nouvel arrivant ne voit que l'accueil et le règlement, tant qu'il n'a pas cliqué.

Voilà ce qui se passe, dans l'ordre, quand quelqu'un rejoint :

1. La Vigie note le profil. Compte tout neuf, pas d'avatar, pseudo qui imite le staff ou vend du Nitro, drapeau « spammeur » posé par Discord, déjà sanctionné ici. Un score : vert, orange à partir de 30, rouge à partir de 60. Elle ne regarde que le profil public et le passé sur ce serveur.
2. Au-dessus du seuil, une carte part dans le salon des alertes de sécurité avec les signaux et quatre boutons : 👁️ surveiller 24 h (ses premiers messages sont recopiés au staff), 👢 expulser, 🔨 bannir (motif obligatoire, et seulement si ModKit a le droit), ✅ rien à signaler. ModKit ne clique jamais lui-même.
3. Le rôle Nouveau lui est donné s'il existe dans le gabarit, une carte personnelle apparaît dans le salon d'accueil, et un message privé lui donne les liens utiles. S'il a fermé ses MP, ModKit ne prétend pas lui avoir écrit.
4. Il lit le règlement et clique « J'accepte ». Il reçoit le rôle Membre, le rôle Nouveau lui est retiré, les salons s'ouvrent. Le staff voit une fiche d'arrivée : par quelle invitation il est venu, l'âge de son compte.
5. Quand il part, une fiche de départ, et ce qu'on savait de lui est effacé à l'échéance de chaque table (section 16).

Les textes de tout ça se règlent dans Membres → Accueil ; les seuils de la Vigie dans Protection → Vigie. Pendant un raid, le mode panique suspend l'étape 4 : le rôle Membre n'est plus distribué, les nouveaux restent à l'accueil (section 8).

Un panneau est un message que ModKit poste, épingle, et réécrit sur place quand son texte change. Tout se passe dans Structure → Panneaux épinglés.

Le règlement

• Chaque gabarit livre un règlement de départ. Le gabarit Communauté a le modèle complet en sept chapitres : esprit du serveur, règles, vocal et partages, mineurs et sécurité, sanctions, données, acceptation.
• L'éditeur travaille par cartes : une carte devient un message Discord coloré, avec titre, mise en forme, et jusqu'à 3 600 caractères. Un titre ouvre une nouvelle carte. Flèches pour réordonner, ✕ pour retirer, « Ajouter une carte » pour continuer.
• Le bouton « ✅ J'accepte le règlement » est ajouté tout seul sous la dernière carte.
• Si ton texte n'est pas le modèle, « 📄 Reprendre le règlement modèle » remplit les cartes avec lui. Rien n'est publié tant que tu n'as pas cliqué « Enregistrer et republier ».
• Les mentions <#tickets>, <#reglement>… deviennent des liens vers tes salons. L'aperçu signale celles qui pointent vers un salon non branché : pour tes membres, ce seraient des liens morts.

Le mot d'accueil

Une carte avec le titre en grand, l'icône de ton serveur, et deux boutons qui ouvrent le salon d'un clic : « 📜 Lire le règlement » et « 🎫 Besoin d'aide ». Ils n'apparaissent que si le salon est branché.

Tes panneaux

En bas de la page, jusqu'à vingt panneaux à toi : un salon, un titre, un texte (4 000 caractères), publié et tenu à jour sans toucher au reste du salon. Pour un « Comment se connecter », un « Planning de la semaine », une FAQ.

Les tickets

1. Le membre ne voit dans le salon des tickets que le panneau épinglé. Il choisit une catégorie (les tiennes, avec l'emoji de ton choix, dans Membres → Tickets), désigne le membre concerné s'il s'agit d'un signalement, écrit son message.
2. Un fil privé s'ouvre sous le salon, entre lui et le staff. En tête, une fiche qui porte le problème et l'état : 🟡 ouvert, 🔵 pris par quelqu'un, ✅ clos. Elle est mise à jour en place, la conversation reste lisible dessous.
3. Le staff reçoit la même carte dans le salon de suivi, avec les mêmes boutons. À la clôture, le bilan et la transcription (.txt) partent dans le salon des tickets clos.
4. Depuis le panel aussi : Membres → Tickets, un clic sur un ticket ouvre sa conversation, avec « Je m'en occupe », une zone de réponse et « Clore ». Ce que tu écris part dans le fil, signé de ton pseudo « depuis le panel », et le demandeur est notifié. La fiche d'un membre a le même bouton « Lire ici » sur ses tickets.

Les tickets d'un membre apparaissent sur sa fiche (section 9), ceux qu'il a ouverts comme ceux où il est visé.

L'aide vocale

Pour ce qui se règle mieux à l'oral. Le membre clique « J'ai besoin d'aide » et rejoint la salle d'attente. Le staff voit une fiche avec « prendre » : ModKit déplace les deux dans un vocal privé. À la fin, « terminer » : un rapport de ce qui a été constaté et fait part dans le salon des rapports.

L'audit de sécurité

Protection → Audit de sécurité lit la configuration de ton Discord et la note sur 100. Chaque constat dit ce que ça permet, et comment le refermer, pas à pas. Trois gravités : critique (à faire maintenant), sérieux, à voir. Là où ModKit a le droit, un bouton « Corriger » le fait pour toi, une porte à la fois ; sinon le remède est écrit, à faire dans Discord. Il finit par « ce que je n'ai pas pu vérifier » : un rapport qui tait ses angles morts ne vaut rien.

Ce qu'il regarde : les permissions dangereuses sur @everyone, les rôles avec Administrateur, la vérification à l'entrée, le filtre d'images de Discord, la 2FA du staff, les webhooks, les invitations permanentes, les accès donnés à une personne plutôt qu'à un rôle, un salon staff ouvert à un rôle sans pouvoir, les salons exigés par Discord pour un serveur Communauté, et la place de ModKit lui-même.

Le bouclier

Il attrape ce qui est mécanique : flood, répétitions, mentions en masse, liens d'invitation, raccourcisseurs, arnaques (faux Steam, faux Discord, Nitro gratuit, « token grabber », faux cadeaux, ou un lien avec un @here écrit en texte). Échelle : supprimer, avertir, mettre à l'écart quelques minutes ; une arnaque met à l'écart tout de suite, avec l'âge du compte dans l'alerte. Un lien posté par quelqu'un arrivé depuis moins de 24 heures ou sans le rôle Membre est retiré, avec un rappel qui s'efface, sans sanction. Jamais de ban. Un avertissement s'oublie après 24 heures sans incident, et ne vaut que sur ce serveur. Les seuils se règlent dans Protection → Bouclier. Les blocages d'AutoMod (le filtre de Discord) sont repris à son compte : la sanction suit, même si ModKit n'a pas vu le message.

Verrou et mode panique

• Verrouiller le serveur : plus personne n'écrit dans les salons publics, le staff garde les siens. Réversible d'un clic, à l'identique.
• Mode panique : le bouclier l'allume tout seul quand il voit une vague d'arrivées, ou une série de comptes créés la même semaine. Les nouveaux n'obtiennent plus le rôle Membre. C'est toi qui le lèves, sur la page Bouclier, une fois le calme revenu : ModKit prévient alors les nouveaux de recliquer sur le bouton du règlement.

La riposte anti-raid : la seule exception, et c'est toi qui l'ouvres

Éteinte par défaut. Si tu l'actives, pendant un mode panique ModKit peut expulser ou bannir les comptes neufs de la vague. Bornée aux comptes de moins de N jours arrivés pendant le raid, plafonnée par heure, jamais le staff ni un bot, chaque action listée et annulable d'un clic. Sans « Bannir des membres », « bannir » ne fait qu'expulser, et la liste le dit. Éteinte, ModKit ne bannit personne.

L'anti-nuke

Le bouclier arrête les inconnus hostiles ; il ne voit rien d'un administrateur légitime qui supprime quarante salons en trente secondes. L'anti-nuke surveille la cadence des actions destructrices, quel que soit l'auteur, en lisant le journal d'audit de Discord (qui dit qui a supprimé). Au-delà du seuil, le compte est désarmé : ses rôles à pouvoir lui sont retirés, le staff est prévenu, et « réarmer » les lui rend d'un clic. Les bans et expulsions faits pendant le mode panique ou le verrouillage, ou visant un membre arrivé depuis moins d'une heure, ne comptent pas : ton staff peut nettoyer un raid à la main. Actif par défaut, il le dit une fois dans le journal de ModKit, avec le lien pour le régler. Protection → Anti-nuke.

Le filtre de mots

Ta liste, décidée par toi : ModKit n'apporte aucune liste, un mot banni ici est un mot du quotidien ailleurs. Les déguisements courants tombent quand même (c0nn4rd, c.o.n.n.a.r.d, connnnard, cönnard). Un mot entier seulement : « député » ne fait pas tomber « pute ». Action au choix : supprimer, avertir, mettre à l'écart. « Essayer » teste une phrase sans rien publier. Protection → Filtre de mots.

Fiches membres

Membres → Fiches membres : tout ce que ModKit sait d'une personne, au même endroit. Ses sanctions, ce que la Vigie a vu à son arrivée, qui l'a amené, ses rôles, ses tickets. Rien n'est collecté pour la fiche : tout existait déjà, éparpillé. Un modérateur pressé sanctionne sans savoir que c'est la quatrième fois ; la fiche le lui dit.

Auto-rôles

Un panneau où tes membres se servent : « Choisis tes jeux », « Tes notifications », « Ta région ». Un bouton, un rôle ; un clic pour prendre, un clic pour rendre. Un rôle qui donne le moindre pouvoir de modération est refusé : un bouton public, c'est n'importe qui qui clique. Membres → Auto-rôles.

Sanctions

Protection → Sanctions liste ce que le bouclier, le filtre et le staff ont fait, avec le motif et l'auteur. L'échelle proposée au staff : rappel, avertissement, mise à l'écart, expulsion, bannissement. Les deux derniers restent des gestes humains.

Niveaux

De l'XP au message et à la minute de vocal, des rôles qui se débloquent par palier (vingt au plus), un classement. /niveau sur Discord donne son niveau, son XP et les dix premiers. Un rôle de palier qui donnerait un pouvoir de modération est refusé : on ne monte pas modérateur à l'usure. « Remettre à zéro » efface l'XP de tout le monde, les réglages restent. Membres → Niveaux.

Annonces

Écrire maintenant, publier à une date, ou chaque semaine. Vingt par Discord au plus : au-delà ce n'est plus un calendrier, c'est un robot à spam. Une annonce envoyée reste trente jours pour mémoire. Si le bot était éteint à l'heure dite, elle part au redémarrage, jusqu'à 24 heures de retard ; après, elle est abandonnée et le journal le dit. Animation → Annonces.

Sondages et tirages

Les sondages sont ceux de Discord, créés depuis le panel et relus à la clôture : tes membres les connaissent déjà. Les tirages au sort : un bouton pour participer, des conditions d'entrée (âge du compte, ancienneté sur le serveur), un tirage honnête. Un compte créé la veille pour participer est écarté : ça ne rend pas la triche impossible, ça la rend coûteuse. Animation → Sondages et tirages.

Streams

Tes membres proposent leur chaîne Twitch avec /chaine ou le bouton de l'annuaire épinglé. Comme ModKit ne peut pas prouver que la chaîne est à eux, la proposition attend une validation du staff (fiche dans le salon de suivi des tickets, ou depuis le panel). Ensuite leurs lives s'annoncent dans le salon des lives, carte mise à jour pendant le live. Animation → Streams.

Serveurs de jeu

Déclare l'adresse de ton serveur (famille Source : Rust, Garry's Mod, ARK, Valheim, Palworld ; ou Minecraft Java) et ModKit affiche « 🟢 24/60 joueurs · 32 ms » dans un salon, mis à jour toutes les minutes. Une adresse privée ou locale est refusée avant même d'être contactée. Animation → Serveurs de jeu.

Journaux Discord et statistiques

Pilotage → Journaux Discord : messages supprimés, membres partis, rôles donnés, et par qui quand Discord le dit. Gardés 90 jours. Ton espace → Statistiques : qui reste après 7 jours, quels salons vivent, à quelle heure. Des compteurs par salon et par heure, jamais un auteur ni un texte.

Une photo complète du serveur : rôles, catégories, salons, permissions, sujets, ordre, et qui portait quel rôle. C'est ce dernier point qui fait la différence après un incident : restaurer rend leurs rôles aux membres, un par un. Les messages, eux, n'y sont pas — sauf dans la photo prise juste avant « Vider tout le serveur » (/reinitialiser) : là, les cent derniers de chaque salon sont dedans, et une restauration les repose par un webhook qui emprunte le pseudo et l'avatar d'origine.

• Automatique : une photo à intervalle réglable, quatorze gardées par défaut (de 2 à 90). Une photo est aussi prise avant toute construction, restauration ou réinitialisation.
• Télécharger une photo, importer celle d'un autre Discord : la fusion se fait par le nom, un rôle ou un salon qui existe déjà est réutilisé, jamais dupliqué, rien n'est supprimé.
• Restaurer montre d'abord la correspondance entre la photo et le serveur actuel ; « rendre les rôles » peut se faire seul, sans toucher à la structure.

Structure → Sauvegardes. Une photo contient les pseudos de tes membres : elle part avec le Discord, et disparaît à la purge (section 16).

Discord interdit la suppression en masse des messages de plus de 14 jours. C'est une limite de Discord, pas de ModKit, et elle décide de tout ce qui suit : cette page empêche un salon de gonfler, elle ne rattrape pas un historique de six mois. Ce qui est hors de portée est compté et annoncé, jamais supprimé en douce.

• Rétention automatique : par salon, « garde les N derniers » ou « garde X jours ». Une passe toutes les six heures. Éteinte tant que tu ne l'allumes pas, et salon par salon — commence par un salon de commandes de bot ou de spam, jamais par #général.
• Ménage à la demande : la commande /menage dans le salon où tu es. Elle montre d'abord ce qu'elle trouverait — combien de messages, sur quelle période, combien d'épinglés écartés, combien hors de portée — et attend que tu cliques. Rien n'est supprimé au premier appel.
• Ce qui n'est jamais touché : les messages épinglés (s'ils sont épinglés, c'est qu'ils comptent), les salons de tickets et de sanctions, le règlement et la bienvenue. Tu peux en protéger d'autres.
• Des plafonds : 1 000 messages par passage, 3 000 par heure et par Discord. Chaque suppression est écrite au journal, avec le nom de qui l'a demandée — comme une sanction.

Le droit à l'oubli. N'importe quel membre tape /oubliez-moi et ModKit efface ses messages, y compris les anciens. Il n'a besoin de personne : ni du gérant, ni d'un e-mail. Toi, tu peux lancer le même effacement pour quelqu'un depuis le panel.

Trois choses à dire à qui le demande, parce qu'aucun outil ne peut faire mieux : c'est lent (environ 3 000 messages par heure, les anciens partent un par un), ça remonte jusqu'à 20 000 messages par salon (Discord ne donne aucune recherche aux robots — il faut relire l'historique page par page), et les salons de tickets restent intacts. À la fin, ton journal dit combien de messages ont été examinés et combien supprimés : c'est ce chiffre qui fait foi, jamais un « tout est effacé ».

Le travail continue même si le bot redémarre, et une seule demande est traitée à la fois — sinon une purge monopoliserait le bot et la modération des autres Discords s'arrêterait le temps qu'elle dure. Pour la même raison, un membre ne peut refaire une demande sur ton Discord qu'au bout de sept jours. À la fin, ses lignes des Journaux Discord partent aussi ; si tu arrêtes toi-même la tâche, elles restent, pour que tu puisses comprendre ce qui s'est passé.

Structure → Ménage des salons. Voir aussi la page sur les données personnelles.

Qui a accès

Par défaut, seuls ceux qui ont « Gérer le serveur » ouvrent le panel. Ton espace → Qui a accès permet d'inviter quelqu'un d'autre, à l'un de trois niveaux :

• Lire : la vue d'ensemble, les journaux, les fiches. Regarder ne casse rien.
• Agir : le quotidien du staff. Tickets, aide vocale, sanctions, réglages du bouclier, mode panique.
• Structure : construire, appliquer un plan, restaurer, corriger l'audit.

Le quatrième niveau, les clés (inviter quelqu'un, faire partir ModKit, tout effacer), reste attaché à « Gérer le serveur » sur Discord et ne se délègue pas. Un invité voit en grisé les pages qu'il n'a pas, avec la raison. Le contrôle est fait sur chaque appel au serveur, pas seulement dans le menu.

Copier ailleurs

Tu gères plusieurs serveurs ? Règle une fois, applique là-bas : seuils du bouclier et de l'anti-nuke, catégories de tickets, filtre de mots, XP des niveaux, gabarits personnels. Jamais un membre, jamais une sanction, jamais un identifiant de rôle ou de salon (ils n'ont de sens que là où ils sont nés). Ton espace → Copier ailleurs.

Vérifier

Structure → Vérifier fait le tour complet : ce qui est branché, ce qui manque à la structure, ce que la sécurité laisse passer, et si ModKit a bien accès à ce dont chaque fonction a besoin. À refaire après chaque changement de rôles ou de permissions dans Discord.

Neuf commandes, volontairement. Tout le reste se règle dans le panel, où l'on voit ce qu'on fait.

Ton espace → Partir retire ModKit de ton Discord. Ce qu'il en sait est gardé trente jours (le temps de revenir sur une erreur), puis effacé ; « Effacer maintenant » n'attend pas. Les salons et les rôles qu'il a créés restent : ils sont à toi.

Pendant qu'il est là, chaque table a sa durée : journaux Discord et statistiques 90 jours, avertissements du bouclier 24 heures, annonces envoyées 30 jours, photos automatiques quatorze gardées. Le détail, durée par durée, est sur la page données personnelles, faite pour être mise en lien dans ton règlement ; le modèle le fait déjà.

Ce guide change quand ModKit change. Un point qui manque, une étape qui ne correspond pas à ce que tu vois : dis-le sur le Discord TeamKit, salon d'aide.