Skip to content

COMMANDS.md

Latest commit

 

History

History
230 lines (174 loc) · 7.35 KB

COMMANDS.md

File metadata and controls

230 lines (174 loc) · 7.35 KB

📜 Liste des Commandes SerdaBot

🎮 Commandes Publiques

!ask <question>

Pose une question à l'IA du bot.

  • Exemple : !ask Quel est le meilleur jeu de 2024 ?
  • Cooldown : 60 secondes par utilisateur
  • Activée si : ask dans la config

!gameinfo <nom_du_jeu>

Récupère les informations d'un jeu (via IGDB/RAWG).

  • Exemple : !gameinfo Elden Ring
  • Cooldown : 60 secondes par utilisateur
  • Activée si : game dans la config

!donationserda / !serdakofi

Affiche les liens de donation/support pour El_Serda.

  • Cooldown : 60 secondes par utilisateur
  • Toujours activée

Mention du bot (Mode Chill)

Mentionne @serda_bot dans un message pour obtenir une réponse sarcastique à la El_Serda.

  • Exemple : @serda_bot tu penses quoi de ce jeu ?
  • Cooldown : 60 secondes par utilisateur
  • Activée si : chill dans la config

🛡️ Commandes Modérateur (MOD Only)

� Gestion des Roasts (Système Dynamique)

!addroast @username

Ajoute un utilisateur à la liste des cibles de roast.

  • Le bot détectera automatiquement cet utilisateur et activera le mode roast
  • Exemple : !addroast @el_serda

!delroast @username

Retire un utilisateur de la liste de roast.

  • Exemple : !delroast @el_serda

!listroast

Affiche la liste complète des utilisateurs roastables.

  • Exemple de sortie : Roastables (3): el_serda, serda, elserda…

!addquote <phrase>

Ajoute une citation/excuse typique d'un utilisateur roastable.

  • Ces citations sont injectées dans le prompt pour inspirer le bot
  • Exemple : !addquote J'avais dit 'juste un dernier run' il y a 3 heures
  • Limite : 180 caractères max

!delquote <index>

Supprime une citation par son index (voir !listquotes).

  • Exemple : !delquote 2

!listquotes

Affiche les citations enregistrées avec leurs index.

  • Exemple de sortie : Quotes: [0] J'avais dit 'juste un dern… | [1] Le café c'est de l'eau… (+3 de plus)

�📝 Gestion des Devs (Whitelist Traduction Auto)

!adddev @username

Ajoute un utilisateur à la whitelist de traduction automatique.

  • Les messages de ce dev seront automatiquement traduits EN→FR
  • Exemple : !adddev @john_dev

!removedev @username / !deldev @username

Retire un utilisateur de la whitelist de traduction.

  • Exemple : !deldev @john_dev

!listdevs

Affiche la liste complète des devs whitelistés pour la traduction.

  • Exemple de sortie : 📋 Devs whitelistés (3): @alice, @bob, @charlie

🚫 Gestion des Sites Bloqués (Anti-Spam Local)

!blocksite <nom_site>

Ajoute un site/mot-clé à la blacklist anti-spam locale du bot.

  • Les bots contenant ce mot dans leur nom ou message seront automatiquement timeout (60s)
  • Action : /timeout {user} 60 (message visible brièvement)
  • Exemple : !blocksite streamboo
  • Exemple : !blocksite primes4free

!unblocksite <nom_site>

Retire un site de la blacklist locale.

  • Exemple : !unblocksite streamboo

!blockedlist

Affiche tous les sites/mots-clés bloqués localement.

  • Exemple de sortie : 🚫 Sites bloqués (5): primes4free, streamboo, fakeviews, ...

🛡️ Gestion AutoMod Twitch (API Officielle)

⚠️ Nécessite les scopes OAuth : moderator:manage:blocked_terms, moderator:read:blocked_terms

!addbanword <mot>

Ajoute un mot/phrase à l'AutoMod Twitch natif.

  • Action : Message bloqué AVANT affichage (invisible dans le chat)
  • Synchronisé : Visible dans le dashboard Twitch
  • Support phrases : !addbanword "insulte grave" fonctionne
  • Exemple : !addbanword badword
  • Exemple : !addbanword phrase complète

