metaverseDubai/PROJECT_SETTINGS.md

# Project Settings - Dubai Metaverse

## Overview

This document details all Unreal Engine 5.4 project settings required for the Dubai Metaverse project. These settings enable Nanite, Lumen, World Partition, and other critical features.

## Accessing Project Settings

**Path**: `Edit > Project Settings` in Unreal Editor

## Engine Settings

### Rendering

**Path**: `Engine > Rendering`

#### Global Illumination

- **Dynamic Global Illumination Method**: **Lumen**
- **Reflection Method**: **Lumen**
- **Lumen Global Illumination**: **Enabled**
- **Lumen Reflections**: **Enabled**
- **Hardware Ray Tracing**: **Optional** (enable if RTX GPU available)

#### Shadows

- **Dynamic Shadows**: **Enabled**
- **Virtual Shadow Maps**: **Enabled**
- **Shadow Map Method**: **Virtual Shadow Maps**
- **Shadow Filtering Method**: **PCF 1x1** (or higher quality if performance allows)

#### Nanite

- **Nanite**: **Enabled**
- **Nanite Project Enabled**: **True**
- **Nanite Show**: **Enabled** (for debugging)

#### Anti-Aliasing

- **Default RHI**: **DirectX 12** (Windows)
- **Anti-Aliasing Method**: **Temporal Anti-Aliasing (TAA)**
- **Temporal Upsampling**: **Enabled**

#### Post-Process

- **Bloom**: **Enabled**
- **Auto Exposure**: **Enabled**
- **Motion Blur**: **Enabled** (optional, for cinematics)
- **Depth of Field**: **Enabled** (for cinematics)

### World Settings

**Path**: `Engine > World Settings`

#### World Partition

- **Enable World Partition**: **Enabled**
- **World Partition Grid Size**: **128** (meters)
- **Loading Range**: **Optimized per cell** (see streaming setup)
- **Data Layers**: **Enabled**

#### Streaming

- **Level Streaming Method**: **World Partition**
- **One File Per Actor**: **Enabled** (recommended)

### Engine > General Settings

#### Performance

- **Use Less CPU When in Background**: **Enabled**
- **Use Less GPU When in Background**: **Enabled**

#### Rendering

- **Forward Shading**: **Disabled** (use deferred)
- **Mobile HDR**: **N/A** (desktop project)

## Platform Settings

### Windows

**Path**: `Platforms > Windows`

#### Target Settings

- **Default RHI**: **DirectX 12**
- **Default Graphics RHI**: **DirectX 12**
- **Ray Tracing**: **Enabled** (if RTX GPU)

#### Packaging

- **Build**: **Shipping** (for final builds)
- **Build Configuration**: **PPBC_Shipping**
- **Compressed**: **True**

## Project Settings

### Project

**Path**: `Project`

- **Project Name**: **Dubai Metaverse**
- **Company Name**: **[Your Company]**
- **Copyright Notice**: **[Copyright Info]**
- **Description**: **High-end interactive Dubai Metaverse demo district**

### Maps & Modes

**Path**: `Project > Maps & Modes`

- **Editor Startup Map**: **Maps/Main/MainLevel** (or your main level)
- **Game Default Map**: **Maps/Main/MainLevel**
- **Default Modes**: **Default** (or custom game mode)

### Engine > Rendering (Project-Specific)

#### Lumen

- **Lumen Scene Lighting Quality**: **Epic** (or lower if performance issues)
- **Lumen Scene Detail**: **High** (or lower if performance issues)
- **Lumen Reflections Quality**: **Epic** (or lower if performance issues)

#### Virtual Shadow Maps

- **Virtual Shadow Map Resolution**: **2048** (or higher if performance allows)
- **Virtual Shadow Map One Pass Projection**: **Enabled**

#### Nanite

- **Nanite Max Pixels Per Edge**: **4.0** (default)
- **Nanite Max Pixels Per Edge (Post Process)**: **4.0** (default)

## Console Variables

### Important Console Commands

Add these to `Config/DefaultEngine.ini` under `[SystemSettings]`:

