Initial commit: Complete project foundation with all documentation, scripts, and project structure

scripts/setup_ue5_project.sh

@@ -0,0 +1,94 @@
+#!/bin/bash
+
+# Dubai Metaverse - UE5 Project Setup Script
+# This script provides instructions and validation for UE5 project setup
+
+set -e  # Exit on error
+
+echo "=========================================="
+echo "Dubai Metaverse - UE5 Project Setup"
+echo "=========================================="
+echo ""
+
+# Check if UE5 project file exists
+if [ -f "DubaiMetaverse.uproject" ]; then
+    echo "✓ UE5 project file found: DubaiMetaverse.uproject"
+else
+    echo "⚠ UE5 project file not found"
+    echo ""
+    echo "Please create the UE5 project manually:"
+    echo "1. Open Epic Games Launcher"
+    echo "2. Launch Unreal Engine 5.4"
+    echo "3. Create new project: 'DubaiMetaverse'"
+    echo "4. Template: Blank (or Third Person)"
+    echo "5. Blueprint (C++ can be added later)"
+    echo "6. Target Platform: Desktop"
+    echo "7. Quality Preset: Maximum"
+    echo "8. Starter Content: No"
+    echo "9. Save project in this directory"
+    echo ""
+    read -p "Press Enter when project is created..."
+fi
+
+# Check for Content directory
+if [ -d "Content" ]; then
+    echo "✓ Content directory found"
+    
+    # Check for expected folder structure
+    echo ""
+    echo "Checking folder structure..."
+    
+    DIRS=("Content/Maps" "Content/Assets" "Content/Blueprints" "Content/PCG" "Content/Cinematics" "Content/Audio")
+    MISSING_DIRS=()
+    
+    for dir in "${DIRS[@]}"; do
+        if [ ! -d "$dir" ]; then
+            MISSING_DIRS+=("$dir")
+        fi
+    done
+    
+    if [ ${#MISSING_DIRS[@]} -eq 0 ]; then
+        echo "✓ All expected directories exist"
+    else
+        echo "⚠ Missing directories:"
+        for dir in "${MISSING_DIRS[@]}"; do
+            echo "  - $dir"
+        done
+        echo ""
+        read -p "Create missing directories? (y/n) " -n 1 -r
+        echo
+        if [[ $REPLY =~ ^[Yy]$ ]]; then
+            for dir in "${MISSING_DIRS[@]}"; do
+                mkdir -p "$dir"
+                echo "✓ Created: $dir"
+            done
+        fi
+    fi
+else
+    echo "⚠ Content directory not found"
+    echo "This script should be run from the UE5 project root directory"
+    exit 1
+fi
+
+# Check for Config directory
+if [ -d "Config" ]; then
+    echo "✓ Config directory found"
+else
+    echo "⚠ Config directory not found"
+    echo "This may be normal for a new project"
+fi
+
+# Summary
+echo ""
+echo "=========================================="
+echo "UE5 Project Setup Check Complete"
+echo "=========================================="
+echo ""
+echo "Next steps:"
+echo "1. Open project in Unreal Editor"
+echo "2. Configure project settings (see PROJECT_SETTINGS.md)"
+echo "3. Install required plugins (see PLUGINS.md)"
+echo "4. Set up World Partition"
+echo "5. Begin asset import"
+echo ""
+