Documentation

CreatorBot est un bot Discord tout-en-un pour modération, économie, leveling, tickets, IA, et plus encore.

Il vient avec un dashboard web où tu configures tout sans te battre avec des commandes Discord.

Free vs Premium : la majorité des fonctionnalités sont gratuites. Le Premium débloque les options avancées (IA, branding, jobs, transcripts HTML, etc.). Voir la page Premium.

1. Clique sur « Inviter le bot » depuis la page d'accueil
2. Choisis ton serveur Discord (tu dois être propriétaire ou avoir Manage Server)
3. Accepte les permissions demandées (le bot a besoin de plusieurs perms pour fonctionner correctement)
4. Tu peux ensuite te connecter au dashboard pour configurer le bot

La commande /quickstart te permet de configurer ton serveur en moins d'une minute :

1. Bienvenue : choisir un salon ou auto-créer #👋-bienvenue
2. Logs modération : choisir un salon ou auto-créer #🛡️-logs-moderation (privé)
3. Automod preset : 🟡 Équilibré (recommandé), 🔴 Strict, ou ⚪ Désactivé
4. Auto-rôle : sélectionner un rôle membre à donner d'office
5. Récap + Apply : applique tout en une fois

Pour une configuration plus poussée, utilise le dashboard ou la commande /setup (interactive).

Permission requise : Bannir des membres

/ban membre:@user raison:<texte> messages:0-7

• membre : le membre à bannir (obligatoire)
• raison : raison visible dans les logs (optionnelle)
• messages : supprimer les messages des N derniers jours (0-7)

⚠️ Le rôle du bot doit être au-dessus du rôle du membre à bannir.

Permission : Expulser des membres

/kick membre:@user raison:<texte>

Identique à /ban mais sans bannissement permanent.

Permission : Mettre en sourdine

/mute membre:@user duree:1h raison:<texte>

Durées disponibles : 60s, 5/10/30 min, 1/6/12h, 1/7 j, 28 j (max Discord).

Permission : Gérer les messages

/purge nombre:<1-100> membre:@user(optionnel)

Supprime jusqu'à 100 messages dans le salon courant. Avec membre, ne supprime que ses messages.

⚠️ Discord empêche le bulk-delete des messages > 14 jours.

Permission : Gérer les salons

/lock on salon:#general raison:<texte>
/lock off salon:#general

Empêche @everyone d'écrire dans le salon. Les rôles staff continuent à pouvoir écrire.

Permission : Gérer les messages

/warn add membre:@user raison:<texte>
/warn list membre:@user
/warn remove id:<n>

Système de warnings stocké en DB. Combiné avec l'automod escalation, peut déclencher mute/kick/ban automatiquement après N warnings.

Le module Shield est ton automod : 11 règles configurables, chacune avec son propre toggle, ses seuils, et ses bypass (rôles/salons ignorés).

Règles disponibles :

• Anti-flood : bloque le spam de messages (X messages en Y ms)
• Anti-liens : supprime tous les liens http(s)://
• Anti-invitations : bloque les invitations Discord externes (whitelist possible)
• Anti-caps : bloque les messages criards (% majuscules + longueur min, mode progressif)
• Anti-mentions : limite le nombre de mentions par message
• Anti @everyone : bloque les @everyone et @here
• Mots interdits : liste noire avec support regex (/motif/i)
• Anti-stickers : limite le nombre de stickers par fenêtre
• Anti-emojis : limite les emojis par message
• Anti-retours ligne : bloque les pavés multi-lignes
• Modération IA ✨ Premium : analyse IA de la toxicité (slider 1-10)

Modal de configuration par règle :

Clique sur l'icône clé à molette d'une règle pour ouvrir son modal :

• Seuils : sliders/inputs spécifiques à la règle
• Rôles ignorés : ces membres ne déclenchent pas la règle
• Salons ignorés : la règle ne s'applique pas dans ces salons
• Mode silencieux : l'action est appliquée mais pas d'embed public

Escalation des sanctions :

Définis des paliers : « 3 violations → mute 5 min », « 5 → kick », etc. Free = 1 palier max ; Premium = illimité.

Détecte les vagues de joins suspectes et kick automatiquement les nouveaux arrivants.

Configuration (dashboard) :

• Seuil de joins : combien de membres déclenchent l'alerte (ex : 10)
• Fenêtre : période d'observation en secondes (ex : 10 s)
• Presets : 🟢 Permissif (20/30s), 🟡 Équilibré (10/10s), 🔴 Strict (5/5s)

27 events Discord trackés avec embed coloré dans les salons configurés :

Catégories :

• Messages : delete, edit, bulk-delete
• Modération : bans, kicks, warns, automod, ban manuels
• Membres : join, leave, role changes, nickname, avatar
• Serveur : channels, rôles, voice, emojis/stickers, invites

Filtres globaux :

• Ignorer les bots
• Ignorer les membres avec « Gérer le serveur » (cache les actions admin)
• IDs ignorés : utilisateurs / rôles / salons à exclure (un par ligne)

