Documentation Koda

Guide complet — configuration, commandes, fonctionnalités et Premium

🚀 Démarrage rapide

Mets Koda en place en 3 étapes :

1

Invite le bot sur ton serveur

Clique sur ce lien d'invitation et sélectionne ton serveur. Le bot demande les permissions nécessaires.

2

Configure avec /config ou le Dashboard

La commande /config te redirige directement vers le Dashboard web pour une synchronisation en temps réel.

3

Teste le bot

Utilise /ping pour vérifier que le bot répond, puis explore les commandes avec /help.

💡 Conseil : Pour fonctionner pleinement, le bot doit avoir la permission Administrateur ou, au minimum, Gérer le serveur, Envoyer des messages, Intégrer des liens, Lire l'historique.
⚙️ Configuration — Dashboard

Le Dashboard web centralise tous les paramètres. Accède-y sur /dashboard après connexion Discord.

  • Langue — Français, Anglais, Espagnol ou Allemand
  • Rôle Booster XP — Reçoit 2× l'XP (pour les boosters)
  • Canal XP — Où les montées de niveau sont annoncées
  • Réinitialiser — Remet tous les paramètres à zéro
💡 Un badge en haut du Dashboard indique le tier du serveur : 🆓 Free / 💎 Premium / 👑 Premium+. Le Premium s'active par serveur — tous ses membres et admins en profitent.
  • Canal Bienvenue / Au Revoir — Où envoyer les messages d'arrivée et de départ
  • Message personnalisé — Variables disponibles : {user} {username} {guild} {count}
  • Demande Pseudo — Canal pour les demandes de pseudo
💎 Premium débloque la personnalisation embed (titre, couleur, image/GIF, footer, ping membre) pour la bienvenue ET le départ.
👑 Premium+ ajoute le MP de bienvenue automatique personnalisé.
  • AutoMod — Activer/désactiver, action (warn/mute/kick/ban), durée du mute
  • Détections — Spam, majuscules excessives, invitations non autorisées
  • 💎 Anti-Raid — Détecte les arrivées massives de comptes suspects (Premium requis)
  • 💎 Seuil & Fenêtre — X arrivées en Y secondes → alerte
  • 💎 Âge minimum — Comptes plus jeunes que N jours = suspects
  • 💎 Action — Lockdown, Kick ou Ban automatique
  • Canal Logs — Où envoyer les événements de modération
  • 9 types configurables — Bannissements, expulsions, avertissements, modifications de rôles, etc.
  • Horodatage — Tous les logs incluent date et heure précises
💬 Commandes

Toutes les commandes utilisent le format slash (/commande).

/pingVérifie la latence du bot
/helpListe toutes les commandes disponibles
/configOuvre le lien vers le Dashboard web Admin
/infoInformations sur le bot et le serveur
/statusStatut des services Koda
/reportSignale un bug ou un problème
/suggestionPropose une amélioration
/warnAvertit un membre Admin
/muteRéduit un membre au silence Admin
/unmuteLève le mute d'un membre Admin
/kickExpulse un membre du serveur Admin
/banBannit un membre Admin
/unbanLève le bannissement Admin
/clearSupprime des messages en masse Admin
/warnsListe les avertissements d'un membre
/rankAffiche ton niveau et ton XP actuel
/leaderboardClassement XP du serveur
/xp-giveDonne de l'XP à un membre Admin
/xp-removeRetire de l'XP à un membre Admin
/xp-resetRemet à zéro l'XP d'un membre Admin
/premiumAffiche ton statut Premium et les avantages
/premium-activateActive un code Premium sur ce serveur Admin
/antilienGère la whitelist Anti-Lien Admin
🎯 Système de Niveaux (XP)

Koda dispose d'un système de niveaux automatique et flexible.

📈

Auto

XP gagné à chaque message envoyé

🎨

Carte stylée

Carte de niveau générée à la montée

📢

Annonce

Canal configurable pour les level-up

⚡

2× Booster

Rôle Booster reçoit 2× l'XP

Formule de progression

XP nécessaire = 5 × (niveau³ + 15 × niveau² + 10 × niveau)

Exemples

NiveauXP requis (cumul)
1 → 2~100 XP
5 → 6~1 500 XP
10 → 11~8 500 XP
20 → 21~43 000 XP
💡 Les bots n'accumulent pas d'XP. Les messages en spam (moins de 60 s entre deux) ne comptent pas non plus.
🛡️ Sécurité — AutoMod & Anti-Raid

