electron-rare/le-mystere-professeur-zacus

Files

T

Clément SAILLANT c2fc583bae Refactor scenario validation to support V2 schema and update related tests

- Updated `validate_scenario.py` to handle V2 scenario YAML files, introducing new required keys and validation logic.
- Added support for legacy V1 scenarios with an option to allow migration.
- Modified `run_content_checks.sh` to validate V2 scenarios and associated audio and printables manifests.

2026-03-05 19:29:48 +01:00

5.8 KiB

Raw Blame History

🤖🎩 Le Mystère du Professeur Zacus 🎩🤖

Bienvenue dans l’enquête la plus instable du multivers : indices imprimables, audio, modules électroniques intégrés, et un guide MJ qui ne bug jamais (sauf si tu l’imprimes en 3D).

⚛ L’électron rare — ⚡ unstable by design

Auteur : Clément SAILLANT

⚡ Pitch (30 secondes chrono)

Le Professeur Zacus a disparu. Son labo est sous tension : signaux audio, capsules d’indices, preuves imprimées… et un dispositif électronique indispensable qui réagit à chaque étape de l’enquête.

Les joueurs fouillent, recoupent, déduisent — comme une vraie équipe d’enquête, mais avec plus de blagues et moins de panique. Le MJ déroule une session fluide, avec des checkpoints et une fin satisfaisante (sauf si tu oublies le gâteau).

"Si tu trouves une LED qui clignote, c’est normal. Si elle te parle, c’est probablement un bug... ou le MJ qui s’ennuie."

✅ Ce que tu obtiens (concret, pas du vent)

Printables prêts à imprimer (indices, cartes, accessoires)
Guide Maître du Jeu (mise en place, script, solutions)
Audio (timers / ambiance / déclenchements)
Scénario YAML = source de vérité (durée/difficulté modulables)
Option électronique : ESP32/Arduino (UI, effets, interactions)

Tout est pensé pour être rejouable et facile à préparer. Même pour les MJ qui n’ont jamais touché un oscilloscope. "MJ : Maître du Jeu, mais aussi Maître du Jazz, Maître du Jenga, Maître du Juste Prix... à toi de choisir."

🕹️ Pour qui / durée / niveau de fun

Joueurs : 6–14 (recommandé), ou équipes de 2–4
Durée : 105 min (45 + 60, modulable selon le groupe)
Âge : famille / anniversaire (adaptable, sauf pour les robots)
Matériel : imprimante + modules électroniques (ESP32 + écran / interface tactile) pour piloter les phases de jeu

"Le mode ‘slow motion’ est réservé aux anniversaires avec trop de bonbons."

🎬 Démo

"Si tu croises un QR code dans les archives, scanne-le. Si tu croises un QR code sur ton gâteau, scanne-le aussi (on ne sait jamais)."

🧠 Comment ça marche (en 1 minute, ou 42 secondes si tu es pressé)

Source de vérité : le scénario YAML

Le scénario principal est dans game/scenarios/. Il pilote :

les étapes / stations,
les validations / codes,
les exports (briefs MJ, docs, manifestes).

Pipeline du repo

game/scenarios/*.yaml -> tools/ (validate + export) -> kit MJ / printables / audio -> hardware/firmware/

🧩 Démarrage rapide (MJ, version turbo)

"Si tu veux une expérience vraiment futuriste, branche un ESP32 sur ton chat. (Non, ne fais pas ça, mais l’idée est marrante.)"

Lis le guide MJ : kit-maitre-du-jeu/
Imprime les printables : printables/
Prépare l’audio : audio/
Prépare, câble et flashe l’électronique : hardware/ (un kit esp32-S3 avec écran est requis pour chaque partie)
Lance la partie 🎩

👉 FAQ / dépannage : docs/faq.md (aucune question idiote, sauf “où est le MJ ?”)

🛠️ Démarrage rapide (dev, version quantum)

"Astuce dev : Si tu valides le YAML sans erreur du premier coup, tu gagnes un badge ‘Zacus Quantum’ (à imprimer toi-même)."

Installer les validateurs :

bash tools/setup/install_validators.sh

Valider le scénario officiel :

python3 tools/scenario/validate_scenario.py game/scenarios/zacus_v2.yaml

Exporter un brief Markdown :

python3 tools/scenario/export_md.py game/scenarios/zacus_v2.yaml -o docs/exports/zacus_v2.md

Frontend canon (V2) :

cd frontend-scratch-v2
npm install
VITE_STORY_API_BASE=http://<esp_ip>:8080 npm run dev

🧾 Contenu du dépôt (repères galactiques)

"Ce dépôt est plus organisé que le bureau du Professeur Zacus (et ça, c’est pas peu dire)."

game/scenarios/              Scénarios YAML (source de vérité)
kit-maitre-du-jeu/           Guide MJ + solutions + script
printables/                  Cartes/indices + manifestes
audio/                       Manifestes audio + ressources
tools/                       Validation + export + génération
hardware/                    Firmware & accessoires électroniques (prérequis)
docs/                        Mini-site / FAQ / ressources

🧷 Visuels

"Si tu reconnais le prototype sur la photo, tu es officiellement un expert en électronique de fête."

🧑‍🎓 Licence

Code : MIT (LICENSE)
Contenu créatif (scénarios, docs, printables, assets) : CC BY‑NC 4.0 (LICENSE-CONTENT.md)

"Ce jeu est garanti sans IA malveillante, mais avec des enfants qui peuvent hacker le scénario à tout moment."

🤝 Crédits

"Merci à tous les MJ, enfants, parents, et robots qui ont testé ce scénario. Mention spéciale à ceux qui ont trouvé le twist avant la LED rouge."

Auteur : Clément SAILLANT
Signature : ⚛ L’électron rare — ⚡ unstable by design

"Ce projet a été validé par un oscilloscope, un grille-pain, et une IA qui adore les énigmes."

OpenGraph : assets/og.png (1200×630)

generation/story-ia : scénarios IA

5.8 KiB Raw Blame History Unescape Escape