Unreal Engine Build Setup Guide

# Unreal Engine Steam Build Script
# This script builds, cooks, and packages your UE project for Steam distribution

param(
    [string]$ProjectPath = "C:\Projects\MyGame\MyGame.uproject",
    [string]$UE5Root = "C:\Program Files\Epic Games\UE_5.4",
    [string]$OutputDir = "C:\Projects\MyGame\SteamBuild",
    [string]$Platform = "Win64",
    [string]$Configuration = "Shipping"
)

# ButterStack configuration (set via environment or parameters)
$ButterStackUrl = $env:BUTTERSTACK_URL
$ButterStackToken = $env:BUTTERSTACK_TOKEN
$ProjectId = $env:BUTTERSTACK_PROJECT_ID
$BuildNumber = $env:BUILD_NUMBER

$UAT = Join-Path $UE5Root "Engine\Build\BatchFiles\RunUAT.bat"

# Helper function to send ButterStack notifications
function Send-ButterStackEvent {
    param(
        [string]$Endpoint,
        [hashtable]$Body
    )

    if ($ButterStackUrl -and $ButterStackToken) {
        try {
            $json = $Body | ConvertTo-Json -Depth 10
            Invoke-RestMethod -Uri "$ButterStackUrl/webhooks/game_engine/$Endpoint" `
                -Method Post -Body $json -ContentType "application/json" `
                -Headers @{ Authorization = "Bearer $ButterStackToken" }
            Write-Host "Sent event: $Endpoint" -ForegroundColor Gray
        } catch {
            Write-Warning "Failed to send ButterStack event: $_"
        }
    }
}

# Check if Unreal Editor is running (will cause build failures)
$unrealProcesses = Get-Process -Name "UnrealEditor*" -ErrorAction SilentlyContinue
if ($unrealProcesses) {
    Write-Host "Unreal Editor is running. Close it before building." -ForegroundColor Red
    $response = Read-Host "Close it now? (y/n)"
    if ($response -eq 'y') {
        $unrealProcesses | Stop-Process -Force
        Start-Sleep -Seconds 3
    } else {
        Write-Host "Build cancelled."
        exit 1
    }
}

# Validate project exists
if (-not (Test-Path $ProjectPath)) {
    Write-Error "Project not found: $ProjectPath"
    exit 1
}

Write-Host "========================================" -ForegroundColor Cyan
Write-Host "Unreal Engine Build for Steam" -ForegroundColor Cyan
Write-Host "========================================" -ForegroundColor Cyan
Write-Host "Project: $ProjectPath"
Write-Host "Platform: $Platform"
Write-Host "Configuration: $Configuration"
Write-Host "Output: $OutputDir"
Write-Host ""

# Notify ButterStack - Cooking Started
Send-ButterStackEvent -Endpoint "cooking_started" -Body @{
    project_id = $ProjectId
    build_number = [int]$BuildNumber
    engine_version = "5.4"
    platform = $Platform
    configuration = $Configuration
}

$startTime = Get-Date

# Run the build
& $UAT BuildCookRun `
    -project="$ProjectPath" `
    -noP4 `
    -platform=$Platform `
    -clientconfig=$Configuration `
    -cook `
    -build `
    -stage `
    -pak `
    -compressed `
    -prereqs `
    -distribution `
    -nodebuginfo `
    -archive `
    -archivedirectory="$OutputDir"

$exitCode = $LASTEXITCODE
$endTime = Get-Date
$duration = ($endTime - $startTime).TotalMilliseconds

if ($exitCode -eq 0) {
    Write-Host ""
    Write-Host "========================================" -ForegroundColor Green
    Write-Host "Build Completed Successfully" -ForegroundColor Green
    Write-Host "========================================" -ForegroundColor Green
    Write-Host "Duration: $([math]::Round($duration / 1000 / 60, 2)) minutes"
    Write-Host "Output: $OutputDir\Windows"
    Write-Host ""

    # Calculate PAK size
    $pakPath = Join-Path $OutputDir "Windows\MyGame\Content\Paks"
    $pakSize = 0
    if (Test-Path $pakPath) {
        $pakSize = (Get-ChildItem $pakPath -Recurse | Measure-Object -Property Length -Sum).Sum
    }

    # Notify ButterStack - Build Completed
    Send-ButterStackEvent -Endpoint "build_completed" -Body @{
        project_id = $ProjectId
        build_number = [int]$BuildNumber
        pak_size = $pakSize
        total_cook_time_ms = [int]$duration
    }

    # Open output folder
    explorer.exe "$OutputDir"
} else {
    Write-Host ""
    Write-Host "========================================" -ForegroundColor Red
    Write-Host "Build Failed" -ForegroundColor Red
    Write-Host "========================================" -ForegroundColor Red
    Write-Host "Exit code: $exitCode"

    # Notify ButterStack - Build Failed
    Send-ButterStackEvent -Endpoint "build_failed" -Body @{
        project_id = $ProjectId
        build_number = [int]$BuildNumber
        phase = "packaging"
        error = "Build failed with exit code $exitCode"
    }

    exit $exitCode
}

# Upload to Steam
$SteamCmd = "C:\SteamCMD\steamcmd.exe"
$SteamUser = $env:STEAM_USER
$SteamPass = $env:STEAM_PASS

& $SteamCmd +login $SteamUser $SteamPass +run_app_build app_build.vdf +quit

if ($LASTEXITCODE -eq 0) {
    # Notify ButterStack of deployment
    Send-ButterStackEvent -Endpoint "../deployment" -Body @{
        project_id = $ProjectId
        platform = "steam"
        event = "uploaded"
        build_number = [int]$BuildNumber
    }
}