metaverseDubai/docs/STREAMING_SETUP.md

World Partition Streaming Setup - Dubai Metaverse

Overview

This document describes the World Partition streaming configuration for the Dubai Metaverse project.

World Partition

Overview

World Partition is Unreal Engine 5's system for streaming large worlds efficiently. It divides the world into cells and streams them based on distance.

Configuration

Enable World Partition

1. Project Settings:

   • Edit > Project Settings > World Partition
   • Enable World Partition

2. Level Setup:

   • Convert level to World Partition
   • Configure cell size and settings

---

Cell Configuration

Cell Size

• Default: 128m x 128m
• Adjustment: Can be adjusted based on world size
• Consideration: Balance between streaming efficiency and cell granularity

Cell Organization

Data Layers

Organize content by system:

• Buildings: Building data layer
• Props: Prop data layer
• Vegetation: Vegetation data layer
• Lighting: Lighting data layer
• Vehicles: Vehicle data layer
• NPCs: NPC data layer

---

Streaming Volumes

Loading Volumes

Define areas where content loads

Setup

1. Create Volume:

   • Place > Volumes > World Partition Streaming Volume

2. Configure:

   • Set loading range
   • Assign data layers
   • Set priority

3. Placement:

   • Place around important areas
   • Overlap volumes for smooth transitions

---

Streaming Settings

Loading Range

• Default: 2-3 cells (256-384m)
• Adjustment: Adjust based on performance
• Optimization: Balance loading distance and performance

Streaming Budget

• Memory Budget: Set memory budget
• Streaming Budget: Set streaming budget
• Optimization: Optimize for target hardware

---

Performance Optimization

Streaming Optimization

1. Cell Size: Optimize cell size
2. Loading Range: Optimize loading range
3. Data Layers: Optimize data layer organization
4. Streaming Budget: Set appropriate budgets

Distance Culling

1. Cull Distance: Set cull distances for assets
2. LODs: Use LODs for distance-based detail
3. Streaming: Use streaming for large assets

---

Testing

Streaming Testing

1. Load Testing: Test loading performance
2. Streaming: Test streaming transitions
3. Performance: Test performance impact
4. Visual: Test visual quality

---

Troubleshooting

Common Issues

Issue: Streaming hitches

• Solution: Optimize loading range
• Solution: Reduce streaming budget
• Solution: Optimize asset sizes

Issue: Content not loading

• Solution: Check streaming volumes
• Solution: Verify data layer assignment
• Solution: Check loading range

---

Documentation

Streaming Documentation

Document streaming setup:

• Cell Size: Cell size configuration
• Data Layers: Data layer organization
• Streaming Volumes: Streaming volume placement
• Settings: Streaming settings

---

Version: 1.0 Last Updated: [Current Date]