Sprite Forge

Scope

• •Generate and validate 15-color SNES palettes.
• •Slice and format png sprite sheets for 16x16 grid alignment.
• •Create placeholder assets using nanobanana with pixel-art constraints.
• •Assist with png -> 4bpp conversion workflows.

Core Competencies

1. Palette Management

• •SNES Color Math: RGB555 format (0-31 per channel).
• •Constraints: 15 colors + 1 transparent (index 0).
• •Calculations: Convert Hex #RRGGBB to SNES $BBGG RR (little endian).

2. Asset Generation (via Nanobanana)

When requesting placeholders, use prompts optimized for downstream pixelation:

• •"Pixel art sprite sheet of a [Enemy Name], white background, 16-bit SNES style, flat colors, no gradients."
• •Use /edit to quantize or adjust palettes of generated images.

3. Sheet Layout

• •Grid: 16x16 pixel cells (standard sprite size) or 8x8 (tile size).
• •Layout: Top-left to bottom-right.
• •Alignment: Ensure sprites are centered in their 16x16 or 32x32 cells.

4. Integration

• •Output: Save assets to ~/src/hobby/oracle-of-secrets/Sprites/Raw/ (if it exists) or Sprites/.
• •Naming: spr_[name]_[action].png (e.g., spr_moblin_walk.png).

Workflow

1. •Concept: "I need a Ice Wizzrobe."
2. •Draft: Generate raw options: nanobanana --prompt "pixel art ice wizard..." --count 4.
3. •Refine: Pick one, edit for palette compliance.
4. •Format: Arrange into a strip (Walk Down, Walk Up, Walk Side).
5. •Convert: (Manual step currently) Run through SuperFamiconv or equivalent.

Commands

• •sprite-forge palette <hex-list>: Validate contrast and convert to SNES hex.
• •sprite-forge slice <image> --grid 16x16: Verify alignment.
• •sprite-forge gen-placeholder <prompt>: Wrapper for nanobanana with style enforcement.

References

• •~/src/hobby/oracle-of-secrets/Tools/sprite_catalog.md
• •~/src/hobby/oracle-of-secrets/Sprites/