Files
le-mystere-professeur-zacus/docs/index.md
T
Copilot f9827f4587 [WIP] Update README.md with enhanced French version and assets folder (#108)
🚀 Fusion galactique terminée !
J’ai compressé plus de fichiers que le cerveau d’un MJ sous caféine.
Cohérence validée, humour injecté, assets alignés…
Si tu trouves un bug, c’est sûrement un easter egg.
Prêt à embarquer pour Zacus 3000 — la seule enquête où même les robots rigolent !

(PS : Si tu merges, tu gagnes +10 points de charisme MJ)

* Fusion, nettoyage, docs, humour, style futuriste — PR #108 🚀

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Clément SAILLANT <108685187+electron-rare@users.noreply.github.com>
2026-02-26 01:39:30 +01:00

3.3 KiB
Raw Blame History

layout, title, description
layout title description
default Le Mystère du Professeur Zacus Une enquête scientifique immersive pour anniversaire (printables, audio, modules électroniques).

🎩 Le Mystère du Professeur Zacus

Couverture

Le Mystère du Professeur Zacus : une enquête scientifique immersive pour anniversaire, jouable en famille ou entre ami·e·s.

Scénarios modulaires (YAML), supports imprimables, audio, et accessoires électroniques (ESP32/Arduino).

hatScénarios modulaires
audioAudio & checkpoints
chipModules électroniques
flaskThème labo/science

Structure du projet

├── game/scenarios/*.yaml          Scénarios (source de vérité)
├── audio/manifests/*.yaml         Manifeste audio + fichiers associés
├── printables/manifests/*.yaml    Manifeste printables + PDF/PNG
├── hardware/firmware/esp32/       Firmware (lecture seule sans approbation)
├── tools/                         Outils Python (validation, export, génération)
├── docs/                          Guides + mini-site GitHub Pages
├── assets/                        Images (README / marketing)

Démarrage rapide

  1. Imprime les printables (cartes, indices).
  2. (Option) Flash les modules électroniques.
  3. Lis le scénario YAML et place les indices.
  4. Lance la partie et suis le guide MJ.

Guides & documentation


Licences


Assets

  • Couverture : assets/cover.png
  • OpenGraph : assets/og.png
  • Poster : assets/poster.png
  • Logo : assets/logo.png
  • Diagramme : assets/diagram.png
  • Aperçu printables : assets/printables.png

Démo

Démo


Jouer (MJ)

Checklist rapide

  1. Imprime les printables (cartes, indices).
  2. (Option) Flash les modules électroniques.
  3. Lis le scénario et place les indices.
  4. Lance la partie et suis le guide MJ.

👉 Voir aussi : FAQ (flash / SD / audio)


Développer / contribuer

Structure du dépôt

  • game/scenarios/ — scénarios (source de vérité)
  • audio/ — manifestes et ressources audio
  • printables/ — manifestes + PDF/PNG
  • tools/ — outils Python (validation, export)
  • hardware/firmware/esp32/ — firmware (lecture seule sans approbation)

Démarrage rapide

python3 -m pip install -r tools/requirements.txt
python3 tools/scenario/validate_scenario.py game/scenarios/mon_scenario.yaml

Visuels & matériel

Prototype

Printables

Diagramme


Licences

  • Code : MIT (LICENSE)
  • Contenu : CC BYNC 4.0 (LICENSE-CONTENT.md)