```ini
[SystemSettings]
; Lumen Settings
r.Lumen.DiffuseIndirect.Allow=1
r.Lumen.Reflections.Allow=1
r.Lumen.ScreenProbeGather.ScreenSpaceBentNormal=1

; Nanite Settings
r.Nanite.ProjectEnabled=1

; Virtual Shadow Maps
r.Shadow.Virtual.Enable=1
r.Shadow.Virtual.OnePassProjection=1

; Performance
r.MotionBlurQuality=4
r.BloomQuality=4
```

## Configuration Files

### DefaultEngine.ini

**Location**: `Config/DefaultEngine.ini`

Key sections to configure:

```ini
[/Script/Engine.RendererSettings]
r.DefaultFeature.AutoExposure=False
r.DefaultFeature.Bloom=True
r.DefaultFeature.MotionBlur=True
r.DefaultFeature.LumenSupport=1
r.Nanite.ProjectEnabled=True
r.Shadow.Virtual.Enable=True

[/Script/Engine.WorldSettings]
bEnableWorldPartition=True
```

### DefaultGame.ini

**Location**: `Config/DefaultGame.ini`

```ini
[/Script/EngineSettings.GameMapsSettings]
GameDefaultMap=/Game/Maps/Main/MainLevel
EditorStartupMap=/Game/Maps/Main/MainLevel
```

## World Partition Configuration

### Cell Size

- **Default**: 128m x 128m
- **Adjustment**: Can be adjusted based on world size and performance

### Streaming Setup

1. **Create Data Layers**:
   - Buildings
   - Props
   - Vegetation
   - Lighting
   - Vehicles
   - NPCs

2. **Set Up Streaming Volumes**:
   - Define loading/unloading distances
   - Optimize per cell

3. **Configure Cell Loading**:
   - Set loading range for each cell
   - Test streaming performance

## Performance Settings

### Scalability Settings

**Path**: `Engine > Rendering > Scalability`

#### View Distance

- **Epic**: Maximum
- **High**: High
- **Medium**: Medium
- **Low**: Low

#### Anti-Aliasing Quality

- **Epic**: TAA High
- **High**: TAA
- **Medium**: FXAA
- **Low**: None

#### Shadow Quality

- **Epic**: Virtual Shadow Maps High
- **High**: Virtual Shadow Maps
- **Medium**: Cascaded Shadow Maps
- **Low**: Basic shadows

#### Post-Process Quality

- **Epic**: Maximum
- **High**: High
- **Medium**: Medium
- **Low**: Low

#### Texture Quality

- **Epic**: Maximum
- **High**: High
- **Medium**: Medium
- **Low**: Low

#### Effects Quality

- **Epic**: Maximum
- **High**: High
- **Medium**: Medium
- **Low**: Low

#### Foliage Quality

- **Epic**: Maximum
- **High**: High
- **Medium**: Medium
- **Low**: Low

## Validation Checklist

After configuring settings, verify:

- ✅ Nanite is enabled and working
- ✅ Lumen GI and Reflections are active
- ✅ Virtual Shadow Maps are enabled
- ✅ World Partition is enabled
- ✅ Project compiles without errors
- ✅ Performance is acceptable in test level
- ✅ All required plugins are enabled

## Performance Targets

### Frame Rate Targets

- **Development**: 30+ FPS in editor
- **Play**: 60-90 FPS in packaged build
- **Cinematic**: Offline rendering (no FPS target)

### Memory Targets

- **GPU Memory**: <12GB VRAM usage
- **System RAM**: <16GB usage
- **Streaming**: Optimized per World Partition cell

## Troubleshooting

### Settings Not Applying

- **Solution**: Restart editor after changing settings
- **Solution**: Verify settings in correct .ini file
- **Solution**: Check for conflicting settings

### Performance Issues

- **Solution**: Lower scalability settings
- **Solution**: Disable hardware ray tracing if not needed
- **Solution**: Reduce Lumen quality settings
- **Solution**: Optimize World Partition streaming

### Nanite/Lumen Not Working

- **Solution**: Verify GPU supports required features
- **Solution**: Check DirectX 12 is enabled
- **Solution**: Update GPU drivers
- **Solution**: Verify settings are enabled in project settings

---

**Version**: 1.0
**Last Updated**: [Current Date]