Documentation

MedBotTV est un bot Twitch tout-en-un, configurable à 100 % depuis ce dashboard. Chaque chaîne a sa propre configuration : modules, commandes, alertes, overlays. Rien n'est codé en dur, tout se règle ici et s'applique en direct.

Ce que tu peux faire

• Chat : commandes natives et personnalisées, timers, citations, compteurs, clips.
• Modération : auto-modération et anti-raid avec Shield Mode automatique.
• Engagement : points et fidélité, giveaways, sondages, prédictions, mini-jeux, boutique de points, objectifs.
• Alertes : follow, sub, raid, bits, hype train et points de chaîne, dans le chat et en overlay.
• Song requests avec lecture automatique sur Spotify, et annonce du live sur Discord.

La connexion se fait avec ton compte Twitch. Ta chaîne et ton dashboard sont créés automatiquement à la première connexion.

1. Clique sur Se connecter avec Twitch en haut à droite.
2. Autorise l'application MedBotTV sur la page Twitch.
3. Tu arrives directement sur le dashboard de ta chaîne.

Étape indispensable : passe le bot modérateur de ta chaîne. Dans ton chat Twitch, tape la commande ci-dessous.

• /mod MedBotTV

Un bot modérateur peut écrire même en mode abonnés-seulement ou followers-only, n'est pas limité par l'anti-spam de Twitch, et peut appliquer les actions de modération (timeout, ban, clear).

1. Depuis la vue d’ensemble, choisis un module dans la barre latérale.
2. Active l'interrupteur en haut de la page du module.
3. Règle les options puis enregistre. Les changements s’appliquent au bot en quelques secondes.

Chaque module conserve sa configuration même désactivé : tu peux le couper temporairement sans rien perdre.

Gère les commandes natives (comme !so ou !uptime) et tes commandes personnalisées. Chaque commande a un cooldown, un niveau d'accès minimum et peut utiliser des variables.

• Commandes personnalisées : un déclencheur, une réponse, des variables dynamiques.
• Cooldown global et par utilisateur pour éviter le spam.
• Niveau d'accès : tout le monde, abonné, VIP, modérateur, ou streamer.
• !so <pseudo> envoie un shoutout vers un autre streamer (mod).

Envoie des messages programmés à intervalles réguliers : règles du chat, réseaux sociaux, rappels. Plusieurs timers tournent en rotation.

• Intervalle de temps réglable par timer.
• Seuil minimum de messages dans le chat pour éviter de parler dans le vide.
• Rotation entre les timers actifs.

Sauvegarde les meilleures punchlines du stream. Une citation enregistre aussi le jeu en cours et la date.

• !quote [id] : citation aléatoire ou précise.
• !addquote <texte> : ajoute une citation (mod).
• !editquote <id> <texte> et !delquote <id> : édite ou supprime (mod).

Des compteurs nommés (morts, fails, runs…) modifiables depuis le chat et affichables en overlay sur ton stream.

• Crée autant de compteurs que tu veux, chacun avec sa commande.
• Exemple : !deaths +1 incrémente, !deaths affiche la valeur.
• Chaque compteur a un overlay temps réel à mettre dans OBS.

Crée des clips à la volée depuis le chat, et automatiquement sur certains événements.

• !clip crée un clip du moment en cours.
• Clips automatiques sur événements : raid, hype train, etc.

Filtre automatiquement les messages indésirables avant qu'ils ne polluent le chat. Chaque filtre est réglable et les modérateurs sont exemptés.

• Anti-caps : limite les majuscules excessives.
• Anti-liens : bloque les liens non autorisés, avec liste blanche.
• Anti-spam : répétitions et messages identiques.
• Anti-émotes et anti-symboles : limite leur nombre par message.
• Mots interdits : liste personnalisée avec sanction au choix.

Protège la chaîne contre les vagues de bots et les raids hostiles, avec des réactions automatiques.

• Détection des vagues de follows et de comptes très récents.
• Détection de vagues de bots dans le chat.
• Activation automatique du Shield Mode de Twitch et du lockdown du chat.
• Commandes !shield et !lockdown pour déclencher la protection à la main (mod).

Réagit aux événements de ta chaîne par un message dans le chat, une alerte en overlay et un son.

• Événements : follow, sub et resub, gift sub, raid, bits, hype train, points de chaîne.
• Message de chat personnalisable par type d'événement.
• Overlay visuel et son joués sur ton stream via OBS.

Une monnaie interne à ta chaîne, gagnée en regardant le live. Elle alimente les mini-jeux et la boutique de points.

