Scripts Directory - Dubai Metaverse
This directory contains automation scripts for the Dubai Metaverse project.
Setup Scripts
setup_project.sh
Initializes the project structure, Git LFS, and validates prerequisites.
Usage:
./scripts/setup_project.sh
setup_ue5_project.sh
Validates and helps configure the Unreal Engine 5 project structure.
Usage:
./scripts/setup_ue5_project.sh
Validation Scripts
validate_assets.sh
Validates asset naming conventions and structure.
Usage:
./scripts/validate_assets.sh
generate_docs.sh
Validates documentation completeness.
Usage:
./scripts/generate_docs.sh
Data Import Scripts
import_osm_data.py
Imports OpenStreetMap data for Dubai Marina.
Usage:
python3 scripts/import_osm_data.py --output data/processed/dubai_marina_buildings.geojson
Requirements:
- overpy
- geojson
gis_to_unreal.py
Converts GIS elevation data to Unreal Engine terrain format.
Usage:
python3 scripts/gis_to_unreal.py data/elevation/dubai_marina_dem.tif --output data/processed/terrain_heightmap.raw
Requirements:
- rasterio
- numpy
Phase-Specific Scripts
Phase 2 (Weeks 3-5)
pcg_validation.py- Validates PCG graph outputstexture_validation.py- Validates texture resolution and format
Phase 3 (Week 6)
lighting_validation.py- Validates lighting setup and performance
Phase 4 (Week 10)
performance_audit.py- Audits performance metricsrender_cinematic.py- Automates Movie Render Queue rendering
Phase 5 (Weeks 11-12)
automated_tests.py- Runs automated test suitepackage_build.sh- Packages final build
Optional Scripts
setup_pixel_streaming.sh- Sets up Pixel Streaming (optional)npc_dialogue_api.py- ChatGPT API integration (optional)
Installation
Install Python dependencies:
pip install -r requirements.txt
Make scripts executable:
chmod +x scripts/*.sh scripts/*.py
Notes
- Some scripts are placeholders for future phases
- Python scripts require Python 3.8+
- Shell scripts require bash
- All scripts should be run from project root directory