🚀 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.

  1. Va dans Panel → Modération
  2. Tape un mot dans le champ et appuie sur Entrée
  3. Clique sur Sauvegarder

Actions manuelles depuis le panel

Tu peux kick ou ban un membre directement depuis le panel admin :

  1. Récupère l'ID Discord du membre (clic droit sur son pseudo → Copier l'identifiant)
  2. Colle l'ID dans le champ "ID utilisateur cible" du panel
  3. Renseigne une raison (optionnel)
  4. 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

  1. Va dans Panel → Tickets
  2. Choisis le salon où publier le panel d'ouverture
  3. Choisis la catégorie Discord où seront créés les nouveaux tickets
  4. Configure le salon de logs (optionnel mais recommandé)
  5. Choisis le mode de fermeture :
    • Archiver — Le salon est verrouillé et renommé closed-…
    • Supprimer — Le salon est définitivement supprimé après 5 secondes
  6. Personnalise l'embed (titre, description, couleur)
  7. 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

  1. Ouverture — L'utilisateur clique sur le menu, choisit une catégorie. Un nouveau salon est créé avec lui + le staff de la catégorie.
  2. Réclamation — Un staff clique sur 🙋 Réclamer pour s'attribuer le ticket.
  3. Conversation — Le staff peut Ajouter/Retirer des membres si nécessaire.
  4. 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.
  5. É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

  1. Va dans Panel → Message / Intégration
  2. Sélectionne le salon cible
  3. Rédige ton message (utilise la barre de formatage Discord pour gras, italique, blocs de code, citations, mentions, etc.)
  4. L'aperçu en direct te montre le rendu Discord
  5. Clique sur Envoyer

Annonces automatiques récurrentes

Tu peux programmer des annonces qui se répètent à intervalles réguliers :

  1. Bascule sur l'onglet "Auto" dans la section diffusion
  2. Choisis le salon, rédige le message, choisis l'intervalle (en minutes)
  3. 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

CommandeDescriptionPermission requise
!ban @user [raison]Bannit définitivement un utilisateurBannir des membres
!unban <user#1234>Débannit un utilisateurBannir des membres
!kick @user [raison]Expulse un utilisateurExpulser des membres
!mute @user [minutes]Réduit au silence (10 min par défaut)Gérer les messages
!unmute @userRetire le silenceGérer les messages
!warn @user [raison]Envoie un avertissementGérer les rôles
!clear [nombre]Supprime les N derniers messagesGérer les messages
!slowmode [secondes]Active le slowmode (0 = désactiver)Gérer les messages

🎫 Tickets

CommandeDescriptionPermission requise
/ticket panelPublie le panel d'ouverture de ticketsGérer le serveur
/ticket closeFerme le ticket en cours
/ticket claimRéclame le ticket en tant que staffStaff
/ticket add <membre>Ajoute un membre au ticket
/ticket remove <membre>Retire un membre du ticket

🔧 Utilitaires

CommandeDescription
!pingAffiche la latence du bot
!info [@user]Infos sur un utilisateur (toi-même par défaut)
!serverinfoInfos sur le serveur
!say <texte>Le bot répète le texte (Gérer les messages requis)
!helpAffiche le menu d'aide

❓ Foire aux questions

Le bot ne répond pas à mes commandes

Vérifie dans cet ordre :

  1. Le bot est-il bien en ligne sur ton serveur (point vert) ?
  2. Utilises-tu le bon préfixe ? (par défaut !, modifiable dans Paramètres)
  3. Le bot a-t-il les permissions Lire les messages et Envoyer des messages dans le salon ?
  4. 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é.