RECALBOX × TWITCH × GAMERSMILE

Recalbox Chaos Stream : comment ça marche ?

Le principe est simple : pendant un live Recalbox, un événement Twitch peut aider le streamer, le piéger ou semer le chaos dans son jeu. Gamersmile transforme l’événement en ordre, puis un petit pont installé sur la Recalbox commande les cheats de RetroArch.

En une phrase Sub TwitchGamersmileRecalboxRetroArchEffet dans le jeu
À retenir : le streamer garde le contrôle. Il choisit les jeux, les codes disponibles, les catégories, les durées et les réactions aux différents Subs. Le spectateur ne peut pas injecter librement un code arbitraire dans la Recalbox.
LE CIRCUIT COMPLET

Ce qui se passe après un Sub

1

Twitch reçoit l’événement

Un nouveau Sub, un Sub offert ou un message de resub arrive sur la chaîne Twitch du streamer.

2

Gamersmile le reçoit

Twitch envoie l’événement à Gamersmile via EventSub. Gamersmile vérifie que la session Chaos du streamer est réellement en direct.

3

La règle du streamer s’applique

Selon le Tier et les réglages, l’événement devient Aide, Piège / Mort, Chaos ou Aléatoire.

4

Un effet compatible est choisi

Gamersmile choisit uniquement parmi les effets actifs de la bonne catégorie. Le champ « poids » permet de rendre certains effets plus ou moins fréquents.

5

La Recalbox récupère l’ordre

L’agent local interroge Gamersmile environ une fois par seconde. Aucun port entrant de la Recalbox n’a besoin d’être ouvert sur Internet.

6

Le bon jeu est vérifié

Si un nom de ROM attendu a été configuré, l’agent interroge RetroArch. Si le mauvais jeu est lancé, l’effet est refusé.

7

RetroArch active le cheat

Le pont sélectionne l’index du cheat dans le fichier current.cht et utilise la commande locale CHEAT_TOGGLE.

8

Le live voit le résultat

RetroArch affiche un message du type « Toto → Invincibilité ». Si une durée est prévue, le cheat est retiré automatiquement à la fin.

CÔTÉ SPECTATEUR / JOUEUR DU CHAT

Comment participer pendant le live

  1. Vérifie que le streamer a activé Chaos Stream.Le streamer doit avoir démarré sa session Chaos et indiqué quel jeu Recalbox est actif.
  2. Fais ton Sub directement sur Twitch.Le paiement et l’abonnement restent entièrement gérés par Twitch. Gamersmile ne vend pas le Sub.
  3. Le type de Sub détermine la réaction.Par exemple, le streamer peut décider : Tier 1 = Aide, Tier 2 = Piège, Tier 3 = Chaos. Ce n’est qu’un exemple : il peut changer ces règles.
  4. Gamersmile choisit un effet dans la catégorie.Exemples : invincibilité, vie supplémentaire, vitesse modifiée, dégâts augmentés, contrôles perturbés ou autre effet disponible pour ce jeu.
  5. L’effet apparaît dans la partie.Ton pseudo Twitch et le nom de l’effet peuvent être affichés directement dans RetroArch.
Tu n’as pas besoin d’un compte Gamersmile pour qu’un Sub Twitch déclenche un effet. Il faut simplement que le streamer ait correctement configuré et activé Chaos Stream.
CE QUE LE VIEWER PEUT CHOISIR

Nouveau Sub, gift et resub

ÉvénementQui choisit ?Résultat
Nouveau Sub Tier 1/2/3Le streamerCatégorie définie à l’avance pour chaque Tier.
Sub offertLe streamerCatégorie définie pour les gifts ; plusieurs effets possibles selon le nombre de Subs, avec plafond.
Resub sans commandeLe streamerLa règle « Resub » choisie dans sa console est utilisée.
Resub avec !aide / !helpLe viewerDemande la catégorie Aide.
Resub avec !mort / !killLe viewerDemande la catégorie Piège / Mort.

Les commandes sont lues dans le message de resub. Un message ordinaire envoyé dans le chat ne déclenche pas un cheat dans cette version.

EXEMPLES

Ce que cela peut donner en plein stream

🟢 Tier 1 → Aide

Julie s’abonne. Gamersmile tire « Invincibilité 20 secondes ». Le cheat est activé, le message apparaît à l’écran, puis l’invincibilité s’arrête automatiquement 20 secondes plus tard.

