ivx-asset-pipeline

Files (1)

• SKILL.md

SKILL.md (first lines)

# IntelliVerseX Asset Pipeline

## Overview

The Asset Pipeline provides a **Universal Asset Pipeline Standard** for any game project on any engine. It includes Python CLI tools for scaffolding 2D/3D characters, generating sprite sheets, and validating assets against JSON Schema definitions. All tools produce engine-agnostic output (PNG + JSON) that can be imported into Unity, Unreal, Godot, or any other engine.

```
tools/asset-pipeline/
├── scaffold_character.py      → Create 2D character folder + placeholders
├── generate_spritesheet.py    → Combine frames into sprite sheet + spec
├── validate_specs.py          → Validate sprite specs against schema
├── validate_character.py      → Full 2D character validation
├── validate_sound_manifest.py → Audio manifest validation
├── templates/                 → 10 copy-ready JSON templates
└── schemas/                   → 9 JSON Schema validation files
```

---

## 1. Requirements

```bash
pip install Pillow jsonschema
```

These are the only dependencies. All tools run with Python 3.8+.

---

## 2. 2D Character Scaffolding

### scaffold_character.py

Creates a complete character folder with placeholder PNGs, animation specs, and metadata — ready for artists to replace with real artwork.

```bash
# Minimal: mandatory animations only (idle, jump, hurt)
python tools/asset-pipeline/scaffold_character.py \
    --name Quizzy --output RemoteAssets/Characters/ --no-standard

# Standard: mandatory + standard animations (walk, run, attack)
python tools/asset-pipeline/scaffold_character.py \
    --name Quizzy --output RemoteAssets/Characters/

# Full: all tiers including extended (dance, wave, think, sleep, special, death, spawn)
python tools/asset-pipeline/scaffold_character.py \
    --name DragonLord --output RemoteAssets/Characters/ \
    --with-extended --rarity epic --tier 3
```

### Animation Tiers

| Tier | Animations | Required For |
|------|-----------|-------------|
| **Mandatory** | `idle`, `jump`, `hurt` | Every character |
| **Standard** | `walk`, `run`, `attack` | Playable characters |
| **Extended** | `dance`, `wave`, `think`, `sleep`, `special`, `death`, `spawn` | Premium/featured characters |

### Output Structure

```
Characters/Quizzy/
├── character.json          ← Metadata (rarity, tags, views, animations, sounds)
├── front.png               ← 512×512 front view placeholder
├── back.png                ← 512×512 back view placeholder
├── thumbnail.png           ← 128×128 thumbnail placeholder
└── sprites/
    ├── idle.png            ← Sprite sheet (3×2 grid, 6 frames)
    ├── idle_spec.json      ← Animation spec (fps, loop, layout, events)
    ├── jump.png
    ├── jump_spec.json
    ├── hurt.png
    ├── hurt_spec.json
    ├── walk.png            ← (if standard tier)
    ├── walk_spec.json
    └── ...
```

### character.json Format

```json
{
    "id": "Quizzy",
    "display_name": "Quizzy",
    "description": "Replace with Quizzy's description.",
    "rarity": "common",
    "unlock_method": "default",
    "unlock_cost": {},
    "tier": 1,
    "tags": [],
    "views": {
        "front": "front.png",
        "back": "back.png",
        "thumbnail": "thumbnail.png"
    },
    "animations": {
        "idle": { "tier": "mandatory", "frames": 6, "fps": 10 },
        "jump": { "tier": "mandatory", "frames": 4, "fps": 12 },
        "hurt": { "tier": "mandatory", "frames": 4, "fps": 10 }
    },
    "sounds": {
        "on_select": "sfx_character_select",
        "on_hurt": "sfx_character_hurt",
        "on_victory": "stinger_victory"
    }
}
```

---

## 3. Sprite Sheet Generation

### generate_spritesheet.py

Combines individual frame PNGs into a single optimized sprite sheet with companion `_spec.json`.

```bash
# Basic: combine idle frames into a sheet
python tools/asset-pipeline/generate_spritesheet.py \

From intelli-verse-x/Intelli-verse-X-SDK, MIT.

More from intelli-verse-x/Intelli-verse-X-SDK