pico8-games

Personal PICO-8 game collection by Yosef Ben Abraham, built on a shared engine.

Structure

• luminary/ — shared engine (state machine, fx, audio, save, debug), pulled into each game via PICO-8 #include.
• games/ — one folder per game: toms, alefstar, mastermind.
• tools/ — build & minification (shrinko8).
• docs/ — foundation plan, roadmap, audio brief.

Games

• Tom's Long Night — action platformer (combo + day cycle); LUMINARY testbed.
• AlefStar — Hebrew alphabet learning game with real spaced repetition (SM-2).
• Mastermind (working title) — deduction puzzle: reverse-engineer a hidden rule.

Build

Source of truth is each game's .p8 text cart (with #include of LUMINARY modules). The .p8.png is a build artifact — never the source.

./tools/build.sh toms   # -> games/toms/build/

Requires shrinko8 (see tools/README.md).

Versioning

Two independent SemVer lines: the engine (LUMINARY) and each game. See docs/ROADMAP.md and docs/PLANO-GERAL.md.

License

MIT — see LICENSE.