# Frequently Asked Questions (FAQ)

## General

### Q: What is the Dubai Metaverse project?
A: The Dubai Metaverse is a high-end, cinematic, 8K-ready, interactive demo district of Dubai built with Unreal Engine 5.4. It features photoreal visual fidelity, MetaHuman NPCs, weather systems, and performance-optimized real-time play.

### Q: What version of Unreal Engine is required?
A: Unreal Engine 5.4 or 5.4.1 is required. See [UE5 Installation Guide](../setup/UE5_INSTALLATION.md) for installation instructions.

### Q: What are the system requirements?
A: See [Technical Brief](../../docs/TECHNICAL_BRIEF.md) for detailed system requirements. Minimum: 8-core CPU, 32GB RAM, RTX 3070/equivalent GPU, 100GB+ storage.

## Installation

### Q: How do I install Unreal Engine 5.4?
A: See the comprehensive [UE5 Installation Guide](../setup/UE5_INSTALLATION.md) which covers Windows, Linux, and WSL installation methods.

### Q: I'm getting "GitHub access denied" when cloning UE5
A: You must link your GitHub account to your Epic Games account first. Visit https://www.unrealengine.com/en-US/ue-on-github and follow the instructions.

### Q: Build fails with "dotnet-sdk-6.0 not found"
A: On Ubuntu 24.04, add the .NET backports repository:
```bash
sudo add-apt-repository -y ppa:dotnet/backports
sudo apt update
sudo apt install -y dotnet-sdk-6.0
```

### Q: Build takes too long
A: This is normal. With 4 cores, expect 4-6+ hours. With 16 cores, expect 1-2 hours. See [Disk Space Optimization](../../UE5_DISK_SPACE_OPTIMIZATION.md) for optimization options.

### Q: Out of disk space during build
A: Use the optimized build configuration (Development Editor only, 4 cores). See [Disk Space Optimization](../../UE5_DISK_SPACE_OPTIMIZATION.md).

## Project Setup

### Q: How do I create the project?
A: Follow the [Getting Started Guide](../../docs/setup/GETTING_STARTED.md) and [UE5 Setup Guide](../../docs/setup/UE5_INSTALLATION.md).

### Q: Where should I store the project?
A: Store on an SSD for best performance. On WSL, use the Linux file system (`/home/...`) not Windows file system (`/mnt/c/...`).

### Q: How do I configure Git LFS?
A: See [Version Control Guide](../../docs/setup/VERSION_CONTROL.md) for Git LFS setup instructions.

## Development

### Q: What naming conventions should I follow?
A: See [Naming Conventions](../../docs/NAMING_CONVENTIONS.md) for complete naming standards.

### Q: How do I add new assets?
A: Follow the [Asset Pipeline](../../docs/PIPELINE.md) and [Naming Conventions](../../docs/NAMING_CONVENTIONS.md). Run validation scripts before committing.

### Q: How do I use PCG (Procedural Content Generation)?
A: See [PCG Workflow](PCG_WORKFLOW.md) for detailed PCG usage instructions.

### Q: How do I set up lighting?
A: See [Lighting Setup](LIGHTING_SETUP.md) for lighting configuration.

## Performance

### Q: How do I optimize performance?
A: See [Performance Optimization](PERFORMANCE_OPTIMIZATION.md) for optimization strategies.

### Q: What are the performance targets?
A: See [Performance Targets](../../PERFORMANCE_TARGETS.md). Target: 60-90 FPS at 1440p/4K.

### Q: How do I use Nanite?
A: Nanite is enabled by default. See [Technical Brief](../../docs/TECHNICAL_BRIEF.md) for Nanite configuration.

## Scripts

### Q: How do I run the setup scripts?
A: Make scripts executable and run from project root:
```bash
chmod +x scripts/*.sh
./scripts/setup/setup_project.sh
```

### Q: Script fails with permission denied
A: Make sure scripts are executable: `chmod +x scripts/script_name.sh`

### Q: How do I validate my changes?
A: Run validation scripts:
```bash
./scripts/validation/validate_project.sh
./scripts/validation/validate_assets.sh
```

## WSL Specific

### Q: How do I set up graphics in WSL?
A: Windows 11: WSLg works automatically. Windows 10: Install VcXsrv or Xming. See [UE5 Installation Guide](../setup/UE5_INSTALLATION.md).

### Q: Editor won't launch in WSL
A: Check DISPLAY variable: `echo $DISPLAY`. Ensure X server is running. See troubleshooting section in [UE5 Installation Guide](../setup/UE5_INSTALLATION.md).

### Q: Performance is slow in WSL
A: Store project on WSL file system, not Windows file system. Allocate more resources in `.wslconfig`. See [UE5 Installation Guide](../setup/UE5_INSTALLATION.md).

## Troubleshooting

### Q: Where can I find more troubleshooting help?
A: See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) for common issues and solutions.

### Q: How do I report bugs?
A: See [Bug Tracking Guide](../BUG_TRACKING.md) for bug reporting procedures.

### Q: Where can I get help?
A: 
- Check documentation: [docs/README.md](../README.md)
- Review troubleshooting guides
- Check project issues (if using issue tracker)
- Contact project maintainers

---

**Last Updated**: 2024