ivx-3d-character-pipeline

Files (1)

• SKILL.md

SKILL.md (first lines)

# IntelliVerseX 3D Character Pipeline

## Overview

The 3D Character Pipeline generates production-ready 3D game characters from text descriptions or 2D reference images. It produces rigged meshes, skeletal animations, blend shapes, and optionally renders 2D sprite sheets from 3D — all validated against IntelliVerseX SDK schemas (`character-3d-meta-v1`, `skeleton-v1`, `state-machine-v1`).

```
Input (text or image)
       │
       ▼
┌── Content-Factory ──────────────────────────────────┐
│  Mesh Gen (Trellis/Meshy) → MeshRigger (skeleton)   │
│  → AnimationApplicator (presets) → BlenderRenderer   │
│  → IVX Schema Export → S3 Upload                    │
└──────────────────────┬──────────────────────────────┘
                       │
            ┌──────────┼──────────┐
            ▼          ▼          ▼
         3D Mode    Hybrid     2D-Only
         GLB/FBX    FBX +      Sprite
         + anims    sprites    sheets
```

## Modes

| Mode | Output | Best For |
|------|--------|----------|
| `3d` | GLB mesh + rigged FBX + animation FBX clips | 3D games (Unity, Unreal, Godot 3D) |
| `hybrid` | All of 3D mode + Blender-rendered 2D sprite sheets | Games needing both 3D assets and 2D fallbacks |
| `2d` | 2D sprite sheets only (rendered from generated 3D) | 2D games wanting 3D consistency across views |

## Content-Factory API

### Trigger via MCP

```
trigger_pipeline character_3d --game_id my-game --mode hybrid --character "An armored knight with a glowing sword"
```

### Trigger via REST

```bash
curl -X POST http://localhost:8001/pipelines/character_3d \
  -H "Content-Type: application/json" \
  -d '{
    "game_id": "my-game",
    "mode": "hybrid",
    "characters": [
      {
        "name": "Knight",
        "description": "An armored knight with a glowing sword and heavy shield"
      }
    ],
    "actions": ["idle", "walk", "run", "attack", "hurt", "death"],
    "generate_expressions": true,
    "ivx_export": true
  }'
```

## Generated Output

### 3D Mode

```
characters/Knight/
├── mesh/
│   ├── Knight.glb                    # Generated mesh
│   └── mesh_spec.json                # Mesh generation metadata
├── rigged/
│   └── Knight_rigged.fbx             # Rigged with skeletal hierarchy
├── animations/
│   ├── idle.fbx                      # Per-action animation clips
│   ├── walk.fbx
│   ├── run.fbx
│   ├── attack.fbx
│   ├── hurt.fbx
│   └── death.fbx
└── ivx/                              # SDK-compliant exports
    ├── character_3d.json              # Validates: character-3d-meta-v1
    ├── skeleton.json                  # Validates: skeleton-v1
    ├── state_machine.json             # Validates: state-machine-v1
    ├── animations/
    │   ├── idle.glb
    │   ├── walk.glb
    │   └── ...
    └── textures/
        ├── T_Knight_Albedo.png
        ├── T_Knight_Normal.png
        └── T_Knight_ARM.png
```

### Hybrid Mode (adds sprites/)

```
characters/Knight/
├── ... (all 3D output above)
├── sprites/                          # Blender-rendered 2D sheets
│   ├── idle.png                      # Horizontal strip from 3D render
│   ├── walk.png
│   └── ...
└── ivx/
    ├── ... (all 3D schemas above)
    └── sprites/                      # 2D sprite specs
        ├── idle_spec.json            # Validates: sprite-spec-v1
        └── ...
```

## SDK Schema Compliance

### character_3d.json (character-3d-meta-v1)

```json
{
  "id": "Knight",
  "display_name": "Knight",
  "type": "3d_rigged",
  "rarity": "common",
  "version": "1.0.0",
  "mesh": {

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

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