Guide complet de WumpBot

📖 Introduction

WumpBot regroupe en un seul bot l'ensemble des outils nécessaires à la gestion d'une communauté Discord : modération, suivi du staff, absences, tickets de contestation, recherche de groupe et plus encore. Chaque module se configure depuis un panel web accessible sur wumpbot.fr, sans toucher au code.

🖥️ Panel d'administration

wumpbot.fr — configuration centralisée

Le panel est le centre de contrôle de WumpBot. La connexion se fait via Discord (OAuth2) : aucun mot de passe à créer, tu te connectes avec ton compte Discord.

Sélection du serveur

Après connexion, tu choisis le serveur à administrer parmi ceux où tu es présent et où le bot est installé. Toute la configuration qui suit s'applique au serveur sélectionné.

Sections disponibles

Le panel s'organise en sections, chacune dédiée à un module : Service, Attente staff, Absences, Tickets, Invitation vocale, Effectif staff, Rôles protégés et Permissions. Les sections visibles dépendent de tes droits d'accès (voir ci-dessous).

🔐 Permissions & rôles

WumpBot propose un contrôle d'accès fin, à deux niveaux.

Permissions par section

Chaque section du panel peut être réservée à certains rôles Discord. Un membre du staff ne verra et n'utilisera que les sections auxquelles ses rôles donnent accès. La configuration des permissions elle-même est réservée aux administrateurs Discord du serveur.

Rôles protégés

Tu peux désigner des rôles protégés : les membres qui les portent deviennent intouchables par les commandes de modération du bot. Idéal pour protéger l'équipe de direction d'une sanction accidentelle.

🛡️ Modération & sanctions

Un ensemble complet de commandes de modération, avec historique et notifications automatiques.

Notification au membre

À chaque sanction, le membre reçoit un message privé récapitulatif (type, motif, date). Pour les avertissements et les exclusions temporaires, un bouton « Contester » est joint, qui ouvre le système de tickets.

Historique & logs

Toutes les sanctions sont enregistrées et consultables via /sanctions liste. Un salon de logs configurable reçoit automatiquement une trace de chaque action.

Commandes de modération

⏱️ Heures de service

Suivi automatique du temps de présence du staff « en service ».

Détection automatique

Le temps est compté dès qu'un membre reçoit le rôle « En Service » configuré, et s'arrête quand il le perd. Aucun pointage manuel n'est nécessaire.

Quota & récapitulatif

• Un quota hebdomadaire (en heures) peut être défini par serveur.
• Un récapitulatif automatique est publié chaque semaine dans le salon configuré.
• Le compteur se réinitialise automatiquement chaque dimanche, en rouvrant les sessions des membres encore en service.

Commandes

🏖️ Gestion des absences

Un circuit de demande et de validation des absences du staff.

Déposer une absence

La commande /absence publie une demande (dates de début/fin + motif) sous forme d'embed avec deux boutons Valider / Refuser. La validation est réservée au rôle validateur configuré ou aux administrateurs.

Statuts & annulation

Chaque absence passe par les statuts en attente → validée / refusée / annulée. Un membre peut annuler lui-même sa propre absence (en attente ou validée) via /absence-annuler, avec autocomplétion de ses absences en cours.

Commandes

⏳ Attente staff

Ne ratez plus un membre qui attend de l'aide en vocal.

Lorsqu'un membre rejoint le salon vocal d'attente configuré, le bot envoie automatiquement un ping dans un salon textuel pour prévenir le staff. Le message est personnalisable et accepte des variables comme {membre} et {username}.

🎫 Tickets de contestation

Un système de tickets multi-panel pour gérer les contestations de sanctions, avec dialogue bidirectionnel entre staff et membre.

Ouverture d'un ticket

Depuis le bouton « Contester » reçu en MP après une sanction, le membre remplit un formulaire. Le bot crée alors automatiquement un salon de ticket dans la catégorie configurée et notifie les rôles concernés.

Dialogue staff ↔ membre

• Dans le salon de ticket, le staff écrit -r <message> pour répondre anonymement au membre en message privé.
• Les réponses du membre en MP sont relayées automatiquement dans le salon de ticket.
• Les messages sans -r restent visibles uniquement par le staff (discussion interne).

Décision & archivage

Des boutons Accepter / Refuser ouvrent une fenêtre de décision permettant, au besoin, de modifier la sanction d'origine (lever, changer le type ou la durée). À la fermeture, le ticket est archivé (transcription + embed récapitulatif) et peut être rouvert si nécessaire.

👥 Effectif staff

Un trombinoscope du staff qui se tient à jour tout seul.

Le module publie un embed listant le staff groupé par rôle. Il se met à jour automatiquement dès qu'un membre rejoint, quitte ou change de rôle — l'embed affiche toujours l'effectif réel.

• Affichage organisé par sections de rôles (Créateurs, Administration, Modération, etc.).
• Mise à jour en temps réel sur les changements de membres.
• Compatible avec les salons de type forum.
• Accès configurable par rôle pour chaque section.

🎮 Invitations vocales (LFG)

Looking For Group — trouver des coéquipiers

La commande /invite permet à un membre de publier une invitation pour remplir son salon vocal, entièrement personnalisable depuis le panel.

Création d'une invitation

/invite ouvre un formulaire privé : choix du salon vocal, réponses aux questions configurées et plage de rangs souhaitée. L'invitation est ensuite publiée avec un compteur en temps réel des places restantes et de la liste des membres présents.

Questions personnalisables

Jusqu'à 4 questions personnalisables (plateforme, mode de jeu, etc.), avec options, emojis et sélection multiple. Une question peut aussi servir à indiquer le rang recherché.

Rangs & détection automatique

• Rangs du jeu définissables (nom + emoji), réordonnables par glisser-déposer, affichés du plus bas au plus haut.
• Mode plage min/max (ex. Gold à Platine) ou mode question.
• Détection automatique du rang d'un membre via ses rôles Discord (activable), avec un rang « par défaut » optionnel.

Diffusion & cycle de vie

• Salons de relais : l'invitation peut être postée dans plusieurs salons à la fois, avec mises à jour synchronisées.
• Embed d'explication automatique : posté quelques secondes après la création d'un vocal temporaire dans une catégorie surveillée.
• Suppression automatique quand le vocal est plein ou supprimé, et expiration de sécurité après 2 h.
• Une seule invitation active par membre à la fois.

⌨️ Toutes les commandes

Référence rapide de l'ensemble des commandes slash, par catégorie.

Modération

Staff & service

Absences

Communauté

💬 Support

Une question, un bug ou une suggestion ? Le panel et la configuration sont accessibles sur wumpbot.fr.

Pour les questions relatives à tes données personnelles, consulte la Politique de Confidentialité et les Conditions d'Utilisation.