electron-rare/le-mystere-professeur-zacus
1
0
Fork 0
Code Issues 1 Pull Requests 2 Actions 1 Packages Projects Releases Wiki Activity

feat: gamebook authoring + demo + bump fw #180

Merged
electron merged 1 commits from feat/gamebook-content into main 2026-06-19 12:32:39 +00:00
Conversation 0 Commits 1 Files Changed 4
+298 -1
electron commented 2026-06-19 12:32:17 +00:00
Owner
Copy Link
Copy Source

YAML gamebook + say->SD generator + Zacus demo adventure; bumps ESP32_ZACUS for gamebook mode.

YAML gamebook + say->SD generator + Zacus demo adventure; bumps ESP32_ZACUS for gamebook mode.
electron added 1 commit 2026-06-19 12:32:17 +00:00
feat: gamebook authoring + demo + bump fw
Repo State / repo-state (pull_request) Failing after 35s
Details
Repo State / repo-state (push) Failing after 40s
Details
Validate Zacus refactor / validate (pull_request) Failing after 5m58s
Details
Validate Zacus refactor / validate (push) Failing after 7m16s
Details
05c4c11c0b 
Context:
The new firmware gamebook mode needs a book on the Freenove SD, plus a
reusable way to author one. We also want a playable demo to prove the
whole chain (button -> navigation -> WAV narration from SD -> screen).

Approach:
Author the book in a human-friendly YAML; a generator renders each
passage's narration with macOS say (16 kHz mono, canonical WAV — the
Apple FLLR chunk is stripped so the firmware parser decodes it),
emits a compact gamebook.json, and stages WAVs + JSON onto the master
SD via POST /game/file?path=sd/gamebook/.

Changes:
- game/gamebooks/zacus_demo.yaml: a branching mini-adventure (the
  Professeur Zacus lab) — 8 passages, 3 endings.
- tools/gamebook/build_gamebook.py: reusable/idempotent generator
  (--book/--ip/--sd-dir/--dry-run); ASCII-folds on-screen text (fonts
  have no accents) while the WAV keeps the accented narration; choices
  carry label + goto (navigation is generic, D-pad + click).
- .gitignore: ignore the generated WAV pack (tools/gamebook/build/).
- Bump ESP32_ZACUS to the gamebook-mode firmware.

Impact:
Authors can write a gamebook in YAML and stage it to the Freenove in
one command; the bundled demo plays end to end, fully offline.
electron merged commit 05c4c11c0b into main 2026-06-19 12:32:39 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
bug
Something isn't working
 codex
documentation
Improvements or additions to documentation
 duplicate
This issue or pull request already exists
 enhancement
New feature or request
 gate:cheap
Cheap/local gate required
 gate:ci
CI gate required
 gate:live
Live hardware gate required
 good first issue
Good for newcomers
 help wanted
Extra attention is needed
 invalid
This doesn't seem right
 question
Further information is requested
 rc:final
RC final cycle
 rc:test
RC test execution cycle
 risk:blocker
RC blocker
 sprint:s1
Sprint 1
 sprint:s2
Sprint 2
 sprint:s3
Sprint 3
 sprint:s4
Sprint 4
 sprint:s5
Sprint 5
 squad:a-core
Firmware Core squad
 squad:b-ui
UI/Protocol squad
 squad:c-qa
QA Release squad
 squad:d-ops
Ops CI/Docs squad
 wontfix
This will not be worked on
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
electron (Clément Saillant)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: electron-rare/le-mystere-professeur-zacus#180
Delete Branch "feat/gamebook-content"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?