日本語 | 中文 | Español | Français | हिन्दी | Italiano | Português (BR)

Headless, canon-bound sprite pipeline — 8-direction pixel-art packs for 2.5D RPGs

---

Sprite Foundry is a local-only asset pipeline that generates, reviews, and exports 8-direction pixel sprites with normal and depth maps. It drives ComfyUI for generation with ControlNet morphology control (8 body classes), SQLite for lifecycle tracking, and Godot 4.6 for finish-lab lighting verification — all controlled from a single CLI.

The sprite packs this factory produces are published to npm under the @sprite-foundry scope, from the sprite-foundry-packs monorepo. This repo is the factory; that repo is the storefront.

Architecture

Subject Sheet ──► ComfyUI Generation ──► Mechanical Gates
                  (SDXL + LoRA +          (transparency,
                   ControlNet)             dimensions, count)
                                                │
                                                ▼
                                        Raw/Pixel Review
                                                │
                                                ▼
                                    Normal + Depth Map Gen
                                                │
                                                ▼
                                     Godot Finish Lab
                                     (4 lighting states)
                                                │
                                                ▼
                                      Deterministic Export
                                      (manifest + checksums)

Roster

92 production export packs across 12 lanes:

Monster Lane

Non-humanoid creatures use body-class-specific ControlNet depth guides instead of the standard humanoid skeleton. Each body class has its own depth reference silhouette, ControlNet strength, and timing parameters.

Depth guides are joint-free primitives (blobs, pillars, columns) that lock in mass and orientation without dictating skeleton or limb placement. The body_class field in character configs auto-selects the correct preset:

# Body class auto-resolved from config
python -m pipeline.foundry_gen_morph --config pipeline/chars/beast_rat_king.json

# CLI override
python -m pipeline.foundry_gen_morph --config pipeline/chars/beast_rat_king.json --body-class tall_thin

Export Contract v1.0.0 (frozen)

exports/{subject_slug}/{run_id}/
├── albedo/    8 × 48px transparent PNGs
├── normal/    8 × matching normal maps
├── depth/     8 × matching depth maps
├── preview/   contact sheet
└── manifest.json  (schema v1.0.0, SHA-256 checksums, provenance)

• 8 directions: front, front_left, left, back_left, back, back_right, right, front_right
• 48×48 transparent PNG, center_bottom pivot
• Consumers validate schema_version: "1.0.0" before loading

Prerequisites

• Python 3.11+
• ComfyUI running locally (for generation)
• Godot 4.6 (for finish lab rendering)
• NVIDIA GPU recommended (RTX 5090 / 32 GB tested; 16 GB minimum)

Quick Start

# Clone
git clone https://github.com/mcp-tool-shop-org/sprite-foundry.git
cd sprite-foundry

# Initialize the registry
python -m foundry init

# Register a subject
python -m foundry subject-add sera_vale "Sera Vale" --role crew --consumer my-game

# Check the full pipeline status
python -m foundry status

CLI Commands

Threat Model

Sprite Foundry is a local developer tool. It does not handle secrets, tokens, or credentials, and collects no telemetry. Network/filesystem footprint differs by subsystem:

foundry/ (the lifecycle-tracking CLI): does not access the network (ComfyUI runs on localhost). File operations are constrained to exports/, bakeoff/, boards/, derived/, and the SQLite registry. Subprocess calls are limited to ComfyUI's local API and Godot headless rendering.

3d-prerender/ (the mesh/retexture/render pipeline): does access the network — its jury scripts (pack_jury.py, sprite_jury.py, invocable via cli.py jury) send rendered character images to cloud-hosted vision models over Ollama's cloud API for QA scoring. Do not point the jury at images containing sensitive or unreleased material without accounting for that. File operations are NOT constrained to a subdirectory of this repo — 3d-prerender/config.py's defaults read/write rig model caches and working directories outside the repo (e.g. E:/AI-Models, a configurable working-copy path) by design, since this is a local generation pipeline, not a sandboxed tool; every path is overridable via an SF_* environment variable (see 3d-prerender/config.py).

License

MIT

---

Built by MCP Tool Shop