Quiz & Faucheuses

1. Première utilisation

La régie pilote le Quiz, les Faucheuses, la roue et les messages de chaque chaîne. Les jeux tournent sur le serveur ; OBS affiche leur résultat. Gardez le serveur et PostgreSQL démarrés pendant votre direct.

1. Décompressez le paquet dans un dossier dédié. Pour une mise à jour, gardez l’ancien dossier et copiez son .env dans le nouveau.
2. Lancez INSTALLER.bat pour installer les dépendances. Python 3.11+ et Node.js 22+ sont requis.
3. Configurez PostgreSQL avec CONFIGURER_POSTGRESQL.bat si nécessaire. Pour une mise à jour, lancez MIGRER_V12.bat : il sauvegarde avant de migrer.
4. Lancez DEMARRER.bat, puis ouvrez la régie locale. Avec un hébergement distant, utilisez l’adresse publique fournie par l’administrateur.
5. Connectez-vous avec votre compte de régie. Il est distinct de votre compte Twitch.

Premier compte administrateur, depuis le dossier du programme : .venv\Scripts\python.exe server.py --create-admin admin. Le mot de passe se saisit dans le terminal. Il n’existe pas de mot de passe universel livré avec le paquet.

Retour au sommaire ↑

2. Comptes et chaînes

L’administrateur du serveur crée les comptes streamers et les chaînes. Chaque streamer voit uniquement les chaînes qui lui sont attribuées.

Choisissez toujours la bonne chaîne dans la colonne de gauche avant une action. Un transfert de propriétaire change l’accès à la régie ; il ne connecte pas automatiquement un autre compte Twitch. Les réglages et profils de chaque chaîne restent séparés.

Retour au sommaire ↑

3. Connexion Twitch et compte bot

Connecter le streamer

1. Choisissez sa chaîne dans la régie.
2. Ouvrez Réglages → Connexion Twitch, puis Connecter Twitch.
3. Ouvrez le lien, saisissez le code et autorisez avec le bon compte streamer.
4. Revenez à la régie et actualisez l’état.

Cette autorisation relie la chaîne Twitch aux abonnements, Bits et autres événements. Si Twitch exige la double authentification, activez-la dans les paramètres de sécurité de ce compte Twitch.

Utiliser un bot dédié

1. Avec le compte administrateur de la régie, ouvrez Compte bot du serveur dans la barre latérale.
2. Saisissez le pseudo exact d’un compte Twitch dédié et cliquez sur Connecter le bot.
3. Autorisez avec ce compte bot, dans une fenêtre privée si votre navigateur est déjà connecté au streamer.
4. Sur chaque chaîne Twitch concernée, le streamer exécute /mod pseudo_du_bot.
5. Dans Réglages → Compte utilisé dans le chat, cochez le bot puis enregistrez.

Le bot lit les commandes, envoie les messages et supprime les commandes si cette option est activée. La connexion streamer reste utilisée pour ses événements. Un bot déconnecté ne bascule pas automatiquement vers le streamer. Pour revenir au streamer, décochez explicitement le choix du bot.

Retour au sommaire ↑

4. Avant et pendant le direct

1. Dans Vue d’ensemble, choisissez les jeux activés : Quiz, Faucheuses, les deux ou tout désactiver.
2. Cliquez sur Enregistrer les jeux. Les contextes de la chaîne redémarrent en conservant la progression persistante.
3. Ouvrez les liens OBS et vérifiez leur affichage.
4. Lancez un Quiz ou un boss selon votre animation.

Pause générale suspend les jeux, leurs horloges et les événements de jeu. Les messages automatiques du bot ont leurs propres interrupteurs dans Messages. Pour reprendre les jeux, cliquez sur Reprendre.

Le bouton Enregistrer les jeux concerne le Quiz, les Faucheuses et leur activation. Les autres blocs possèdent leur propre bouton d’enregistrement. La navigation entre rubriques conserve les modifications ; changer de chaîne peut les abandonner. Un avertissement protège les réglages de jeux non enregistrés.

Retour au sommaire ↑

5. Régler et animer le Quiz

