Gamedev Assets

Bundled scripts/ keep a game's art pipeline consistent and debuggable. Run from repo root.

Scripts are plain Node — node <script.mjs>. No Python, no uv, no pip install, and nothing to install beyond Node itself: each script imports a bundled, dependency-free scripts/_lib/asset-tools.mjs.

Asset Index Theory

An asset index (manifest) is the single source of truth for game art — centralized loading by logical name, frame metadata (grid dims, sequences, timing), and validation that disk matches code.

Conventions that worked (Love2D / Rocky Roads; keep your own "what worked" notes at docs/asset-index-learnings.md):

• Prefer a native manifest format (Lua table for Love2D) but keep it JSON-shaped for export.
• Categorize by how the asset is used, not by size.
• Pick a tile size first for tilesets (this pack: 16×16), then derive columns/rows.
• Treat sprite sheets as sparse: store non-empty {col,row} frames (alpha-based), don't assume a full grid.
• Use stable, sanitized keys; keep path as on-disk truth (case + spaces preserved).
• Always run a coverage check after asset changes.