# AGENT.md — PixelForge Sprite Pack Integration Spec

Read `manifest.json` first for machine-readable paths, dimensions, baselines, and hitboxes.

## Invariants
- **4×4 Sheets:** `processed/sprite-sheet-96-transparent.png` (`384×384`, `96×96` cells) and `processed/sprite-sheet-48-transparent.png` (`192×192`, `48×48` cells).
- **Row order (top → bottom, rows 0..3):** `down`, `left`, `right`, `up`.
- **Column order (left → right, cols 0..3):** `neutral`, `left_step`, `neutral`, `right_step`.
- **Idle frame:** Hold column `0` (`neutral`) of the last movement direction when velocity is zero.
- **Timing & filtering:** `135 ms/frame` (`~7.41 FPS`, or `8 FPS` in integer engines). **Always** use `Nearest` / `Point` texture filtering (`image-rendering: pixelated` on web) — never bilinear.
- **Do NOT flip X in code:** Row 1 (`left`) and Row 2 (`right`) are dedicated rows.
- **Foot baseline & collider:** Feet rest at `y=90` (`96px` cells) / `y=45` (`48px` cells). Recommended lower-body collider: `{x:24, y:44, w:48, h:46}` at `96px` (`{x:12, y:22, w:24, h:23}` at `48px`).

## Engine Quick-Wire
- **Godot 4 (`AnimatedSprite2D`):** Set Project Settings → Canvas Textures → Default Texture Filter = `Nearest`. Slice `processed/sprite-sheet-96-transparent.png` at `4×4` into `walk_down` (0..3), `walk_left` (4..7), `walk_right` (8..11), `walk_up` (12..15) at `8 FPS`.
- **Unity 6 / 2D:** Texture Type `Sprite (2D and UI)`, Sprite Mode `Multiple`, PPU `96`, Filter Mode `Point (no filter)`, Compression `None`. Grid-slice `96×96`.
- **Phaser 3:** `this.load.atlas('hero', 'processed/sprite-sheet-96-transparent.png', 'processed/phaser/atlas_96.json')` or `this.load.spritesheet('hero', 'processed/sprite-sheet-96-transparent.png', { frameWidth: 96, frameHeight: 96 })` with `pixelArt: true`.
- **RPG Maker MV / MZ:** Copy `processed/rpgmaker/$character.png` (`144×192`, 3×4 `48px` cells, keep the `$` prefix) directly into `img/characters/`.
