moonwell-client/build-warcraftxl.ps1

[CmdletBinding()]
param(
    [ValidateSet('Debug', 'Release')]
    [string]$Configuration = 'Release',
    [string]$ClientPath = '',
    [string]$PackagePath = '',
    [switch]$Deploy,
    [switch]$NativeRenderer
)

function Enable-LargeAddressAware {
    param(
        [Parameter(Mandatory)]
        [string]$Path
    )

    $bytes = [System.IO.File]::ReadAllBytes($Path)

    if ($bytes.Length -lt 64) {
        throw "File is too small to be a valid PE executable: $Path"
    }

    # DOS header: MZ
    if ($bytes[0] -ne 0x4D -or $bytes[1] -ne 0x5A) {
        throw "DOS MZ signature was not found: $Path"
    }

    # IMAGE_DOS_HEADER.e_lfanew
    $peOffset = [BitConverter]::ToInt32($bytes, 0x3C)

    if ($peOffset -lt 0 -or ($peOffset + 24) -gt $bytes.Length) {
        throw "Invalid PE header offset in: $Path"
    }

    # PE\0\0 signature
    $peSignature = [BitConverter]::ToUInt32($bytes, $peOffset)

    if ($peSignature -ne 0x00004550) {
        throw "PE signature was not found: $Path"
    }

    # IMAGE_FILE_HEADER starts after the 4-byte PE signature.
    # Characteristics is at offset 18 inside IMAGE_FILE_HEADER.
    $characteristicsOffset = $peOffset + 4 + 18
    $characteristics = [BitConverter]::ToUInt16(
        $bytes,
        $characteristicsOffset
    )

    $newCharacteristics = [uint16](
        $characteristics -bor 0x0020
    )

    if ($newCharacteristics -ne $characteristics) {
        $encoded = [BitConverter]::GetBytes($newCharacteristics)

        $bytes[$characteristicsOffset] = $encoded[0]
        $bytes[$characteristicsOffset + 1] = $encoded[1]

        [System.IO.File]::WriteAllBytes($Path, $bytes)

        Write-Host (
            "LAA enabled for {0}: 0x{1:X4} -> 0x{2:X4}" -f
            $Path,
            $characteristics,
            $newCharacteristics
        ) -ForegroundColor Green
    }
    else {
        Write-Host (
            "LAA is already enabled for {0}: 0x{1:X4}" -f
            $Path,
            $characteristics
        ) -ForegroundColor DarkGreen
    }
}

$ErrorActionPreference = 'Stop'
$repoRoot = $PSScriptRoot
$cmake = 'C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\CMake\CMake\bin\cmake.exe'
if (-not (Test-Path -LiteralPath $cmake)) {
    $cmakeCommand = Get-Command cmake -ErrorAction SilentlyContinue
    if (-not $cmakeCommand) { throw 'CMake 3.20+ was not found.' }
    $cmake = $cmakeCommand.Source
}

& git -C $repoRoot submodule update --init --recursive
if ($LASTEXITCODE -ne 0) { throw 'Failed to initialize WarcraftXL submodules.' }

$win32BuildDir = Join-Path $repoRoot 'build\warcraftxl-win32'
$hostBuildDir = Join-Path $repoRoot 'build\warcraftxl-host-x64'
$stockExe = Join-Path $repoRoot 'Wow_Original.exe'

if ($Deploy -or -not [string]::IsNullOrWhiteSpace($PackagePath)) {
    if (-not (Test-Path -LiteralPath $stockExe -PathType Leaf)) {
        throw "Stock executable was not found: $stockExe"
    }
    $expectedStockHash = 'AA63A5750D60EF16746C686B3D5E26876D98953EAB08B1C026CD0FAF78E88CB8'
    $stockHash = (Get-FileHash -LiteralPath $stockExe -Algorithm SHA256).Hash
    if ($stockHash -ne $expectedStockHash) {
        throw "Wow_Original.exe is not the verified MoonWell 3.3.5a stock executable (SHA-256 $stockHash)."
    }
}

& $cmake -S $repoRoot -B $win32BuildDir -A Win32 '-DCLIENT_PATH='
if ($LASTEXITCODE -ne 0) { throw 'WarcraftXL Win32 configure failed.' }
& $cmake --build $win32BuildDir --config $Configuration --target WarcraftXL d3d9 MoonWellLoader
if ($LASTEXITCODE -ne 0) { throw 'WarcraftXL Win32 build failed.' }