• Gain de points à la minute de visionnage, avec bonus de niveau.
• Suivi du watchtime total par viewer.
• !points : solde, !top : classement, !give <pseudo> <montant> : transfert, !watchtime : temps total.

Tirages au sort dans le chat, avec filtres et pondération.

• !giveaway start <mot-clé> <prix> ouvre le tirage, !giveaway end le clôture (mod).
• Filtres : abonnés, followers, ancienneté.
• Tickets pondérés pour favoriser certains viewers.
• !reroll tire un nouveau gagnant (mod).

Lance des sondages dans le chat ou via les points de chaîne, avec résultats en overlay temps réel.

• !poll start <titre> | A | B lance un sondage (mod).
• !vote <numéro> pour voter, !poll results affiche les résultats.
• Overlay des résultats mis à jour en direct.

Gère les prédictions Twitch natives, celles où les viewers misent leurs points de chaîne.

• !prediction start | lock | end | cancel pilote la prédiction (mod).
• Synchronisé avec les prédictions officielles de Twitch via l’API Helix.

Les viewers proposent des musiques depuis le chat. Une file est gérée et affichable en overlay.

• !sr <lien ou titre> ajoute une musique, !queue affiche la file.
• !skip passe la musique (mod), !wrongsong retire sa dernière demande.
• Modération de la file : durée maximale, nombre de vues minimum, demandes par viewer.

Avec Spotify

Sans Spotify, !sr gère une simple file de demandes. Avec un compte Spotify Premium connecté depuis la page Song Requests, les demandes s'ajoutent et jouent automatiquement sur ton Spotify. Garde Spotify ouvert et lancé.

Des jeux de chat où les viewers misent leurs points de fidélité.

• !gamble <montant|all> : pile ou face.
• !slots <montant|all> : machine à sous.
• !roulette <montant> <red|black|green> : mise sur une couleur.
• !duel <@pseudo> <montant> puis !accept : duel de points entre viewers.

Les viewers échangent leurs points de fidélité contre des récompenses que tu définis.

• !shop affiche les récompenses disponibles et leur coût.
• !redeem <récompense> échange les points contre la récompense.
• Récompenses, prix et stock configurables depuis le dashboard.

Une barre de progression vers un objectif de followers ou d'abonnés, à afficher en overlay sur le stream.

• Objectif de followers ou de subs avec valeur cible.
• Overlay temps réel qui se remplit automatiquement.

Annonce automatiquement le démarrage de ton live dans un salon Discord, via un webhook.

1. Crée un webhook dans le salon Discord voulu et copie son URL.
2. Colle l'URL dans le module et personnalise le message d'annonce.
3. À chaque passage en live, le bot poste automatiquement dans le salon.

Certaines commandes sont intégrées et toujours disponibles. Tu peux les activer/désactiver et changer leur niveau d'accès, mais pas les supprimer.

Utilitaires

• !commandes : liste les commandes disponibles.
• !uptime : durée du live, !titre : titre actuel, !jeu : catégorie en cours.
• !followage : depuis quand un viewer te suit.

Modération

• !ban <pseudo> [raison] et !unban <pseudo>.
• !timeout <pseudo> [durée] [raison] : exclusion temporaire.
• !clear : vide le chat.
• !commercial [durée] : lance une publicité (streamer).

Chaque commande a un niveau d'accès minimum, réglable par chaîne :

• Tout le monde, Abonné, VIP, Modérateur, Streamer (broadcaster).
• Un utilisateur a accès à une commande si son niveau est supérieur ou égal au niveau requis.
• Cooldowns global et par utilisateur configurables sur chaque commande.

Plusieurs modules fournissent un overlay à afficher sur ton stream : alertes, sondages, compteurs, giveaways, now playing, objectifs.

1. Va sur la page Overlays du dashboard et copie l’URL de l’overlay voulu.
2. Dans OBS, ajoute une Source navigateur et colle l’URL.
3. Tout se met à jour en temps réel, sans rafraîchir la source.

Le bot ne répond pas dans mon chat

Assure-toi de l'avoir passé modérateur (/mod MedBotTV) et que le module concerné est activé. Un compte bot tout neuf peut aussi devoir vérifier son e-mail côté Twitch.

Différence entre points et points de chaîne

Les points de Fidélité sont une monnaie interne au bot, que tu configures. Les points de chaîne (Channel Points) sont ceux de Twitch, utilisés par les modules Alertes, Sondages et Prédictions.

Faut-il être Affilié ?

Non pour la plupart des modules. Seuls les prédictions Twitch natives et les points de chaîne nécessitent l'Affiliation.

Une question, un bug, une suggestion ? Rejoins le serveur de support Discord, on t'aide directement.

https://discord.gg/loscripts