🔴 Tier 2 → Piège

Marc s’abonne. Le tirage choisit « Ennemis plus dangereux ». Le streamer doit survivre avec l’effet pendant la durée définie.

🟣 Tier 3 → Chaos

Un Tier 3 déclenche une catégorie aléatoire de cheats spécialement préparés par le streamer pour rendre la partie imprévisible.

🎁 Gift de 10 Subs

Le streamer a fixé un plafond de 3. Même si 10 Subs sont offerts, Gamersmile ne déclenche au maximum que 3 effets pour cet événement.

CÔTÉ STREAMER

Mettre Chaos Stream en place de A à Z

La première installation demande quelques minutes. Ensuite, pour les lives suivants, il suffit surtout de choisir le jeu, vérifier le pack et démarrer le Chaos.

PHASE 1

Préparer ton compte

  1. Crée/active ta page créateur Gamersmile.
  2. Ouvre Recalbox Chaos Stream.
  3. Relie ton compte Twitch.
  4. Autorise l’accès aux événements d’abonnement de ta propre chaîne.
PHASE 2

Préparer un jeu

  1. Ajoute le titre du jeu et le système.
  2. Renseigne si possible le nom exact de la ROM.
  3. Ajoute les cheats manuellement ou importe un fichier RetroArch .cht.
  4. Classe chaque effet : Aide, Piège / Mort ou Chaos.
PHASE 3

Régler les effets

  1. Donne un nom clair à chaque effet.
  2. Choisis une durée de 0 à 3600 secondes.
  3. Régle le poids/probabilité de 1 à 100.
  4. Désactive les codes que tu ne veux pas utiliser pendant ce live.
PHASE 4

Régler les Subs

  1. Choisis la réaction des Tier 1, 2 et 3.
  2. Choisis la réaction des Subs offerts.
  3. Choisis la réaction des resubs.
  4. Fixe le nombre maximal d’effets pour un gift multiple.
PHASE 5

Installer le pont Recalbox

  1. Génère un nouveau secret de pont.
  2. Télécharge gamersmile-chaos-install.sh.
  3. Copie-le sur la Recalbox.
  4. En SSH, lance sh /recalbox/share/gamersmile-chaos-install.sh.
  5. Redémarre le jeu/RetroArch après la première installation.
PHASE 6

Charger le pack

  1. L’agent écrit le pack dans /recalbox/share/system/gamersmile-chaos/current.cht.
  2. Dans RetroArch : Quick Menu → Cheats → Load Cheat File (Replace).
  3. Charge current.cht.
  4. Ne réordonne pas les cheats pendant le live.
PHASE 7

Tester avant le live

  1. Lance agent.sh start.
  2. Teste Aide, Piège et Chaos depuis Gamersmile.
  3. Vérifie que le bon cheat apparaît.
  4. Vérifie surtout que les effets temporaires se désactivent bien.
PHASE 8

Démarrer le Chaos

  1. Sélectionne le jeu actif.
  2. Vérifie que Twitch et le pont sont connectés.
  3. Clique sur Démarrer le Chaos Live.
  4. À partir de là, les événements Twitch autorisés peuvent entrer dans la file.
RÉGLAGES IMPORTANTS

Durée, probabilité et effets simultanés

Durée

15 s, par exemple, signifie que le cheat sera coupé automatiquement après 15 secondes. 0 s signifie qu’il reste actif jusqu’à l’arrêt, au PANIC ou à une autre action qui le désactive.

Poids

Le poids ne représente pas un pourcentage fixe. Il sert au tirage pondéré entre tous les effets éligibles de la même catégorie. Un effet de poids 50 sortira en moyenne plus souvent qu’un effet de poids 5.

Effet déjà actif

Si un même effet temporaire est déclenché de nouveau alors qu’il est encore actif, son échéance est repoussée à partir du nouveau déclenchement au lieu d’être simplement inversée.

Plusieurs effets

Des cheats différents peuvent rester actifs en même temps. Il faut donc tester les combinaisons : certains codes peuvent être incompatibles entre eux selon le jeu ou le core.

SÉCURITÉ & CONTRÔLE

La Recalbox n’est pas ouverte à Internet

Connexion sortante uniquement

L’agent Recalbox contacte Gamersmile en HTTPS. Aucun spectateur ne se connecte directement à la console.

RetroArch reste local