!removebanword <mot>

Retire un mot de l'AutoMod Twitch.

  • Exemple : !removebanword badword

!banwords

Affiche tous les mots bannis dans l'AutoMod Twitch.

  • Exemple de sortie : 🚫 Mots bannis AutoMod (3): badword1, badword2, badword3

!automod <0-4>

Configure le niveau de l'AutoMod Twitch global.

  • 0 : Désactivé
  • 1 : Faible
  • 2 : Modéré
  • 3 : Élevé
  • 4 : Strict
  • Exemple : !automod 3
  • Effet : Configure les filtres de toxicité, insultes, spam, etc.

💡 Différence blocksite vs AutoMod :

Système Quand Visibilité Fichier
!blocksite Timeout après envoi Message visible brièvement blocked_sites.json (local)
!addbanword Bloque avant affichage Message invisible AutoMod Twitch (API)

🤖 Gestion des Bots (Whitelist/Blacklist)

!addwhitebot @bot_name

Ajoute un bot à la whitelist.

  • Effet : SerdaBot ne répondra jamais à ce bot (aucune commande, aucune réaction)
  • Utilité : Éviter les interactions bot-to-bot inutiles
  • Exemple : !addwhitebot @nightbot

!delwhitebot @bot_name

Retire un bot de la whitelist.

  • Exemple : !delwhitebot @nightbot

!addblackbot @bot_name

Ajoute un bot à la blacklist.

  • Effet : SerdaBot ignorera complètement tous les messages de ce bot
  • Différence avec whitelist : Plus strict, aucun traitement du message
  • Exemple : !addblackbot @spam_bot

!delblackbot @bot_name

Retire un bot de la blacklist.

  • Exemple : !delblackbot @spam_bot

!whitebots

Affiche tous les bots dans la whitelist.

  • Exemple de sortie : 📋 Bots whitelistés (2): @nightbot, @streamelements

!blackbots

Affiche tous les bots dans la blacklist.

  • Exemple de sortie : 🚫 Bots blacklistés (1): @spam_bot

🌐 Traduction Manuelle

!translate <texte> / !trad <texte>

Traduit manuellement un texte (détection automatique FR↔EN).

  • Auto-détection : Si le texte contient des mots français (le, la, les, de, du, un, une) → FR→EN, sinon → EN→FR
  • Exemple : !trad This is a test → 🇬🇧 This is a test / 🇫🇷 C'est un test
  • Exemple : !trad Ceci est un test → 🇫🇷 Ceci est un test / 🇬🇧 This is a test

⚙️ Configuration

Cooldown Global

Par défaut : 60 secondes entre chaque commande par utilisateur.

  • Configurable dans config.yaml : bot.cooldown

Commandes Activées

Les commandes peuvent être activées/désactivées dans config.yaml :

bot:
  enabled_commands:
    - ask      # Active !ask
    - game     # Active !gameinfo
    - chill    # Active les mentions du bot

Traduction Automatique

Activée/désactivée dans config.yaml :

bot:
  auto_translate: true  # Active la traduction auto pour les devs whitelistés

📊 Résumé

Type Nombre de commandes
Publiques 4
Modérateur (Roast) 6
Modérateur (Devs) 3
Modérateur (Anti-Spam Local) 3
Modérateur (AutoMod Twitch) 4
Modérateur (Bots) 6
Modérateur (Traduction) 2
TOTAL 28 commandes

🗂️ Fichiers de Données

Les listes sont sauvegardées dans data/ et config/ :

  • config/roast.json - Cibles de roast + citations (nouveau !)
  • data/devs.json - Whitelist devs pour traduction auto
  • data/blocked_sites.json - Sites/mots-clés bloqués (anti-spam)
  • data/bot_whitelist.json - Bots à ne pas répondre
  • data/bot_blacklist.json - Bots à ignorer complètement

Dernière mise à jour : 18 octobre 2025