Dans Quiz, réglez la durée des questions, la durée du cycle, l’XP et les options audio. Choisissez les thèmes à inclure, puis enregistrez les jeux. La banque fournie contient 11 018 questions. Une sélection de thèmes vide ne pose aucune question.

• Question à choix : les viewers répondent A, B, C ou D dans le chat.
• Question libre : ils écrivent directement leur réponse.
• Une tentative est comptée par question. Une réponse incorrecte consomme cette tentative.
• Le classement de cycle et la progression persistante sont distincts. Le détail des points dépend des options activées.

Ajouter vos questions

Utilisez les formulaires disponibles pour les questions sonores et les thèmes. Les options avancées JSON servent aux réglages moins courants. questionsJson définit une banque personnalisée de remplacement ; additionalQuestionsJson ajoute des questions à la banque utilisée.

Exemple d’objet question à placer dans une liste JSON :

{"id":"perso-001","theme":"Culture générale","difficulty":"Facile","question":"Combien de côtés possède un triangle ?","answers":["Deux","Trois","Quatre","Cinq"],"correct":"B"}

Questions avec son

1. Ouvrez le bloc de questions sonores, saisissez la question et ses réponses.
2. Importez votre extrait ou utilisez une URL audio compatible.
3. Ajoutez la question puis cliquez sur Enregistrer les jeux.
4. Vérifiez le volume dans les réglages Quiz et dans OBS.

Les sons importés sont stockés sur votre serveur dans PostgreSQL. Utilisez des médias que vous pouvez diffuser. Dans l’extension Twitch, les sons sont lancés manuellement par le spectateur.

Retour au sommaire ↑

6. Faucheuses et jeux simultanés

Dans Faucheuses, choisissez le boss, lancez ou arrêtez le combat et pilotez les attaques spéciales. Les six boss conservés sont Le Boucher, Lilith, Diablo, Rous, La Reine la cave et Kirito.

Les réglages sont regroupés par catégorie avec une recherche : apparence, sprites, combats, sons, commandes et progression. Enregistrez les jeux après modification. Le document COMMANDES_V108.md du paquet complète les commandes détaillées.

Avec Quiz + Faucheuses, les deux jeux peuvent fonctionner ensemble. La coordination facultative dans Réglages alterne leurs phases au lieu de les laisser simultanés. Les récompenses Quiz vers Faucheuses sont activables : XP, or, reliques, quotas et délai par joueur.

Énigme de boss nécessite les deux jeux actifs, une banque Quiz non vide et un boss en cours. Lancez le boss dans Faucheuses avant l’énigme. La première bonne réponse applicable produit l’effet configuré : dégâts, réduction d’armure ou soin.

Retour au sommaire ↑

7. Messages automatiques et nettoyage

Messages programmés

Dans Messages, activez le module, ajoutez le texte, choisissez son intervalle en minutes et activez chaque ligne voulue. Enregistrez. Le délai repart après l’enregistrement ; il n’y a pas de rafale de rattrapage.

Cochez la suspension en cas d’inactivité et réglez son délai pour ne pas parler dans un chat silencieux. Sans activité récente de spectateur, les timers attendent. Les messages du bot ne maintiennent pas artificiellement l’activité.

Abonnements, Bits et raids

Activez séparément les types de remerciement, adaptez leur texte et leurs seuils. Utilisez les variables proposées dans le formulaire. Ces messages concernent les nouveaux événements reçus, pas un historique rejoué.

Nettoyage des commandes

Cochez Supprimer les messages de commande après leur traitement. Le nettoyage concerne les messages commençant par ! suivi d’un nom de commande, y compris celles d’autres bots. Les réponses ordinaires au Quiz restent visibles.

Le compte chargé du chat doit autoriser la suppression ; reconnectez-le si l’autorisation manque. Les messages du streamer et des modérateurs sont conservés. Un refus ou une limite Twitch peut laisser un message visible ; les jeux continuent.

Retour au sommaire ↑

8. Roue du stream

1. Dans Roue, activez le module et configurez les cases, leur couleur, leur poids et leur activation.
2. Choisissez la durée du tirage, le maintien à l’écran, la taille et la position.
3. Réglez les commandes et leurs permissions, puis enregistrez.

Par défaut, !lanceroue lance le tirage et !cacheroue masque la roue. Ces commandes sont réservées aux modérateurs et au streamer par défaut. Vous pouvez changer leurs noms et permissions.

