ivx-character-factory

Files (1)

• SKILL.md

SKILL.md (first lines)

# IntelliVerseX Character Factory

## Overview

The Character Factory uses the Content-Factory AI pipeline to generate production-ready 2D game characters from text descriptions. Every output conforms to IntelliVerseX SDK schemas (`character-meta-v1`, `sprite-spec-v1`) and is directly importable into Unity, Unreal, Godot, Defold, Roblox, or any engine that reads sprite sheets.

```
Text Description
       │
       ▼
┌── Content-Factory ──────────────────────────────┐
│  LLM prompt engineering → Fal Nano Banana Pro   │
│  → Per-cell rembg (isnet-anime) → Alpha harden  │
│  → IVX Schema Export → S3 Upload                │
└──────────────────────┬──────────────────────────┘
                       │
                       ▼
              SDK-Valid Output
     character.json  (character-meta-v1)
     sprites/*_spec.json  (sprite-spec-v1)
     sprites/*.png  (horizontal strips)
     expressions/expressions_front.png
     views/front.png, thumbnail.png
```

## Content-Factory API

### Trigger via MCP

```
trigger_pipeline character_2d --game_id my-game --character "A brave robot named Bolt with glowing blue eyes, pixel art style"
```

### Trigger via REST

```bash
curl -X POST http://localhost:8001/pipelines/character_2d \
  -H "Content-Type: application/json" \
  -d '{
    "game_id": "my-game",
    "characters": [
      {
        "name": "Bolt",
        "description": "A brave robot with glowing blue eyes and a jetpack",
        "style": "pixel_art"
      }
    ],
    "ivx_export": true
  }'
```

### Trigger via Python

```python
from pipelines.animation.character_2d import Character2DAnimationPipeline

pipeline = Character2DAnimationPipeline()
result = await pipeline.run({
    "game_id": "my-game",
    "characters": [{"name": "Bolt", "description": "A brave robot..."}],
    "style": "pixel_art",
    "ivx_export": True,
})
```

## Generated Output

### Folder Structure

```
characters/Bolt/
├── sprites/
│   ├── idle.png              # 6-frame horizontal strip (3072×512)
│   ├── walk.png              # 6-frame strip
│   ├── run.png               # 6-frame strip
│   ├── jump.png              # 4-frame strip
│   ├── attack.png            # 6-frame strip
│   ├── hurt.png              # 3-frame strip
│   ├── death.png             # 4-frame strip
│   └── cast.png              # 5-frame strip
├── expressions/
│   └── expressions_front.png # 3×2 grid: neutral, happy, sad, angry, surprised, thinking
├── emotional_states/
│   ├── determined.png
│   ├── happy.png
│   ├── legendary.png
│   ├── proud.png
│   ├── sad.png
│   └── sleeping.png
├── promo/
│   ├── app_icon.png          # 1:1
│   ├── thumbnail.png         # 16:9
│   ├── key_art.png           # 16:9
│   └── social_banner.png     # 3:1
├── topic_skins/
│   ├── anime.png
│   ├── sport.png
│   └── holiday.png
└── ivx/                      # SDK-compliant exports
    ├── character.json         # Validates: character-meta-v1
    ├── sprites/
    │   ├── idle_spec.json     # Validates: sprite-spec-v1
    │   ├── walk_spec.json
    │   ├── run_spec.json
    │   ├── jump_spec.json
    │   ├── attack_spec.json
    │   ├── hurt_spec.json
    │   ├── death_spec.json
    │   └── cast_spec.json
    └── views/
        ├── front.png
        └── thumbnail.png
```

## SDK Schema Compliance

### character.json (character-meta-v1)

```json

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

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