Unity Level Design

---

name: unity-level-design

description: Use when creating Unity game scenes and prototypes, building level designs, or automating Unity Editor workflows for terrain, lighting, environment setup, and player controllers. Use for post-apocalyptic scenes, fantasy forests, dungeon crawlers, and other game environments that need rapid prototyping.

---

# Unity Level Design

Overview

Rapidly prototype Unity game scenes using Editor automation, modern Unity APIs, and best practices for level design. This skill automates terrain generation, lighting setup, environment placement, and player controller creation to get you implementing gameplay ideas quickly.

When to Use

Use this skill when:

Core Workflow

Step 1: Research Current APIs

Before implementing, check Unity's latest APIs and best practices:

**Modern Unity Systems:**

**Key APIs to reference:**

Step 2: Scene Setup Automation

Use Editor scripts to automate repetitive setup:

// Example: Automated scene initialization
public static class SceneSetupHelper
{
    [MenuItem("Level Design/Create Basic Scene")]
    public static void CreateBasicScene()
    {
        // Setup lighting
        SetupLighting();
        
        // Create terrain
        CreateTerrain();
        
        // Setup post-processing
        SetupPostProcessing();
        
        // Create player
        CreatePlayerController();
    }
}

Step 3: Terrain Generation

**Options:**

1. **Unity Terrain** - Best for natural landscapes

2. **Mesh Generation** - Best for stylized/architectural

3. **Procedural Generation** - Best for endless/replayable worlds

Step 4: Environment & Props

Automate placement of:

Step 5: Player & Gameplay

Create basic:

Scene Types

Post-Apocalyptic Scene

Fantasy Forest

Dungeon Crawler

Quick Reference

| Task | Method | API/Tool |

|------|--------|----------|

| Create Terrain | Editor script | `Terrain.CreateTerrainGameObject` |

| Sculpt Terrain | Noise/heightmaps | `TerrainData.SetHeights` |

| Add Vegetation | Tree/Grass painting | `TerrainData.treeInstances` |

| Setup Lighting | URP/HDRP | `UniversalAdditionalLightData` |

| Post-Processing | Volume components | `Volume` + profiles |

| Player Controller | Character Controller | `CharacterController` component |

| Procedural Meshes | Runtime generation | `Mesh` class |

Editor Tools

See `scripts/` for automation tools:

References

See `references/` for detailed documentation:

Common Mistakes

Example Usage

// Create a post-apocalyptic scene
[MenuItem("Level Design/Post-Apocalyptic Scene")]
static void CreatePostApocalypticScene()
{
    // 1. Create terrain with noise
    var terrain = TerrainGenerator.CreateRuinedTerrain();
    
    // 2. Setup dramatic lighting
    LightingSetup.CreateDramaticLighting(Color.gray * 0.3f);
    
    // 3. Add fog and post-processing
    PostProcessingSetup.CreateAtmosphericFog();
    
    // 4. Scatter debris and props
    EnvironmentPainter.ScatterDebris(50);
    
    // 5. Create player
    var player = PlayerSetup.CreateFPSPlayer();
    player.transform.position = new Vector3(0, 5, 0);
}