Les commandes réseau RetroArch sont envoyées sur 127.0.0.1:55355, donc à l’intérieur de la Recalbox.

Secret de pont

Le pont utilise un secret dédié. Si tu le régénères, l’ancien devient invalide. Ne publie jamais ce secret dans un live ou une capture.

Contrôle de ROM

Tu peux imposer un nom de ROM attendu. Si RetroArch ne signale pas ce jeu, l’événement est refusé au lieu d’appliquer un cheat au mauvais titre.

Perte de connexion

Après plusieurs contrôles de connexion échoués, l’agent coupe les cheats qu’il a activés afin d’éviter de laisser un effet permanent sans contrôle.

PANIC local

En cas de problème, exécute :
/recalbox/share/system/gamersmile-chaos/agent.sh panic
Cette commande ne dépend pas de Twitch ni de Gamersmile.

DÉPANNAGE RAPIDE

Si un Sub n’a aucun effet

  1. Le Chaos Live est-il démarré ? Un événement reçu lorsque la session est arrêtée n’est pas exécuté.
  2. Le bon jeu est-il sélectionné dans Gamersmile ? Le pack et les index dépendent du jeu actif.
  3. L’agent Recalbox tourne-t-il ? Utilise agent.sh status.
  4. current.cht est-il chargé dans RetroArch ? Sans ce pack chargé, CHEAT_TOGGLE n’active pas les bons codes.
  5. La ROM correspond-elle ? Si le contrôle de ROM est actif et que le nom ne correspond pas, l’effet est volontairement refusé.
  6. La catégorie contient-elle au moins un effet actif ? Si Tier 1 = Aide mais qu’aucun effet Aide n’est actif, Gamersmile ne remplace pas silencieusement l’aide par un piège.
  7. Le code fonctionne-t-il avec cette version du jeu ? Teste-le manuellement dans RetroArch avant de l’utiliser en live.
  8. Regarde le journal Gamersmile. Les événements récents indiquent s’ils sont en attente, exécutés ou en erreur.
FAQ

Questions fréquentes

Le spectateur doit-il avoir un compte Gamersmile ?

Non. L’interaction part de Twitch. Si la chaîne du streamer a activé Recalbox Chaos Stream, le Sub, le Sub offert ou le resub reçu par Twitch est transmis à Gamersmile puis au pont Recalbox du streamer.

Le spectateur choisit-il exactement le code qui sera lancé ?

Pas lors d’un nouveau Sub ou d’un Sub offert : le streamer choisit à l’avance la catégorie associée à chaque événement (Aide, Piège / Mort, Chaos ou Aléatoire). Lors d’un message de resub, le spectateur peut demander une catégorie avec !aide / !help ou !mort / !kill si le streamer laisse cette possibilité active.

Un gros cadeau de Subs peut-il lancer des dizaines d’effets ?

Le streamer fixe une limite. Par défaut, un cadeau multiple est plafonné afin d’éviter de rendre la partie injouable. Le plafond peut être réglé de 1 à 20 effets.

Est-ce que cela fonctionne avec tous les jeux Recalbox ?

Non, pas automatiquement. Le core RetroArch utilisé doit prendre en charge les cheats et le code doit correspondre à la bonne ROM, région et révision du jeu. Un code valide pour une version peut être sans effet sur une autre.

Les Bits, follows et messages ordinaires du chat déclenchent-ils des effets ?

Pas dans cette version. Recalbox Chaos Stream réagit aux événements Twitch de Sub, Sub offert et resub configurés par le streamer.

Que se passe-t-il si Gamersmile ou Internet tombe pendant le live ?

Le pont Recalbox effectue des contrôles réguliers. Après plusieurs échecs de connexion, il désactive les cheats qu’il pilote. Le streamer dispose aussi d’une commande PANIC locale qui ne dépend pas du site.

Une partie Chaos peut-elle être envoyée comme highscore Legit ?

Non. Une partie dans laquelle des cheats ont été déclenchés est une partie modifiée et ne doit pas être présentée comme un score Legit.

Highscores : Chaos Stream utilise volontairement des cheats. Une partie où Chaos a été actif ne doit pas être soumise comme Legit. Garde ce mode pour le spectacle, les défis communautaires et les streams interactifs.
PRÊT À TESTER ?

Le spectateur déclenche. Le streamer garde les règles.

Commence avec quelques effets simples et courts, teste-les hors live, puis augmente progressivement le niveau de chaos.