121 lines
4.7 KiB
Markdown
121 lines
4.7 KiB
Markdown
|
# 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
|
||
|
|
|