4.7 KiB
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 for installation instructions.
Q: What are the system requirements?
A: See Technical Brief 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 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:
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 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.
Project Setup
Q: How do I create the project?
A: Follow the Getting Started Guide and UE5 Setup Guide.
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 for Git LFS setup instructions.
Development
Q: What naming conventions should I follow?
A: See Naming Conventions for complete naming standards.
Q: How do I add new assets?
A: Follow the Asset Pipeline and Naming Conventions. Run validation scripts before committing.
Q: How do I use PCG (Procedural Content Generation)?
A: See PCG Workflow for detailed PCG usage instructions.
Q: How do I set up lighting?
A: See Lighting Setup for lighting configuration.
Performance
Q: How do I optimize performance?
A: See Performance Optimization for optimization strategies.
Q: What are the performance targets?
A: See Performance Targets. Target: 60-90 FPS at 1440p/4K.
Q: How do I use Nanite?
A: Nanite is enabled by default. See Technical Brief for Nanite configuration.
Scripts
Q: How do I run the setup scripts?
A: Make scripts executable and run from project root:
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:
./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.
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.
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.
Troubleshooting
Q: Where can I find more troubleshooting help?
A: See TROUBLESHOOTING.md for common issues and solutions.
Q: How do I report bugs?
A: See Bug Tracking Guide for bug reporting procedures.
Q: Where can I get help?
A:
- Check documentation: docs/README.md
- Review troubleshooting guides
- Check project issues (if using issue tracker)
- Contact project maintainers
Last Updated: 2024