ivx-environment-generator

Files (1)

• SKILL.md

SKILL.md (first lines)

# IntelliVerseX Environment Generator

## Overview

The Environment Generator creates game-ready backgrounds, parallax layers, tilesets, skyboxes, and composed world scenes from text descriptions. Outputs follow the IntelliVerseX asset standard and include engine-specific import metadata for Unity, Unreal, Godot, and more.

```
Scene Description + Art Style
       │
       ▼
┌── Content-Factory ────────────────────────────────────┐
│  LLM Scene Planning → Image Gen (Fal/Stability)      │
│  → Layer Separation → Parallax Config → Tileset Cut   │
│  → World Composition → IVX Export → S3 Upload         │
└──────────────────────┬────────────────────────────────┘
                       │
           ┌───────────┼───────────┐
           ▼           ▼           ▼
      2D Parallax  Tilesets    3D Skybox
      Backgrounds  & Tiles     & HDRI
```

## Content-Factory API

### Trigger via REST

```bash
curl -X POST http://localhost:8001/pipelines/environment \
  -H "Content-Type: application/json" \
  -d '{
    "game_id": "my-platformer",
    "scenes": [
      {
        "name": "enchanted_forest",
        "description": "A mystical forest with glowing mushrooms, ancient trees, and firefly particles",
        "style": "pixel_art",
        "mode": "parallax",
        "layers": 5
      },
      {
        "name": "crystal_cave",
        "description": "Underground cave with luminescent crystals and an underground river",
        "style": "pixel_art",
        "mode": "parallax",
        "layers": 4
      }
    ],
    "ivx_export": true
  }'
```

## Generated Output

### Parallax Background

```
environments/enchanted_forest/
├── layers/
│   ├── layer_0_sky.png           # Furthest (slowest scroll)
│   ├── layer_1_mountains.png
│   ├── layer_2_trees_far.png
│   ├── layer_3_trees_mid.png
│   └── layer_4_foreground.png    # Nearest (fastest scroll)
├── composed/
│   └── preview.png               # Full scene preview
└── ivx/
    ├── scene.json                # Scene metadata
    └── parallax_config.json      # Layer scroll speeds + offsets
```

### Tileset

```
environments/dungeon/
├── tileset.png                   # Sprite atlas (16×16 or 32×32 cells)
├── tile_rules.json               # Auto-tile rules (Wang tiles / bitmask)
├── composed/
│   └── sample_map.png
└── ivx/
    ├── tileset_spec.json         # Cell size, columns, rows, categories
    └── tile_rules.json           # Engine-importable auto-tile rules
```

### 3D Skybox / HDRI

```
environments/space_station/
├── skybox/
│   ├── skybox_front.png
│   ├── skybox_back.png
│   ├── skybox_left.png
│   ├── skybox_right.png
│   ├── skybox_top.png
│   └── skybox_bottom.png
├── hdri/
│   └── environment.hdr           # For PBR lighting
└── ivx/
    └── skybox_spec.json          # Face map, resolution, format
```

## Scene Metadata (scene.json)

```json
{
  "id": "enchanted_forest",
  "name": "Enchanted Forest",
  "description": "A mystical forest with glowing mushrooms",
  "style": "pixel_art",
  "mode": "parallax",
  "resolution": { "width": 1920, "height": 1080 },
  "layers": [
    { "name": "sky",            "file": "layers/layer_0_sky.png",           "scroll_speed": 0.1, "z_order": 0, "tiled_x": true },
    { "name": "mountains",      "file": "layers/layer_1_mountains.png",     "scroll_speed": 0.3, "z_order": 1, "tiled_x": true },
    { "name": "trees_far",      "file": "layers/layer_2_trees_far.png",     "scroll_speed": 0.5, "z_order": 2, "tiled_x": true },
    { "name": "trees_mid",      "file": "layers/layer_3_trees_mid.png",     "scroll_speed": 0.7, "z_order": 3, "tiled_x": true },
    { "name": "foreground",     "file": "layers/layer_4_foreground.png",    "scroll_speed": 1.0, "z_order": 4, "tiled_x": true }
  ],
  "lighting": {
    "ambient_color": "#1a2b3c",

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

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