Rétention : 30 jours en Free, 1 an en Premium. Archive interne consultable depuis l'Audit Log dashboard.

Page /dashboard/<id>/audit-log avec 2 onglets :

• 🛡️ Discord (natif) : l'audit log natif Discord (perm View Audit Log requise)
• 🤖 Modération bot : archive interne du bot (modlog, automod, tickets), avec filtres par kind

Permission : Modérer des membres

/analyze member membre:@user
/analyze export membre:@user(opt) → CSV ✨
/analyze server → audit IA du serveur ✨

• member : analyse comportementale d'un membre (warns, messages, recommandation)
• export ✨ Premium : exporte warns + actions de modération en CSV
• server ✨ Premium : audit IA du serveur (note /10, bons/mauvais points, conseils)

Quota Free : 3 analyses/jour. Premium : illimité.

Envoie un message + carte image quand un membre rejoint / quitte.

Variables disponibles :

• {user} : mention du membre
• {username} : pseudo
• {server} : nom du serveur
• {membercount} : nombre total de membres

Carte image :

Image générée automatiquement avec l'avatar du membre + texte personnalisé. Free : carte par défaut. Premium : background URL custom + couleur du texte + police custom + logo serveur.

Donne automatiquement 1 à 10 rôles aux nouveaux membres.

⚠️ Le bot doit avoir Gérer les rôles et son rôle doit être au-dessus des rôles à attribuer.

Système d'XP par messages : 15-25 XP par message, cooldown 1 min/user.

Commandes :

/level rank membre:@user
/level top → top 10

Premium :

• Rôles récompense : donne un rôle automatiquement quand un membre atteint le niveau X (option « retire les précédents » pour un système de ladder)
• Multiplicateurs XP : week-end x2, soirée x1.5, etc.
• Message de level-up custom

Système d'économie complet : monnaie locale, daily/weekly/monthly, work/crime/rob, banque, gambling, lottery, shop.

Commandes principales :

/eco balance · /eco daily · /eco weekly · /eco monthly
/eco work · /eco crime · /eco rob @user · /eco give
/eco deposit · /eco withdraw · /eco leaderboard
/shop list · /shop buy · /shop sell
/inventory · /gamble coinflip|slots|blackjack✨|roulette✨
/lottery info · /lottery buy ✨

Phrases du bot :

Personnalise ce que le bot dit pour /work, /crime, etc. via /dashboard/<id>/economy/phrases. Free : 1 phrase modifiable par catégorie. Premium : ajout illimité, tirage random à chaque commande.

Premium uniquement :

• Lottery : loterie communautaire avec tirage automatique
• Blackjack + roulette : jeux avancés (coinflip et slots restent Free)
• Jobs : métiers avec salaire horaire automatique

✨ Premium uniquement.

Crée des métiers avec salaire horaire automatique versé toutes les heures.

/jobs list                  → voir les jobs disponibles
/jobs apply name:Boulanger  → postuler
/jobs leave                 → quitter son job
/jobs info                  → voir son job actuel
/jobs create ...            → créer un job (admin)
/jobs delete ...            → supprimer un job (admin)

Options par job :

• Salaire/heure en pièces
• Niveau requis (système de leveling)
• Workers max (0 = illimité)
• Rôle requis pour postuler / Rôle accordé à l'embauche

Quêtes tirées au hasard chaque jour parmi 8 types : envoyer N messages, gagner au gambling, déposer en banque, acheter un item, etc.

/quests list           → voir tes quêtes du jour
/quests claim type:... → réclamer la récompense

Free : 1 quête/jour. Premium : 5/jour. Récompenses en pièces.

Système de tickets style TicketTool avec panneau public, catégories, transcripts.

Setup :

1. Active le module via le dashboard ou /ticket enable
2. Crée des catégories (ex : Support, Partenariat, Plainte) : Free : 1 max, Premium : illimité
3. Configure les salons logs + transcripts
4. Déploie le panneau public : /ticket panel channel:#tickets

Commandes in-ticket :

/ticket close raison:<texte> → ferme (lecture seule, pas de delete)
/ticket reopen               → ré-active un ticket fermé
/ticket transcript           → re-générer le transcript
/ticket add @user            → ajouter qqn au ticket
/ticket remove @user         → retirer qqn du ticket
/ticket delete               → supprimer définitivement

Premium :

• Transcripts HTML stylés + lien public 7j (au lieu de .txt brut)
• Macros :/macro add/use pour des réponses pré-écrites
• Stats par staff :/ticket-stats + page dashboard
• Forms personnalisés : Modal Discord avant ouverture du ticket
• SLA + relances auto : ping le staff si pas de réponse depuis N min

Lance des giveaways avec tirage automatique à la fin. 100% gratuit.

/giveaway start prize:<texte> duration:24h winners:1 channel:#salon
/giveaway list
/giveaway end id:<n>      → terminer manuellement
/giveaway reroll id:<n>   → re-tirer (max 3)
/giveaway cancel id:<n>   → annuler sans gagnant

