# 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]