& $cmake -S $repoRoot -B $hostBuildDir -A x64 '-DWXL_BUILD_HOST=ON' '-DCLIENT_PATH='
if ($LASTEXITCODE -ne 0) { throw 'WarcraftXL Host configure failed.' }
& $cmake --build $hostBuildDir --config $Configuration --target WarcraftXLHost
if ($LASTEXITCODE -ne 0) { throw 'WarcraftXL Host build failed.' }

$win32ArtifactDir = Join-Path $win32BuildDir "vendor\warcraftxl\$Configuration"
$hostArtifactDir = Join-Path $hostBuildDir "vendor\warcraftxl\$Configuration"
$warcraftXL = Join-Path $win32ArtifactDir 'WarcraftXL.dll'
$modernProxy = Join-Path $win32ArtifactDir 'd3d9.dll'
$nativeProxy = Join-Path $win32BuildDir "artifacts\$Configuration\d3d9-native.dll"
$hostExe = Join-Path $hostArtifactDir 'WarcraftXLHost.exe'
$selectedProxy = if ($NativeRenderer) { $nativeProxy } else { $modernProxy }
$adtResources = Join-Path $repoRoot 'vendor\modules\wxl-modern-adt\_resources'

function Install-WarcraftXLArtifacts {
    param(
        [Parameter(Mandatory)]
        [string]$Destination
    )

    $utils = Join-Path $Destination 'Utils'
    $loosePatch = Join-Path $Destination 'Data\Patch-WXL.MPQ'

    New-Item `
        -ItemType Directory `
        -Path $Destination, $utils, $loosePatch `
        -Force |
        Out-Null

    $destinationExe = Join-Path $Destination 'Wow.exe'

    Copy-Item `
        -LiteralPath $stockExe `
        -Destination $destinationExe `
        -Force

    Enable-LargeAddressAware -Path $destinationExe

    Copy-Item `
        -LiteralPath $warcraftXL `
        -Destination (Join-Path $Destination 'WarcraftXL.dll') `
        -Force

    Copy-Item `
        -LiteralPath $selectedProxy `
        -Destination (Join-Path $Destination 'd3d9.dll') `
        -Force

    Copy-Item `
        -LiteralPath $nativeProxy `
        -Destination (Join-Path $utils 'd3d9-native.dll') `
        -Force

    Copy-Item `
        -LiteralPath $hostExe `
        -Destination (Join-Path $utils 'WarcraftXLHost.exe') `
        -Force

    Get-ChildItem -LiteralPath $adtResources | ForEach-Object {
        Copy-Item `
            -LiteralPath $_.FullName `
            -Destination $loosePatch `
            -Recurse `
            -Force
    }
}

if ($Deploy) {
    if ([string]::IsNullOrWhiteSpace($ClientPath)) {
        $ClientPath = 'C:\Program Files (x86)\World of Warcraft'
    }
    $ClientPath = [System.IO.Path]::GetFullPath($ClientPath)
    if (-not (Test-Path -LiteralPath $ClientPath -PathType Container)) {
        throw "Client directory was not found: $ClientPath"
    }

    $clientExe = Join-Path $ClientPath 'Wow.exe'
    if (Test-Path -LiteralPath $clientExe -PathType Leaf) {
        $clientHash = (Get-FileHash -LiteralPath $clientExe -Algorithm SHA256).Hash
        if ($clientHash -ne $stockHash) {
            $legacyBackup = Join-Path $ClientPath 'Wow.moonwell-patched.backup.exe'
            if (-not (Test-Path -LiteralPath $legacyBackup)) {
                Copy-Item -LiteralPath $clientExe -Destination $legacyBackup
            }
            Write-Host "Legacy executable saved as $legacyBackup"
        }
    }

    Install-WarcraftXLArtifacts -Destination $ClientPath
    Write-Host "Installed WarcraftXL runtime, host and modules in $ClientPath"
}

if (-not [string]::IsNullOrWhiteSpace($PackagePath)) {
    $PackagePath = [System.IO.Path]::GetFullPath($PackagePath)
    Install-WarcraftXLArtifacts -Destination $PackagePath
    Write-Host "Packaged stock Wow.exe and WarcraftXL artifacts in $PackagePath"
}

$renderer = if ($NativeRenderer) { 'native D3D9 recovery proxy' } else { 'WarcraftXL D3D9On12 proxy' }
Write-Host "WarcraftXL build complete ($renderer): $win32ArtifactDir"