129 lines
2.3 KiB
Markdown
129 lines
2.3 KiB
Markdown
|
# Command Reference - Dubai Metaverse
|
||
|
|
|
||
|
|
## Git Commands
|
||
|
|
|
||
|
|
### Initial Setup
|
||
|
|
```bash
|
||
|
|
# Initialize repository
|
||
|
|
git init
|
||
|
|
|
||
|
|
# Install Git LFS
|
||
|
|
git lfs install
|
||
|
|
|
||
|
|
# Track large files
|
||
|
|
git lfs track "*.uasset"
|
||
|
|
git lfs track "*.umap"
|
||
|
|
git lfs track "*.png"
|
||
|
|
git lfs track "*.fbx"
|
||
|
|
|
||
|
|
# Initial commit
|
||
|
|
git add .
|
||
|
|
git commit -m "Initial commit"
|
||
|
|
```
|
||
|
|
|
||
|
|
### Daily Workflow
|
||
|
|
```bash
|
||
|
|
# Check status
|
||
|
|
git status
|
||
|
|
|
||
|
|
# Add changes
|
||
|
|
git add <files>
|
||
|
|
git add .
|
||
|
|
|
||
|
|
# Commit
|
||
|
|
git commit -m "Description of changes"
|
||
|
|
|
||
|
|
# Push (if remote configured)
|
||
|
|
git push origin main
|
||
|
|
```
|
||
|
|
|
||
|
|
## Project Scripts
|
||
|
|
|
||
|
|
### Setup
|
||
|
|
```bash
|
||
|
|
# Full project setup
|
||
|
|
./scripts/setup_project.sh
|
||
|
|
|
||
|
|
# UE5 project setup validation
|
||
|
|
./scripts/setup_ue5_project.sh
|
||
|
|
```
|
||
|
|
|
||
|
|
### Validation
|
||
|
|
```bash
|
||
|
|
# Validate assets
|
||
|
|
./scripts/validate_assets.sh
|
||
|
|
|
||
|
|
# Validate documentation
|
||
|
|
./scripts/generate_docs.sh
|
||
|
|
|
||
|
|
# Full project validation
|
||
|
|
./scripts/validate_project.sh
|
||
|
|
```
|
||
|
|
|
||
|
|
### Data Import
|
||
|
|
```bash
|
||
|
|
# Import OSM data
|
||
|
|
python3 scripts/import_osm_data.py \
|
||
|
|
--output data/processed/dubai_marina_buildings.geojson
|
||
|
|
|
||
|
|
# Convert elevation data
|
||
|
|
python3 scripts/gis_to_unreal.py \
|
||
|
|
data/elevation/dem.tif \
|
||
|
|
--output data/processed/terrain_heightmap.raw \
|
||
|
|
--format raw
|
||
|
|
```
|
||
|
|
|
||
|
|
## Python Environment
|
||
|
|
|
||
|
|
### Setup
|
||
|
|
```bash
|
||
|
|
# Install dependencies
|
||
|
|
pip install -r requirements.txt
|
||
|
|
|
||
|
|
# Or use virtual environment
|
||
|
|
python3 -m venv venv
|
||
|
|
source venv/bin/activate # Linux/Mac
|
||
|
|
# venv\Scripts\activate # Windows
|
||
|
|
pip install -r requirements.txt
|
||
|
|
```
|
||
|
|
|
||
|
|
## Unreal Engine (After Installation)
|
||
|
|
|
||
|
|
### Project Creation
|
||
|
|
1. Launch Unreal Engine 5.4
|
||
|
|
2. Create new project: `DubaiMetaverse`
|
||
|
|
3. Template: Blank
|
||
|
|
4. Blueprint
|
||
|
|
5. Desktop platform
|
||
|
|
6. Maximum quality
|
||
|
|
7. No starter content
|
||
|
|
|
||
|
|
### Configuration
|
||
|
|
1. Copy `Config/DefaultEngine.ini.template` to `Config/DefaultEngine.ini`
|
||
|
|
2. Copy `Config/DefaultGame.ini.template` to `Config/DefaultGame.ini`
|
||
|
|
3. Customize settings as needed
|
||
|
|
4. Enable plugins (see PLUGINS.md)
|
||
|
|
|
||
|
|
## Common Tasks
|
||
|
|
|
||
|
|
### Create New Asset
|
||
|
|
1. Follow naming convention
|
||
|
|
2. Place in appropriate Content/ folder
|
||
|
|
3. Validate: `./scripts/validate_assets.sh`
|
||
|
|
4. Commit: `git add Content/Assets/... && git commit -m "Add [asset name]"`
|
||
|
|
|
||
|
|
### Update Documentation
|
||
|
|
1. Edit .md file
|
||
|
|
2. Check links
|
||
|
|
3. Commit: `git add [file].md && git commit -m "Update [file]"`
|
||
|
|
|
||
|
|
### Report Progress
|
||
|
|
1. Edit `PROGRESS_REPORTS/weekX_report.md`
|
||
|
|
2. Update checkboxes
|
||
|
|
3. Commit progress
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
**Last Updated**: [Current Date]
|
||
|
|
|