Marbles

# Marbles — guide streamer Marbles est une course éclair conçue pour l’overlay du stream. Elle s’affiche sur un seul côté de l’écran, laisse le reste du stream visible et se ferme automatiquement après l’annonce du vainqueur. ## Lancer une course - Depuis le dashboard streamer, lance **Course Marbles**. - Depuis le chat, utilise `!marble`, `!marbles` ou `!course`. Sans argument, la course reprend les préférences du streamer, avec l’inscription automatique par défaut. Le dashboard propose trois champs facultatifs pour surcharger l’inscription, la map et la longueur le temps d’une course. La commande chat accepte les mêmes raccourcis, dans n’importe quel ordre : - inscription : `join` pour demander `!join`, ou `auto` pour inscrire les viewers présents et toute personne qui écrit ensuite dans le chat ; - map : `aleatoire`, `orbite`, `ciel`, `canopee`, `abysses` ou `confiserie` ; - longueur : `courte`, `normale` ou `longue`. Le format court est le réglage par défaut : jusqu’à 90 secondes de course, un décompte de départ de 3,4 secondes et 8 secondes de résultats. En inscription manuelle, le délai par défaut est de 15 secondes à partir de deux participants. Les formats normale et longue portent la limite de course à 3 et 5 minutes. Les préférences déjà enregistrées restent prioritaires : sélectionne **Courte** pour profiter de ce format sur une installation existante. Par exemple, `!marble join canopee` ouvre une course manuelle dans la Canopée bondissante. `!marble auto ciel courte` inscrit automatiquement le chat sur une course courte dans le Ciel turbulent. En mode **Aléatoire**, les cinq biomes passent dans un ordre aléatoire sans répétition avant la fin du cycle. Le cycle suivant évite aussi de commencer sur le dernier biome joué. L’historique est conservé dans le `dataStorage` de l’application sur le channel, même entre deux lancements. Un biome choisi explicitement reste prioritaire et compte dans la rotation ; une course fermée avant le départ des billes ne compte pas. Le tracé est généré à nouveau à chaque course, quelle que soit sa longueur. `!marble confiserie` lance la Confiserie infernale : caramel élastique qui capture puis relâche les billes, chocolat qui les grossit et les alourdit temporairement, et balances dont le godet le plus lourd s’abaisse et libère son contenu. Les trois machines sont présentes au moins deux fois par course. Ce biome compte douze éléments propres : des bonbons volants, des gommes bondissantes, des guimauves qui soufflent par rafales et des barbes à papa vivantes animent le parcours. Les tablettes se cassent au deuxième impact ; macarons, roues et dômes donnent des rebonds francs. Les captures restent brèves : 0,75 seconde pour le caramel et au maximum 1,5 seconde dans un godet de balance. En mode `join`, les viewers rejoignent avec `!join` ou depuis le plugin viewer. Dès qu’au moins deux billes sont inscrites, le compte à rebours d’inscription démarre puis la course part automatiquement. En mode `auto`, les viewers présents dans le chat sont inscrits au lancement et la course passe immédiatement au compte à rebours de départ ; s’il n’y a pas encore deux participants, elle démarre dès que la deuxième personne écrit dans le chat. La première bille qui franchit l’arrivée gagne. Le résultat reste affiché quelques secondes, le vainqueur est annoncé dans le chat, puis l’activité appelle `finish()` et disparaît de l’overlay. Chaque lancement joue une seule course ; l’historique des biomes assure la rotation entre les lancements. Après le vainqueur, la course attend les trois premiers arrivés, au maximum 8 secondes et sans dépasser la limite de course. Seules les billes ayant franchi l’arrivée obtiennent une médaille. Si personne n’arrive avant la limite, le classement à la progression départage les participants et le résultat l’indique explicitement. Une bille qui ne progresse plus pendant 8 secondes est replacée dans un passage libre ; une capture ou inversion de gravité en cours conserve sa durée prévue. Les modérateurs et le diffuseur peuvent utiliser `!start` pour partir avant la fin des inscriptions et `!end` pour fermer l’activité. La map, le mode d’inscription, la longueur de course, la durée des inscriptions et la durée d’affichage du vainqueur se règlent dans les préférences. Les parcours contiennent aussi des obstacles qui réagissent aux participants. Dans la Canopée, les billes font pencher les troncs à bascule et fissurent les barrages de brindilles jusqu’à leur rupture au troisième impact. Dans les Abysses, les crabes alternent les directions de sortie et les sas relâchent jusqu’à trois billes ensemble ; une bille isolée ressort automatiquement après 1,4 seconde. Dans le Ciel, les canons tirent selon leur orientation au moment de la sortie, et les voiles annoncent leurs rafales par une teinte dorée. En Orbite, les rails guident brièvement les billes sur une courbe et les anneaux déclenchent une onde après six passages. Les astéroïdes fragiles se fissurent puis cèdent au deuxième impact. Les quatre biomes décrits ci-dessus incluent au moins un exemplaire de chacun de leurs deux obstacles interactifs principaux ; la Confiserie garantit au moins deux exemplaires de chacune de ses trois machines. Leur répétition est limitée et répartie sur le parcours, y compris dans les formats longs. Ces interactions sont automatiques et restent inactives pendant le décompte. En cas d’embouteillage autour d’un crabe, son aiguillage relance les billes encore présentes après un court délai. La préférence **Position du plateau et de l’aide** utilise un plateau de 650 × 1080 sur un canvas 1920 × 1080, avec une zone d’aide séparée. Elle permet de déplacer l’activité sans déformer la map. Un changement de position ou de volume est appliqué immédiatement à l’overlay déjà affiché. Pendant la course, les pseudos suivent les billes avec une taille indépendante du zoom. Le parcours occupe toute la zone de jeu ; seul le chrono reste affiché dans un coin. Les billes arrivées restent prises en compte par la caméra pendant l’arrivée des suivantes. La grille de départ est mélangée à partir de la seed, indépendamment de l’ordre d’inscription. Les viewers peuvent refuser l’inscription automatique depuis la page Kappapps de l’application.