Requirements optionnels :

• role_required : rôle obligatoire pour participer
• min_level : niveau de leveling minimum
• min_account_age_days : anti-comptes neufs

Tu peux aussi tout faire depuis le dashboard.

Crée des embeds visuels via le dashboard ou /embed. Tous les champs Discord sont supportés (titre, description, fields, footer, image, etc.).

Free : palette de 8 couleurs imposées. Premium : couleur libre.

Donne des rôles via réaction emoji. Idéal pour des notifs opt-in, des langues, etc.

Setup :

1. Active le mode dev Discord (Paramètres → Avancé → Mode développeur)
2. Envoie un message dans ton serveur (par ex. via l'embed builder)
3. Clic droit sur le message → Copier l'ID
4. Sur le dashboard, ajoute la reaction-role : salon + ID message + emoji + rôle

Free : 3 messages max. Premium : illimité.

Crée des commandes !nom avec une réponse customisable.

Variables :

• {user} : mention
• {username} : pseudo
• {server} : nom du serveur

Markdown Discord supporté (gras, italique, code blocks, liens auto-embed).

Free : 5 max. Premium : illimité + variables avancées.

Programme des messages à envoyer plus tard (ponctuel ou récurrent).

/schedule add ... · /schedule list

Le bot vérifie toutes les 30s et envoie les messages dûs.

Génère une structure de serveur complète avec l'IA : catégories, salons, rôles, permissions. Tout est éditable avant déploiement.

Workflow :

1. Décris ton serveur en français (ex : « serveur gaming pour CoD avec staff, vocal, annonces »)
2. L'IA propose la structure (vue temps réel pendant la génération)
3. Édite tout (renomme, ajoute, supprime, change permissions)
4. Déploie d'un clic : le bot crée tout en prod
5. Undo/redo possible si jamais

Quota Free : 1 génération/semaine. Premium : illimité + lane prioritaire + templates illimités.

✨ Premium uniquement. Le bot répond aux messages avec une personnalité configurable.

6 personnalités prédéfinies :

• 😊 Amical (défaut)
• 🎩 Sérieux & professionnel
• 😏 Sarcastique
• 🎮 Gaming
• 💖 Mignon (kawaii)
• 🛠️ Custom :écris ton propre prompt système

Le bot retient les 20 derniers messages du salon comme contexte.

✨ Premium uniquement. Audit IA de l'organisation de ton serveur.

L'IA analyse channels/rôles/permissions/modules actifs et te donne :

• Note sur 10
• Résumé général
• 3-5 bons points
• 3-5 mauvais points à améliorer
• 3-5 conseils concrets et actionnables

Throttle : 1 audit toutes les 5 minutes pour éviter le spam de quota IA.

✨ Premium uniquement.

• Couleurs custom des embeds : primary / success / error / warning
• Logo serveur sur les cards bienvenue / au revoir
• Polices custom sur les cards (14 polices websafe)

✨ Premium uniquement. Snapshot quotidien de la structure de ton serveur (rôles + channels + permissions).

• Backup automatique toutes les 24h (rolling window de 7)
• Backup manuel à la demande
• Restauration : recrée les rôles + channels manquants, met à jour les noms si différents
• Backup pré-restore automatique avant l'opération (rollback safe)

⚠️ Ne restaure PAS les messages (Discord ne le permet pas). Ne touche pas aux managed roles (bots).

Connecte-toi via Discord OAuth sur /dashboard. Tu ne verras que les serveurs où tu as la perm Manage Server ET où le bot est présent.

La sidebar regroupe les modules par catégorie :

• Vue d'ensemble + Aide
• Modération : Shield, Anti-raid, Warns, Logs, Audit log
• Engagement : Bienvenue, Au revoir, Auto-rôle, Leveling, Économie, Jobs ✨, Tickets, Giveaways, Stats
• Création : Embed builder, Reaction roles, Commandes custom, Messages programmés, Forge
• Avancé : Historique, Maintenance, Chatbot ✨, Analyseur ✨, Branding ✨, Backups ✨

Toutes les modifs sont locales jusqu'à ce que tu cliques « Enregistrer » sur la save bar qui apparaît en bas de l'écran.

• Annuler → revient à la dernière version sauvegardée
• Naviguer ailleurs sans sauvegarder = la save bar tremble pour te rappeler

Le Premium se vend via Bonzai en abonnement mensuel.

Plans :

• Mensuel 1 slot : 1 serveur Premium
• Mensuel 3 slots : 3 serveurs (avec discount)
• Mensuel 5 slots : 5 serveurs (max discount)
• Annuel 1 slot : 1 serveur, ~2 mois offerts

Comment activer :

1. Va sur /dashboard/premium
2. Choisis ton plan, paye via Bonzai
3. Le serveur passe automatiquement en Premium
4. Si tu as plusieurs slots, tu peux les assigner à différents serveurs

Codes Premium :

Si tu as reçu un code (gift / partenaire), utilise /premium activate code:<code> dans le serveur. Réservé au propriétaire du serveur Discord.