Initial commit: Complete project foundation with all documentation, scripts, and project structure
This commit is contained in:
Dubai Metaverse Team
322
PROJECT_SETTINGS.md
Normal file
322
PROJECT_SETTINGS.md
Normal file
@@ -0,0 +1,322 @@
|
||||
# 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]
|
||||
|
||||
Reference in New Issue
Block a user