Protection automatique contre le spam, les invitations et les raids.

Ce que détecte l'AutoMod (Free)

🔁 SpamMessages répétés trop rapidement
🔤 MajusculesPlus de 50 % en majuscules
🔗 InvitationsLiens d'invitation non autorisés
📝 Flood texteMessages anormalement longs
🚫 Mentions@everyone / @here abusifs

Actions disponibles

ActionEffet
SupprimerMessage supprimé silencieusement
AvertirMessage supprimé + avertissement envoyé
MuteMessage supprimé + timeout automatique
KickMembre expulsé
BanMembre banni

Anti-Raid Premium

  • Détecte les arrivées massives de comptes suspects en temps réel
  • Paramètres : seuil (X arrivées), fenêtre (Y secondes), âge minimum des comptes
  • Actions : Lockdown du serveur, Kick ou Ban automatique
  • Canal d'alerte configurable pour notifier les admins
💡 Crée des canaux/rôles en whitelist pour que l'AutoMod ne les affecte pas (configurable sur le Dashboard, onglet Sécurité).
💎 Premium & 👑 Premium+

Le Premium est lié à un serveur Discord. Une fois activé, tous les membres et admins de ce serveur en profitent. Un abonnement = un serveur.

💎

Premium

Embeds bienvenue/départ et Anti-Raid

👑

Premium+

Tout Premium + MP bienvenue automatique

Fonctionnalités détaillées

FonctionnalitéFree💎 Premium👑 Premium+
AutoMod basique✅✅✅
Système XP & Niveaux✅✅✅
Logs modération✅✅✅
Embed bienvenue/départ custom❌✅✅
Anti-Raid❌✅✅
MP bienvenue automatique❌❌✅
🔒 Si tu tentes de modifier des champs Premium sans le tier requis via le HTML, le serveur API rejette silencieusement ces valeurs. Le statut Premium est l'autorité côté serveur.
💎 Découvrir les offres Premium
🎫 Tickets
Configuration en bêta

Les administrateurs peuvent configurer les tickets depuis l’onglet Tickets du dashboard ou depuis /config. Dès que le salon du panneau et le rôle staff sont choisis, Koda publie le panneau; les changements d’embed le synchronisent automatiquement.

Choisis le salon du panneau, la catégorie, le rôle staff, le salon de logs, la mention à l’ouverture, le texte et la couleur de l’embed.

Les horaires d’ouverture et le message personnalisé de fermeture sont réservés aux serveurs Premium+.

La configuration est en bêta : vérifie les permissions du bot sur les salons choisis.

❓ Questions fréquentes
Comment ajouter le bot à mon serveur ?▼
Utilise le lien d'invitation, sélectionne ton serveur et autorise les permissions demandées. Le bot doit avoir les permissions Administrateur ou les permissions minimales listées dans la section Démarrage rapide.
Le bot ne répond pas, que faire ?▼
Vérifie que : 1) le bot est en ligne (/ping), 2) il a les permissions nécessaires dans le canal, 3) la commande est bien une commande slash (/). Si le problème persiste, contacte le support via /report.
Comment configurer les messages de bienvenue ?▼
Dashboard → onglet Messages. Sélectionne le canal et rédige ton message avec les variables {user}, {username}, {guild}, {count}. La personnalisation embed (couleur, image, footer) nécessite Premium.
Puis-je réinitialiser la configuration ?▼
Oui, Dashboard → onglet Général → bouton Réinitialiser Configuration. Tous les paramètres reviennent aux valeurs par défaut. L'action est irréversible.
L'XP ne monte pas, pourquoi ?▼
Vérifie que : 1) le système XP est activé dans le Dashboard, 2) l'utilisateur n'est pas muté, 3) les messages ne sont pas du spam (cooldown 60 s). Les bots ne reçoivent jamais d'XP.
Comment contacter le support ?▼
Utilise /report dans Discord, visite la page support, ou rejoint directement notre serveur Discord.
Le Premium est-il par serveur ou par compte ?▼
Le Premium est lié à un serveur Discord. Une fois activé sur un serveur, tous les membres et admins de ce serveur en profitent. Pour l'appliquer à plusieurs serveurs, il faut un abonnement par serveur.