kludoku-art

The separate art repository for Kludoku. It holds the licensed source icons, David's kludoku-procgen generator, and the built runtime/ bundle the game serves at /ext.

The game (@onnie81/murdoku-spor) depends on @onnie81/kludoku-art and serves runtime/ straight out of node_modules, behind its LICENSED_ART gate. Publishing a new version here is all it takes to ship new art — the server redeploys automatically and picks up the dependency.

Layout

procgen/            the generator, verbatim
  procgen.py        deterministic variant + animation builder
  stylesheet.json   ALL art direction (rigs, presets, biome palettes)
  source/           licensed originals: objects/ animals/ tiles/
  out/              generated frames + metadata (gitignored — regenerable)
scripts/
  build_runtime.py  procgen/out + source/tiles -> runtime/ (terrain-kind
                    classification with hand-override table; drop list)
runtime/            the shipped bundle (committed):
  sprites/          3 frames per variant (p0/p1/p2)
  tiles/            biome ground tiles
  atlas.json        variant index: frames, anchor, fps, tags
  kinds.json        game terrain mapping: water/grass/sand/stone/floor
  pack.json         presence marker + counts (the game probes this)

Releasing a new art version

python3 procgen/procgen.py build      # regenerate (same seed = same art)
python3 scripts/build_runtime.py      # rebuild runtime/
git commit -am "art: <what changed>"
npm version minor                     # or patch
npm publish --access public

The game pins ^1, so any 1.x release is picked up on its next deploy (a game redeploy also rebuilds the Docker image, which reinstalls deps — publish the game, or rebuild it, after publishing art).

Notes

• tree__thezoocolor__* is on the drop list in build_runtime.py — the source icon carries small caption remnants. Clean procgen/source/objects/tree--thezoocolor.png, regenerate, and remove the drop entry to restore zoo-native trees.
• Terrain-kind assignments live in build_runtime.py (OVERRIDES) — edit there if a new tile classifies wrong, then rebuild.
• License scope (see LICENSE.md): single-tile object icons, obstacles, biome tiles only, alteration permitted. Nothing else from the books ships.