🚀 Démarrage rapide
Bienvenue dans la documentation officielle de BotNoob ! Ce guide va te permettre de démarrer en moins de 5 minutes.
1. Inviter le bot sur ton serveur
Clique sur le bouton ci-dessous, choisis ton serveur Discord et autorise les permissions demandées :
➕ Ajouter BotNoob
ℹ️ Permissions requises
BotNoob a besoin de la permission Administrateur pour fonctionner correctement (modération, gestion des salons pour les tickets, gestion des rôles pour l'auto-rôle). Tu peux ajuster les permissions ensuite si tu le souhaites.
2. Accéder au panel d'administration
Une fois le bot ajouté, connecte-toi sur bot.noobland.fr via OAuth2 Discord. Tu verras alors la liste de tous les serveurs où tu as la permission Administrateur ou Gérer le serveur.
3. Configurer les modules
Depuis le panel, tu peux activer et configurer :
- 🛡️ Modération — Filtre de mots bannis, actions kick/ban, journaux complets
- 🎫 Tickets — Système de support avec catégories et transcripts
- 👋 Bienvenue — Cartes images personnalisées, auto-rôle
- 📢 Diffusion — Annonces manuelles ou automatiques
- 🔗 Intégrations — Notifications Twitch / YouTube / TikTok
4. Premiers pas
Le préfixe par défaut des commandes est !. Tu peux le changer dans Paramètres → Préfixe. Pour tester que tout fonctionne, tape !ping dans n'importe quel salon.
💡 Astuce
BotNoob propose aussi des commandes slash (qui apparaissent en tapant / dans Discord). Elles fonctionnent en parallèle des commandes préfixées et n'ont pas besoin du préfixe.
🛡️ Modération
BotNoob propose un système de modération complet : filtre automatique, actions manuelles depuis le panel ou via commandes, et journaux filtrables.
Filtre de mots bannis
Configure une liste de mots interdits depuis l'onglet Modération du panel. Tout message contenant l'un de ces mots est supprimé automatiquement et l'action est enregistrée dans les logs.
- Va dans Panel → Modération
- Tape un mot dans le champ et appuie sur Entrée
- Clique sur Sauvegarder
Actions manuelles depuis le panel
Tu peux kick ou ban un membre directement depuis le panel admin :
- Récupère l'ID Discord du membre (clic droit sur son pseudo → Copier l'identifiant)
- Colle l'ID dans le champ "ID utilisateur cible" du panel
- Renseigne une raison (optionnel)
- Clique sur 👢 Kick ou 🔨 Ban
⚠️ Attention
Ces actions sont irréversibles. Un ban ne peut être levé que par un autre admin via la commande !unban.
Système de mute persistant
Quand tu utilises !mute @user 60, BotNoob enregistre le mute en base de données avec son timestamp d'expiration. Le démute est automatique même si le bot redémarre entre-temps.
Le rôle Muted est créé automatiquement à la première utilisation, avec les permissions correctement configurées dans tous les salons.
Salon de logs
Configure un salon dédié dans Paramètres → Canal de logs modération. Toutes les actions importantes y seront enregistrées en temps réel.
🎫 Système de tickets
Un système type TicketTool entièrement configurable : panel d'ouverture avec menu déroulant, catégories multiples, transcripts HTML, évaluations 5 étoiles.
Configuration initiale
- Va dans Panel → Tickets
- Choisis le salon où publier le panel d'ouverture
- Choisis la catégorie Discord où seront créés les nouveaux tickets
- Configure le salon de logs (optionnel mais recommandé)
- Choisis le mode de fermeture :
- Archiver — Le salon est verrouillé et renommé
closed-…
- Supprimer — Le salon est définitivement supprimé après 5 secondes
- Personnalise l'embed (titre, description, couleur)
- Clique sur 💾 Enregistrer
Créer des catégories
Une catégorie = une entrée dans le menu déroulant du panel. Pour chaque catégorie tu peux définir :
- Un emoji et un libellé
- Une description courte (sous le libellé)
- Les rôles staff qui voient ce type de ticket
- Le message d'accueil envoyé à l'ouverture (variables
{user} et {server})
- Si les rôles staff doivent être pingés ou non
Publier le panel
Une fois la config et au moins une catégorie créées, clique sur 📤 Publier le panel. Le bot va envoyer un embed avec le menu déroulant dans le salon configuré.
💡 Re-publier le panel
Si tu modifies l'embed ou les catégories, clique à nouveau sur Publier — l'ancien message sera supprimé et un nouveau sera créé.
Cycle de vie d'un ticket
- Ouverture — L'utilisateur clique sur le menu, choisit une catégorie. Un nouveau salon est créé avec lui + le staff de la catégorie.
- Réclamation — Un staff clique sur 🙋 Réclamer pour s'attribuer le ticket.
- Conversation — Le staff peut Ajouter/Retirer des membres si nécessaire.
- Fermeture — Le staff clique sur 🔒 Fermer. Un transcript HTML est généré et envoyé en DM à l'auteur (si activé), ainsi que dans le salon de logs.
- Évaluation — L'auteur reçoit en DM 5 boutons étoile pour noter son expérience (si activé).
👋 Bienvenue & Au revoir
Accueille tes nouveaux membres avec des cartes images personnalisées, et dis au revoir à ceux qui partent.
Activer la carte de bienvenue
Dans Panel → Bienvenue, active le toggle "Activer la carte de bienvenue" puis configure :
- Le salon de bienvenue
- Le message texte (avec
{user} et {server})
- L'auto-rôle à attribuer à l'arrivée (optionnel)
- Le texte sur la carte (max 60 caractères)
Un aperçu en direct s'affiche pendant que tu modifies, pour visualiser le rendu final.
Activer la carte d'au revoir
Le système est indépendant de la carte de bienvenue : tu peux activer l'un, l'autre, ou les deux. La carte d'au revoir utilise un visuel rouge avec l'avatar en niveaux de gris et affiche la durée de présence du membre.
Variables disponibles
{user} — Mention/pseudo du membre
{server} — Nom du serveur
ℹ️ Remarque sur les cartes
Les cartes sont générées en temps réel par le bot avec l'avatar du membre. Si la génération échoue (avatar inaccessible, etc.), seul le message texte est envoyé — le bot ne plante jamais à cause d'une carte.
📢 Diffusion d'annonces
Envoie des messages dans n'importe quel salon depuis le panel admin, en mode manuel ou automatique récurrent.
Diffusion manuelle
- Va dans Panel → Message / Intégration
- Sélectionne le salon cible
- Rédige ton message (utilise la barre de formatage Discord pour gras, italique, blocs de code, citations, mentions, etc.)
- L'aperçu en direct te montre le rendu Discord
- Clique sur Envoyer
Annonces automatiques récurrentes
Tu peux programmer des annonces qui se répètent à intervalles réguliers :
- Bascule sur l'onglet "Auto" dans la section diffusion
- Choisis le salon, rédige le message, choisis l'intervalle (en minutes)
- Clique sur Ajouter l'annonce automatique
L'annonce sera envoyée tant qu'elle n'est pas supprimée. Le bot vérifie toutes les 30 secondes si une annonce doit être déclenchée.
💡 Bonnes pratiques
Évite les intervalles trop courts (moins de 30 minutes) pour ne pas spammer ton serveur. Pour une annonce horaire, utilise 60 ; pour quotidienne, 1440 (60 × 24).
🔗 Intégrations sociales
Notifie automatiquement ton serveur dès qu'un streamer passe en live, qu'une vidéo YouTube est publiée ou qu'un TikTok est posté.
🟣 Twitch
Configure dans Panel → Message / Intégration → Twitch :
- Le pseudo Twitch du streamer (ex.
kameto)
- Le salon Discord où poster la notification
- Le message (avec
{streamer}, {title}, {url})
Le bot vérifie toutes les 2 minutes si le streamer est en ligne. Une seule notification est envoyée par stream (pas de spam).
🔴 YouTube
Configure :
- L'ID de la chaîne YouTube (commence par
UC…)
- Le salon Discord de notification
- Le message (avec
{channel}, {title}, {url})
ℹ️ Comment trouver l'ID d'une chaîne YouTube ?
Va sur la chaîne YouTube → onglet "À propos" → Partager → Copier l'ID, OU regarde l'URL d'une vidéo de la chaîne.
⚫ TikTok
Configure :
- Le nom d'utilisateur TikTok (sans le @)
- Le salon Discord de notification
- Le message (avec
{user}, {url})
⚠️ Stabilité des intégrations
Les intégrations YouTube et TikTok utilisent des flux RSS publics. Si la source devient indisponible, les notifications peuvent être interrompues temporairement. Le bot reprendra automatiquement dès que le flux sera rétabli.
⌨️ Liste des commandes
Le préfixe par défaut est ! (modifiable dans Paramètres). Les commandes /ticket … sont des slash commands qui n'utilisent pas le préfixe.
🛡️ Modération
| Commande | Description | Permission requise |
!ban @user [raison] | Bannit définitivement un utilisateur | Bannir des membres |
!unban <user#1234> | Débannit un utilisateur | Bannir des membres |
!kick @user [raison] | Expulse un utilisateur | Expulser des membres |
!mute @user [minutes] | Réduit au silence (10 min par défaut) | Gérer les messages |
!unmute @user | Retire le silence | Gérer les messages |
!warn @user [raison] | Envoie un avertissement | Gérer les rôles |
!clear [nombre] | Supprime les N derniers messages | Gérer les messages |
!slowmode [secondes] | Active le slowmode (0 = désactiver) | Gérer les messages |
🎫 Tickets
| Commande | Description | Permission requise |
/ticket panel | Publie le panel d'ouverture de tickets | Gérer le serveur |
/ticket close | Ferme le ticket en cours | — |
/ticket claim | Réclame le ticket en tant que staff | Staff |
/ticket add <membre> | Ajoute un membre au ticket | — |
/ticket remove <membre> | Retire un membre du ticket | — |
🔧 Utilitaires
| Commande | Description |
!ping | Affiche la latence du bot |
!info [@user] | Infos sur un utilisateur (toi-même par défaut) |
!serverinfo | Infos sur le serveur |
!say <texte> | Le bot répète le texte (Gérer les messages requis) |
!help | Affiche le menu d'aide |
❓ Foire aux questions
Le bot ne répond pas à mes commandes
Vérifie dans cet ordre :
- Le bot est-il bien en ligne sur ton serveur (point vert) ?
- Utilises-tu le bon préfixe ? (par défaut
!, modifiable dans Paramètres)
- Le bot a-t-il les permissions Lire les messages et Envoyer des messages dans le salon ?
- Le bot a-t-il l'intent Message Content activé ? (Si tu lis cette doc c'est qu'il l'a déjà.)
Le panel admin affiche "Aucun serveur trouvé"
Tu dois avoir la permission Administrateur ou Gérer le serveur sur au moins un serveur où le bot est présent. Si tu viens d'avoir la permission, déconnecte-toi et reconnecte-toi pour rafraîchir.
Comment changer le préfixe du bot ?
Dans Panel → Paramètres → Préfixe de commande. Tape ton nouveau préfixe (max 5 caractères) et clique sur Enregistrer.
Les cartes de bienvenue ne s'affichent pas
Vérifie que :
- Le toggle "Activer la carte de bienvenue" est bien activé
- Le salon de bienvenue est configuré
- Le bot a la permission Joindre des fichiers dans ce salon
Combien de tickets peut-on ouvrir simultanément ?
Par défaut, 1 seul ticket ouvert par utilisateur. Tu peux désactiver cette limite dans Tickets → Configuration.
Le bot a planté / une erreur est apparue
Utilise le formulaire de signalement en décrivant ce qui s'est passé. Plus tu donnes de détails (étapes pour reproduire, capture d'écran, ID serveur), plus on peut corriger vite.
Je veux suggérer une nouvelle fonctionnalité
Utilise le formulaire de signalement en choisissant la catégorie Suggestion. Toutes les idées sont lues et classées par priorité.