La roue de l’overlay apparaît lors du lancement, puis disparaît après son maintien ou la commande de masquage. L’aperçu dans la régie peut rester affiché pour faciliter les réglages. Masquer la roue ne supprime pas son délai entre deux tirages.

Retour au sommaire ↑

9. Overlay OBS et médias

1. Ouvrez Overlay OBS et récupérez le lien navigateur de la chaîne.
2. Dans OBS, ajoutez une source Navigateur, collez ce lien, puis réglez 1920 × 1080.
3. Dans l’éditeur, ajoutez vos éléments, déplacez-les, modifiez tailles, couleurs et calques.
4. Importez vos images sur le serveur ou renseignez une URL compatible. Appliquez/enregistrez le résultat avec le bouton du bloc.
5. Vérifiez l’ordre des calques, la visibilité et les volumes avant le direct.

Le lien OBS donne accès à l’affichage : ne le publiez pas. Le renouveler invalide l’ancien lien, que vous devrez alors remplacer dans OBS. Masquer le Quiz ou les Faucheuses dans la scène ne désactive pas forcément leur moteur ; utilisez le choix des jeux pour les arrêter.

Les médias importés sont sauvegardés avec PostgreSQL. Les fichiers ajoutés manuellement dans le dossier du programme doivent être conservés séparément lors d’une mise à jour.

Retour au sommaire ↑

10. Extension Twitch pour le Quiz

L’extension est un panneau sous le stream avec la question, les choix, une réponse libre si nécessaire, les médias et le classement. Les réponses utilisent les mêmes points et la même limite d’une tentative que le chat.

1. L’administrateur expose le serveur en HTTPS et crée une extension Panel dans la console développeur Twitch.
2. Il configure dans le .env son Client ID et son secret Extension, distincts de ceux de l’application du bot. Le secret ne quitte jamais le serveur.
3. Il lance PREPARER_EXTENSION_TWITCH.bat avec l’adresse HTTPS publique, puis dépose le ZIP généré en Hosted Test sur Twitch.
4. Dans Quiz → Extension Twitch du Quiz, le streamer active sa chaîne.
5. Le streamer active le panneau sur Twitch. Les spectateurs autorisent le partage d’identité pour répondre ; ils peuvent regarder sans le partager.

Le document EXTENSION_TWITCH.md du paquet donne les champs exacts, les tests et la procédure de soumission. La publication publique dépend de l’approbation Twitch. Un ZIP local n’active pas automatiquement une extension sur votre compte.

Le panneau suit l’horloge du serveur et se rafraîchit environ toutes les quatre secondes. La vidéo du stream peut être en retard. Les réponses arrivées après la fin sont refusées. Un nouveau joueur peut apparaître sous un nom provisoire jusqu’à son premier message dans le chat.

Retour au sommaire ↑

11. Joueurs, saisons et sauvegardes

Dans Joueurs, consultez classements et état des jeux. Une nouvelle saison crée un classement frais sans retirer les objets, l’or et l’XP permanents. Les classements historiques propres aux anciens moteurs restent distincts.

Les sauvegardes individuelles permettent de restaurer un profil. Une restauration remplace sa progression et son inventaire ; elle ne rembobine pas l’ensemble du combat ou de la chaîne.

Sauvegarder le serveur

L’administrateur peut lancer une sauvegarde PostgreSQL depuis l’administration du serveur. Conservez le fichier .dump dans un endroit privé : il contient aussi les informations de connexion Twitch stockées en base. Le programme pg_dump doit être installé et compatible avec PostgreSQL.

Avant une mise à jour, arrêtez l’ancien serveur et utilisez le lanceur de migration avec sauvegarde. Pour un retour en arrière exact, restaurez la sauvegarde dans une base distincte et adaptez le .env. Ne lancez pas deux versions en même temps sur le même schéma.

Retour au sommaire ↑

12. Résoudre les problèmes courants

Dans Réglages, les diagnostics donnent l’état du moteur, de PostgreSQL et de Twitch. Les formulaires de test simulent des événements mais modifient réellement les jeux : utilisez de préférence une chaîne de test.

Retour au sommaire ↑