{"header":{"message":"use X2ModBuildCommon framework","description":null,"timestamp":"2022-07-31T09:15:54.852686982Z","authors":[{}]},"hash":"5NS5ONG275NSHBMAPNYNVQZRHMT3D5YPBHMSJYRJT5VLXXGREEFQC","authors":[{"login":"rohan","key":"2TXMfAvX4QV9V9jEbJn52YFcqYFb27jzvWBqyDAijrVs"}],"deps":{"hashes":[["5NS5ONG275NSHBMAPNYNVQZRHMT3D5YPBHMSJYRJT5VLXXGREEFQC","use X2ModBuildCommon framework"],["AA",null],["W7RCH3VCU4Z5RYC7SLR6ODLDHMDVCKE7YMXCNB2RYBCJNCWDHC7QC",""]],"deps":["W7RCH3VCU4Z5RYC7SLR6ODLDHMDVCKE7YMXCNB2RYBCJNCWDHC7QC"],"known":[]},"hunks":[{"FileAdd":{"meta":{"basename":".scripts","metadata":576},"context":[{"change":2,"pos":1}],"contents":[]}},{"FileAdd":{"meta":{"basename":"build.ps1","metadata":0},"context":[{"change":0,"pos":20}],"contents":[{"Add":"Param("},{"Add":" [string] $srcDirectory, # the path that contains your mod's .XCOM_sln"},{"Add":" [string] $sdkPath, # the path to your SDK installation ending in \"XCOM 2 War of the Chosen SDK\""},{"Add":" [string] $gamePath, # the path to your XCOM 2 installation ending in \"XCOM2-WaroftheChosen\""},{"Add":" [string] $config # build configuration"},{"Add":")"},{"Add":""},{"Add":"$ScriptDirectory = Split-Path $MyInvocation.MyCommand.Path"},{"Add":"$common = Join-Path -Path $ScriptDirectory \"X2ModBuildCommon\\build_common.ps1\""},{"Add":"Write-Host \"Sourcing $common\""},{"Add":". ($common)"},{"Add":""},{"Add":"$builder = [BuildProject]::new(\"TCObridgeSMG\", $srcDirectory, $sdkPath, $gamePath)"},{"Add":""},{"Add":"# Use GIT to add Highlander submodule."},{"Add":"# git submodule add https://github.com/X2CommunityCore/X2WOTCCommunityHighlander.git"},{"Add":""},{"Add":"# Uncomment the next line to enable building against Highlander."},{"Add":"# $builder.IncludeSrc(\"$srcDirectory\\X2WOTCCommunityHighlander\\X2WOTCCommunityHighlander\\Src\")"},{"Add":""},{"Add":"switch ($config)"},{"Add":"{"},{"Add":" \"debug\" {"},{"Add":" $builder.EnableDebug()"},{"Add":" }"},{"Add":" \"default\" {"},{"Add":" # Nothing special"},{"Add":" }"},{"Add":" \"\" { ThrowFailure \"Missing build configuration\" }"},{"Add":" default { ThrowFailure \"Unknown build configuration $config\" }"},{"Add":"}"},{"Add":""},{"Add":"$builder.SetWorkshopID(2829105873)"},{"Add":""},{"Add":"# Uncomment this line to enable cooking."},{"Add":"# $builder.SetContentOptionsJsonFilename(\"ContentOptions.json\")"},{"Add":"$builder.InvokeBuild()"}]}},{"FileAdd":{"meta":{"basename":"X2ModBuildCommon","metadata":576},"context":[{"change":0,"pos":20}],"contents":[]}},{"FileAdd":{"meta":{"basename":"clean_cooker_output.ps1","metadata":0},"context":[{"change":0,"pos":1366}],"contents":[{"Add":"function CleanModAssetCookerOutput ("},{"Add":" [string] $sdkPath, # the path to your SDK installation ending in \"XCOM 2 War of the Chosen SDK\""},{"Add":" [string] $modNameCanonical,"},{"Add":" [string[]] $sourceAssetsPaths # Intended for ContentForCook and CollectionMaps, but any folder that has .upk or .umap files will work"},{"Add":") {"},{"Add":" # TODO: duplicates the logic in build_common.ps1"},{"Add":" $actualTfcSuffix = \"_$($modNameCanonical)_DLCTFC_XPACK_\""},{"Add":" $cookerOutputPath = [io.path]::combine($sdkPath, 'XComGame', 'Published', 'CookedPCConsole')"},{"Add":""},{"Add":" if (!(Test-Path $cookerOutputPath)) {"},{"Add":" Write-Host \"No Published\\CookedPCConsole directory - nothing to clean\""},{"Add":" return"},{"Add":" }"},{"Add":""},{"Add":" $modMaps = @()"},{"Add":" $modPackages = @()"},{"Add":""},{"Add":" foreach ($assetPath in $sourceAssetsPaths) {"},{"Add":" Write-Host \"Asset path: $assetPath\""},{"Add":""},{"Add":" if (!(Test-Path $assetPath)) { continue }"},{"Add":""},{"Add":" $pathMaps = @(Get-ChildItem -Path $assetPath -Filter '*.umap' -Recurse -Force | Select-Object -ExpandProperty BaseName)"},{"Add":" $pathPackages = @(Get-ChildItem -Path $assetPath -Filter '*.upk' -Recurse -Force | Select-Object -ExpandProperty BaseName)"},{"Add":""},{"Add":" Write-Host \"Path maps: $pathMaps\""},{"Add":" Write-Host \"Path packages: $pathPackages\""},{"Add":""},{"Add":" $modMaps += $pathMaps"},{"Add":" $modPackages += $pathPackages"},{"Add":" }"},{"Add":""},{"Add":" Write-Host \"Removing SeekFree maps: $modMaps\""},{"Add":" $modMaps | ForEach-Object { Remove-Item -Force -LiteralPath \"$cookerOutputPath\\$_.upk\" -WarningAction SilentlyContinue -ErrorAction SilentlyContinue }"},{"Add":""},{"Add":" Write-Host \"Removing SeekFree standalone packages: $modPackages\""},{"Add":" $modPackages | ForEach-Object { Remove-Item -Force -LiteralPath \"$cookerOutputPath\\$($_)_SF.upk\" -WarningAction SilentlyContinue -ErrorAction SilentlyContinue }"},{"Add":""},{"Add":" Write-Host \"Removing TFCs: $actualTfcSuffix\""},{"Add":" Remove-Item -Force \"$cookerOutputPath\\*$actualTfcSuffix.tfc\" -WarningAction SilentlyContinue -ErrorAction SilentlyContinue"},{"Add":""},{"Add":" Write-Host \"Removing GuidCache\""},{"Add":" Remove-Item -Force \"$cookerOutputPath\\GuidCache_$modNameCanonical.upk\" -WarningAction SilentlyContinue -ErrorAction SilentlyContinue"},{"Add":"}"},{"Add":""},{"Add":"function TryCleanHlCookerOutput ("},{"Add":" [string] $sdkPath, # the path to your SDK installation ending in \"XCOM 2 War of the Chosen SDK\""},{"Add":" [string] $modSrcPath # the path to [mod root]/[mod project]/Src"},{"Add":") {"},{"Add":" $nativeScriptPackagesNames = @(\"XComGame\", \"Core\", \"Engine\", \"GFxUI\", \"AkAudio\", \"GameFramework\", \"UnrealEd\", \"GFxUIEditor\", \"IpDrv\", \"OnlineSubsystemPC\", \"OnlineSubsystemLive\", \"OnlineSubsystemSteamworks\", \"OnlineSubsystemPSN\")"},{"Add":" $cookerOutputPath = [io.path]::combine($sdkPath, 'XComGame', 'Published', 'CookedPCConsole')"},{"Add":""},{"Add":" if (!(Test-Path $cookerOutputPath)) {"},{"Add":" Write-Host \"No Published\\CookedPCConsole directory - nothing to clean\""},{"Add":" return"},{"Add":" }"},{"Add":""},{"Add":" #################################"},{"Add":" ### Check if this is a HL mod ###"},{"Add":" #################################"},{"Add":""},{"Add":" if (!(Test-Path $modSrcPath)) {"},{"Add":" Write-Host \"No Src directory in mod - this is not a HL mod\""},{"Add":" return"},{"Add":" }"},{"Add":""},{"Add":" $modPackages = Get-ChildItem $modSrcPath -Directory | Select-Object -ExpandProperty \"Name\""},{"Add":" $anyNative = $false"},{"Add":""},{"Add":" foreach ($name in $modPackages)"},{"Add":" {"},{"Add":" if ($nativeScriptPackagesNames.Contains($name)) {"},{"Add":" $anyNative = $true"},{"Add":" break"},{"Add":" }"},{"Add":" }"},{"Add":""},{"Add":" if (!$anyNative) {"},{"Add":" Write-Host $modPackages"},{"Add":" Write-Host \"Not a highlander mod - skipping cleaning HL cooker output\""},{"Add":" return"},{"Add":" }"},{"Add":""},{"Add":" #########################################"},{"Add":" ### Prepare a list of files to delete ###"},{"Add":" #########################################"},{"Add":""},{"Add":" $filesToRemove = @()"},{"Add":""},{"Add":" # Native script packages"},{"Add":" foreach ($package in $nativeScriptPackagesNames) {"},{"Add":" $filesToRemove += \"$package.upk\""},{"Add":" $filesToRemove += \"$package.upk.uncompressed_size\""},{"Add":" }"},{"Add":""},{"Add":" # Startup (unlocalized)"},{"Add":" $filesToRemove += \"Startup.upk\""},{"Add":" $filesToRemove += \"Startup.upk.uncompressed_size\""},{"Add":""},{"Add":" # Startup (localized)"},{"Add":" $gameLangs = @(\"INT\", \"FRA\", \"ITA\", \"DEU\", \"RUS\", \"POL\", \"KOR\", \"ESN\")"},{"Add":" foreach ($lang in $gameLangs) {"},{"Add":" $filesToRemove += \"Startup_LOC_$lang.upk\""},{"Add":" $filesToRemove += \"Startup_LOC_$lang.upk.uncompressed_size\""},{"Add":" }"},{"Add":""},{"Add":" # TFC files"},{"Add":" $tfcGroups = @(\"CharTextures\", \"Lighting\", \"Textures\", \"World\")"},{"Add":" foreach ($tfcGroup in $tfcGroups) {"},{"Add":" # Unsuffixed"},{"Add":" $filesToRemove += \"$tfcGroup.tfc\""},{"Add":" $filesToRemove += \"$tfcGroup-a.tfc\""},{"Add":""},{"Add":" # Suffixed"},{"Add":" $filesToRemove += \"${tfcGroup}_XPACK_.tfc\""},{"Add":" $filesToRemove += \"$tfcGroup-a_XPACK_.tfc\""},{"Add":""},{"Add":" # TLE"},{"Add":" $filesToRemove += \"${tfcGroup}_TLE_DLCTFC_XPACK_.tfc\""},{"Add":" $filesToRemove += \"$tfcGroup-a_TLE_DLCTFC_XPACK_.tfc\""},{"Add":" }"},{"Add":""},{"Add":" # Singletons"},{"Add":" $filesToRemove += \"GuidCache.upk\""},{"Add":" $filesToRemove += \"GlobalPersistentCookerData.upk\""},{"Add":" $filesToRemove += \"PersistentCookerShaderData.bin\""},{"Add":""},{"Add":" ######################"},{"Add":" ### Actual removal ###"},{"Add":" ######################"},{"Add":""},{"Add":" Write-Host \"Removing HL cooker output files from $cookerOutputPath\""},{"Add":""},{"Add":" foreach ($file in $filesToRemove) {"},{"Add":" Write-Host \" .\\$file\""},{"Add":" Remove-Item -Force \"$cookerOutputPath\\$file\" -WarningAction SilentlyContinue -ErrorAction SilentlyContinue"},{"Add":" }"},{"Add":"}"}]}},{"FileAdd":{"meta":{"basename":"clean.ps1","metadata":0},"context":[{"change":0,"pos":1366}],"contents":[{"Add":"Param("},{"Add":" [string] $modName, # mod folder name"},{"Add":" [string] $srcDirectory, # the path that contains your mod's .XCOM_sln"},{"Add":" [string] $sdkPath, # the path to your SDK installation ending in \"XCOM 2 War of the Chosen SDK\""},{"Add":" [string] $gamePath # the path to your XCOM 2 installation ending in \"XCOM2-WaroftheChosen\""},{"Add":")"},{"Add":""},{"Add":"$ErrorActionPreference = \"Stop\""},{"Add":"Set-StrictMode -Version 3.0"},{"Add":""},{"Add":"$scriptDirectory = Split-Path $MyInvocation.MyCommand.Path"},{"Add":"$cleanCookerOutput = Join-Path -Path $scriptDirectory \"clean_cooker_output.ps1\""},{"Add":"Write-Host \"Sourcing $cleanCookerOutput\""},{"Add":". $cleanCookerOutput"},{"Add":""},{"Add":"if ($null -eq $modName -or $modName -eq \"\") {"},{"Add":" throw \"`$modName empty???\""},{"Add":"}"},{"Add":""},{"Add":"Write-Host \"Deleting all cached build artifacts...\""},{"Add":""},{"Add":"# This needs to be before $srcDirectory\\BuildCache is deleted - otherwise we will miss our collection maps"},{"Add":"# This is dumb, yes, but to fix this we need to rework how BuildProject is used from build.ps1 (and here)"},{"Add":"CleanModAssetCookerOutput $sdkPath $modName @(\"$srcDirectory\\$modName\\ContentForCook\", \"$srcDirectory\\BuildCache\\CollectionMaps\")"},{"Add":""},{"Add":"$files = @("},{"Add":" \"$sdkPath\\XComGame\\lastBuildDetails.json\","},{"Add":" \"$sdkPath\\XComGame\\Script\\*.u\","},{"Add":" \"$sdkPath\\XComGame\\ScriptFinalRelease\\*.u\","},{"Add":" \"$sdkPath\\XComGame\\Content\\LocalShaderCache-PC-D3D-SM4.upk\""},{"Add":")"},{"Add":""},{"Add":"$folders = @("},{"Add":" \"$srcDirectory\\BuildCache\","},{"Add":" \"$sdkPath\\Development\\Src\\*\","},{"Add":" \"$sdkPath\\XComGame\\Mods\\*\","},{"Add":" \"$gamePath\\XComGame\\Mods\\$modName\""},{"Add":")"},{"Add":""},{"Add":"$files | ForEach-Object {"},{"Add":" Write-Host \"Removing file(s) $($_)\""},{"Add":" Remove-Item -Force $_ -WarningAction SilentlyContinue -ErrorAction SilentlyContinue"},{"Add":"}"},{"Add":""},{"Add":"$folders | ForEach-Object {"},{"Add":" Write-Host \"Removing folders(s) $($_)\""},{"Add":" Remove-Item -Recurse -Force $_ -WarningAction SilentlyContinue -ErrorAction SilentlyContinue"},{"Add":"}"},{"Add":""},{"Add":"TryCleanHlCookerOutput $sdkPath \"$srcDirectory\\$modName\\Src\""},{"Add":""},{"Add":"Write-Host \"Cleaned.\""}]}},{"FileAdd":{"meta":{"basename":"build_common.ps1","metadata":0},"context":[{"change":0,"pos":1366}],"contents":[{"Add":"Write-Host \"Build Common Loading\""},{"Add":""},{"Add":"$ErrorActionPreference = \"Stop\""},{"Add":"Set-StrictMode -Version 3.0"},{"Add":""},{"Add":"$global:buildCommonSelfPath = split-path -parent $MyInvocation.MyCommand.Definition"},{"Add":""},{"Add":"$cleanCookerOutput = Join-Path -Path $global:buildCommonSelfPath \"clean_cooker_output.ps1\""},{"Add":"Write-Host \"Sourcing $cleanCookerOutput\""},{"Add":". $cleanCookerOutput"},{"Add":""},{"Add":"# list of all native script packages"},{"Add":"$global:nativescriptpackages = @(\"XComGame\", \"Core\", \"Engine\", \"GFxUI\", \"AkAudio\", \"GameFramework\", \"UnrealEd\", \"GFxUIEditor\", \"IpDrv\", \"OnlineSubsystemPC\", \"OnlineSubsystemLive\", \"OnlineSubsystemSteamworks\", \"OnlineSubsystemPSN\")"},{"Add":"$global:def_robocopy_args = @(\"/S\", \"/E\", \"/COPY:DAT\", \"/PURGE\", \"/MIR\", \"/NP\", \"/R:1000000\", \"/W:30\")"},{"Add":""},{"Add":"$global:invarCulture = [System.Globalization.CultureInfo]::InvariantCulture"},{"Add":""},{"Add":"class BuildProject {"},{"Add":"\t[string] $modNameCanonical"},{"Add":"\t[string] $modNameFull"},{"Add":"\t[string] $projectRoot"},{"Add":"\t[string] $sdkPath"},{"Add":"\t[string] $gamePath"},{"Add":"\t[string] $finalModPath"},{"Add":"\t[string] $contentOptionsJsonFilename"},{"Add":"\t[long] $publishID = -1"},{"Add":"\t[bool] $debug = $false"},{"Add":"\t[bool] $final_release = $false"},{"Add":"\t[string[]] $include = @()"},{"Add":"\t[string[]] $clean = @()"},{"Add":"\t[object[]] $preMakeHooks = @()"},{"Add":""},{"Add":"\t# internals"},{"Add":"\t[hashtable] $macroDefs = @{}"},{"Add":"\t[object[]] $timings = @()"},{"Add":""},{"Add":"\t# lazily set"},{"Add":"\t[string] $modSrcRoot"},{"Add":"\t[string] $modX2projPath"},{"Add":"\t[string] $devSrcRoot"},{"Add":"\t[string] $stagingPath"},{"Add":"\t[string] $xcomModPath"},{"Add":"\t[string] $commandletHostPath"},{"Add":"\t[string] $buildCachePath"},{"Add":"\t[string] $cookerOutputPath"},{"Add":"\t[string] $makeFingerprintsPath"},{"Add":"\t[string[]] $modScriptPackages"},{"Add":"\t[bool] $isHl"},{"Add":"\t[bool] $cookHL"},{"Add":"\t[PSCustomObject] $contentOptions"},{"Add":"\t[string] $sdkEngineIniPath"},{"Add":"\t[string] $sdkEngineIniContent"},{"Add":""},{"Add":"\tBuildProject("},{"Add":"\t\t[string]$mod,"},{"Add":"\t\t[string]$projectRoot,"},{"Add":"\t\t[string]$sdkPath,"},{"Add":"\t\t[string]$gamePath"},{"Add":"\t){"},{"Add":"\t\t$this.modNameFull = $mod"},{"Add":"\t\t$this.modNameCanonical = $mod -Replace '[\\s;]',''"},{"Add":"\t\t$this.projectRoot = $projectRoot"},{"Add":"\t\t$this.sdkPath = $sdkPath"},{"Add":"\t\t$this.gamePath = $gamePath"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]SetContentOptionsJsonFilename($filename) {"},{"Add":"\t\t$this.contentOptionsJsonFilename = $filename"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]SetWorkshopID([long] $publishID) {"},{"Add":"\t\tif ($publishID -le 0) { ThrowFailure \"publishID must be >0\" }"},{"Add":"\t\t$this.publishID = $publishID"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]EnableFinalRelease() {"},{"Add":"\t\t$this.final_release = $true"},{"Add":"\t\t$this._CheckFlags()"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]EnableDebug() {"},{"Add":"\t\t$this.debug = $true"},{"Add":"\t\t$this._CheckFlags()"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]AddPreMakeHook([Action[]] $action) {"},{"Add":"\t\t$this.preMakeHooks += $action"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]AddToClean([string] $modName) {"},{"Add":"\t\t$this.clean += $modName"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]IncludeSrc([string] $src) {"},{"Add":"\t\tif (!(Test-Path $src)) { ThrowFailure \"include path $src doesn't exist\" }"},{"Add":"\t\t$this.include += $src"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]InvokeBuild() {"},{"Add":"\t\ttry {"},{"Add":"\t\t\t$fullStopwatch = [Diagnostics.Stopwatch]::StartNew()"},{"Add":"\t\t\t$this._ConfirmPaths()"},{"Add":"\t\t\t$this._SetupUtils()"},{"Add":"\t\t\t$this._LoadContentOptions()"},{"Add":""},{"Add":"\t\t\tif ($this._HasScriptPackages()) {"},{"Add":"\t\t\t\t$this._PerformStep({ ($_)._CleanAdditional() }, \"Cleaning\", \"Cleaned\", \"additional mods\")"},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\t$this._PerformStep({ ($_)._CopyModToSdk() }, \"Mirroring\", \"Mirrored\", \"mod to SDK\")"},{"Add":"\t\t\t$this._PerformStep({ ($_)._ConvertLocalization() }, \"Converting\", \"Converted\", \"Localization UTF-8 -> UTF-16\")"},{"Add":""},{"Add":"\t\t\tif ($this._ShouldCompileBase()) {"},{"Add":"\t\t\t\t$this._PerformStep({ ($_)._CopyToSrc() }, \"Populating\", \"Populated\", \"Development\\Src folder\")"},{"Add":"\t\t\t\t$this._PerformStep({ ($_)._RunPreMakeHooks() }, \"Running\", \"Ran\", \"Pre-Make hooks\")"},{"Add":"\t\t\t\t$this._PerformStep({ ($_)._CheckCleanCompiled() }, \"Verifying\", \"Verified\", \"compiled script packages\")"},{"Add":"\t\t\t\t$this._PerformStep({ ($_)._RunMakeBase() }, \"Compiling\", \"Compiled\", \"base-game script packages\")"},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\tif ($this._HasScriptPackages()) {"},{"Add":"\t\t\t\t$this._PerformStep({ ($_)._RunMakeMod() }, \"Compiling\", \"Compiled\", \"mod script packages\")"},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\tif ($this._ShouldCompileBase()) {"},{"Add":"\t\t\t\t$this._RecordCoreTimestamp()"},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\tif ($this._HasScriptPackages()) {"},{"Add":"\t\t\t\tif ($this.isHl) {"},{"Add":"\t\t\t\t\tif (-not $this.debug) {"},{"Add":"\t\t\t\t\t\t$this._PerformStep({ ($_)._RunCookHL() }, \"Cooking\", \"Cooked\", \"Highlander packages\")"},{"Add":"\t\t\t\t\t} else {"},{"Add":"\t\t\t\t\t\tWrite-Host \"Skipping HL cooking as debug build\""},{"Add":"\t\t\t\t\t}"},{"Add":"\t\t\t\t}"},{"Add":""},{"Add":"\t\t\t\t$this._PerformStep({ ($_)._CopyScriptPackages() }, \"Copying\", \"Copied\", \"compiled script packages\")"},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\t# The shader step needs to happen before asset cooking - precompiler gets confused by some inlined materials"},{"Add":"\t\t\t$this._PerformStep({ ($_)._PrecompileShaders() }, \"Precompiling\", \"Precompiled\", \"shaders\")"},{"Add":""},{"Add":"\t\t\t$this._PerformStep({ ($_)._RunCookAssets() }, \"Cooking\", \"Cooked\", \"mod assets\")"},{"Add":""},{"Add":"\t\t\t# Do this last as there is no need for it earlier - the cooker obviously has access to the game assets"},{"Add":"\t\t\t# and precompiling shaders seems to do nothing (I assume they are included in the game's GlobalShaderCache)"},{"Add":"\t\t\t$this._PerformStep({ ($_)._CopyMissingUncooked() }, \"Copying\", \"Copied\", \"requested uncooked packages\")"},{"Add":""},{"Add":"\t\t\t$this._PerformStep({ ($_)._FinalCopy() }, \"Copying\", \"Copied\", \"built mod to game directory\")"},{"Add":""},{"Add":"\t\t\t$fullStopwatch.Stop()"},{"Add":"\t\t\t$this._ReportTimings($fullStopwatch)"},{"Add":""},{"Add":"\t\t\tSuccessMessage \"*** SUCCESS! ($(FormatElapsed $fullStopwatch.Elapsed)) ***\" $this.modNameCanonical"},{"Add":"\t\t}"},{"Add":"\t\tcatch {"},{"Add":"\t\t\t[System.Media.SystemSounds]::Hand.Play()"},{"Add":"\t\t\tthrow"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_PerformStep([scriptblock]$stepCallback, [string]$progressWord, [string]$completedWord, [string]$description) {"},{"Add":"\t\tWrite-Host \"$($progressWord) $($description)...\""},{"Add":"\t\t$sw = [Diagnostics.Stopwatch]::StartNew()"},{"Add":""},{"Add":"\t\t# HACK: Set $_ for $stepCallback with Foreach-Object on only one object"},{"Add":"\t\t$this | ForEach-Object $stepCallback"},{"Add":""},{"Add":"\t\t$sw.Stop()"},{"Add":""},{"Add":"\t\t$record = [PSCustomObject]@{"},{"Add":"\t\t\tDescription = \"$($progressWord) $($description)\""},{"Add":"\t\t\tSeconds = $sw.Elapsed.TotalSeconds"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t$this.timings += $record"},{"Add":""},{"Add":"\t\tWrite-Host -ForegroundColor DarkGreen \"$($completedWord) $($description) in $(FormatElapsed $sw.Elapsed)\""},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_ReportTimings([Diagnostics.Stopwatch]$fullStopwatch) {"},{"Add":"\t\tif (-not [string]::IsNullOrEmpty($env:X2MBC_REPORT_TIMINGS)) {"},{"Add":"\t\t\t$fullTime = $fullStopwatch.Elapsed.TotalSeconds"},{"Add":"\t\t\t$accountedTime = $this.timings | Measure-Object -Sum -Property Seconds | Select-Object -ExpandProperty Sum"},{"Add":"\t\t\t$this.timings += [PSCustomObject]@{"},{"Add":"\t\t\t\tDescription = \"Total Duration\""},{"Add":"\t\t\t\tSeconds = $fullTime"},{"Add":"\t\t\t}"},{"Add":"\t\t\t$this.timings += [PSCustomObject]@{"},{"Add":"\t\t\t\tDescription = \"Unaccounted time\""},{"Add":"\t\t\t\tSeconds = $fullTime - $accountedTime"},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\t$this.timings | Sort-Object -Descending -Property { $_.Seconds } | ForEach-Object {"},{"Add":"\t\t\t\t$_ | Add-Member -NotePropertyName \"Share\" -NotePropertyValue ($_.Seconds / $fullTime).ToString(\"0.00%\", $global:invarCulture)"},{"Add":"\t\t\t\t$_.Seconds = $_.Seconds.ToString(\"0.00s\", $global:invarCulture)"},{"Add":"\t\t\t\t$_"},{"Add":"\t\t\t} | Format-Table | Out-String | Write-Host"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_CheckFlags() {"},{"Add":"\t\tif ($this.debug -eq $true -and $this.final_release -eq $true)"},{"Add":"\t\t{"},{"Add":"\t\t\tThrowFailure \"-debug and -final_release cannot be used together\""},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_ConfirmPaths() {"},{"Add":"\t\tWrite-Host \"SDK Path: $($this.sdkPath)\""},{"Add":"\t\tWrite-Host \"Game Path: $($this.gamePath)\""},{"Add":""},{"Add":"\t\t# Check if the user config is set up correctly"},{"Add":"\t\tif (([string]::IsNullOrEmpty($this.sdkPath) -or $this.sdkPath -eq '${config:xcom.highlander.sdkroot}') -or ([string]::IsNullOrEmpty($this.gamePath) -or $this.gamePath -eq '${config:xcom.highlander.gameroot}'))"},{"Add":"\t\t{"},{"Add":"\t\t\tThrowFailure \"Please set up user config xcom.highlander.sdkroot and xcom.highlander.gameroot\""},{"Add":"\t\t}"},{"Add":"\t\telseif (!(Test-Path $this.sdkPath)) # Verify the SDK and game paths exist before proceeding"},{"Add":"\t\t{"},{"Add":"\t\t\tThrowFailure (\"The path '{}' doesn't exist. Please adjust the xcom.highlander.sdkroot variable in your user config and retry.\" -f $this.sdkPath)"},{"Add":"\t\t}"},{"Add":"\t\telseif (!(Test-Path $this.gamePath))"},{"Add":"\t\t{"},{"Add":"\t\t\tThrowFailure (\"The path '{}' doesn't exist. Please adjust the xcom.highlander.gameroot variable in your user config and retry.\" -f $this.gamePath)"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_SetupUtils() {"},{"Add":"\t\t$this.modSrcRoot = \"$($this.projectRoot)\\$($this.modNameFull)\""},{"Add":"\t\t$this.modX2projPath = \"$($this.modSrcRoot)\\$($this.modNameFull).x2proj\""},{"Add":"\t\t$this.stagingPath = \"$($this.sdkPath)\\XComGame\\Mods\\$($this.modNameCanonical)\""},{"Add":"\t\t$this.xcomModPath = \"$($this.stagingPath)\\$($this.modNameCanonical).XComMod\""},{"Add":"\t\t$this.finalModPath = \"$($this.gamePath)\\XComGame\\Mods\\$($this.modNameCanonical)\""},{"Add":"\t\t$this.devSrcRoot = \"$($this.sdkPath)\\Development\\Src\""},{"Add":"\t\t$this.commandletHostPath = \"$($this.sdkPath)/binaries/Win64/XComGame.com\""},{"Add":""},{"Add":"\t\t# build package lists we'll need later and delete as appropriate"},{"Add":"\t\t# the mod's packages"},{"Add":"\t\t$modSrcPath = \"$($this.modSrcRoot)/Src\""},{"Add":"\t\tif (Test-Path $modSrcPath) {"},{"Add":"\t\t\t$this.modScriptPackages = @(Get-ChildItem \"$($this.modSrcRoot)/Src\" -Directory)"},{"Add":"\t\t} else {"},{"Add":"\t\t\t# No scripts to compile"},{"Add":"\t\t\t$this.modScriptPackages = @()"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\tif (!$this._HasScriptPackages()) {"},{"Add":"\t\t\tif ($this.clean.Length -gt 0) {"},{"Add":"\t\t\t\tThrowFailure \"AddToClean is not supported when no script packages to compile\""},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\tif ($this.include.Length -gt 0) {"},{"Add":"\t\t\t\tThrowFailure \"IncludeSrc is not supported when no script packages to compile\""},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\tif ($this.preMakeHooks.Length -gt 0) {"},{"Add":"\t\t\t\tThrowFailure \"AddPreMakeHook is not supported when no script packages to compile\""},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\tif ($this.debug) {"},{"Add":"\t\t\t\tThrowFailure \"Debug build enabled but no script packages to compile\""},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t$this.isHl = $this._HasNativePackages()"},{"Add":"\t\t$this.cookHL = $this.isHl -and -not $this.debug"},{"Add":""},{"Add":"\t\tif (-not $this.isHl -and $this.final_release) {"},{"Add":"\t\t\tThrowFailure \"-final_release only makes sense if the mod in question is a Highlander\""},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t$this.cookerOutputPath = [io.path]::combine($this.sdkPath, 'XComGame', 'Published', 'CookedPCConsole')"},{"Add":""},{"Add":"\t\t$this.buildCachePath = [io.path]::combine($this.projectRoot, 'BuildCache')"},{"Add":"\t\tif (!(Test-Path $this.buildCachePath))"},{"Add":"\t\t{"},{"Add":"\t\t\tNew-Item -ItemType \"directory\" -Path $this.buildCachePath"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t$this.sdkEngineIniPath = \"$($this.sdkPath)/XComGame/Config/DefaultEngine.ini\""},{"Add":"\t\t$this.sdkEngineIniContent = Get-Content $this.sdkEngineIniPath | Out-String"},{"Add":""},{"Add":"\t\t$this.makeFingerprintsPath = \"$($this.sdkPath)\\XComGame\\lastBuildDetails.json\""},{"Add":"\t\t$lastBuildDetails = if (Test-Path $this.makeFingerprintsPath) {"},{"Add":"\t\t\tGet-Content $this.makeFingerprintsPath | ConvertFrom-Json"},{"Add":"\t\t} else {"},{"Add":"\t\t\t[PSCustomObject]@{}"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t@(\"buildMode\", \"globalsHash\", \"coreTimestamp\") | ForEach-Object {"},{"Add":"\t\t\tif(-not (Get-Member -InputObject $lastBuildDetails -name $_ -Membertype Properties)) {"},{"Add":"\t\t\t\t$lastBuildDetails | Add-Member -NotePropertyName $_ -NotePropertyValue \"unknown\""},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t$lastBuildDetails | ConvertTo-Json | Set-Content -Path $this.makeFingerprintsPath"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_LoadContentOptions() {"},{"Add":"\t\tWrite-Host \"Preparing content options\""},{"Add":""},{"Add":"\t\tif ([string]::IsNullOrEmpty($this.contentOptionsJsonFilename))"},{"Add":"\t\t{"},{"Add":"\t\t\t$this.contentOptions = [PSCustomObject]@{}"},{"Add":"\t\t}"},{"Add":"\t\telse"},{"Add":"\t\t{"},{"Add":"\t\t\t$contentOptionsJsonPath = Join-Path $this.modSrcRoot $this.contentOptionsJsonFilename"},{"Add":""},{"Add":"\t\t\tif (!(Test-Path $contentOptionsJsonPath)) {"},{"Add":"\t\t\t\tThrowFailure \"ContentOptionsJsonPath $contentOptionsJsonPath doesn't exist\""},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\t$this.contentOptions = Get-Content $contentOptionsJsonPath | ConvertFrom-Json"},{"Add":"\t\t\tWrite-Host \"Loaded $($contentOptionsJsonPath)\""},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\tif (($this.contentOptions.PSobject.Properties | ForEach-Object {$_.Name}) -notcontains \"missingUncooked\")"},{"Add":"\t\t{"},{"Add":"\t\t\tWrite-Host \"No missing uncooked\""},{"Add":"\t\t\t$this.contentOptions | Add-Member -MemberType NoteProperty -Name 'missingUncooked' -Value @()"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\tif (($this.contentOptions.PSobject.Properties | ForEach-Object {$_.Name}) -notcontains \"sfStandalone\")"},{"Add":"\t\t{"},{"Add":"\t\t\tWrite-Host \"No packages to make SF\""},{"Add":"\t\t\t$this.contentOptions | Add-Member -MemberType NoteProperty -Name 'sfStandalone' -Value @()"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\tif (($this.contentOptions.PSobject.Properties | ForEach-Object {$_.Name}) -notcontains \"sfMaps\")"},{"Add":"\t\t{"},{"Add":"\t\t\tWrite-Host \"No umaps to cook\""},{"Add":"\t\t\t$this.contentOptions | Add-Member -MemberType NoteProperty -Name 'sfMaps' -Value @()"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\tif (($this.contentOptions.PSobject.Properties | ForEach-Object {$_.Name}) -notcontains \"sfCollectionMaps\")"},{"Add":"\t\t{"},{"Add":"\t\t\tWrite-Host \"No collection maps to cook\""},{"Add":"\t\t\t$this.contentOptions | Add-Member -MemberType NoteProperty -Name 'sfCollectionMaps' -Value @()"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_CopyModToSdk() {"},{"Add":"\t\t$xf = @(\"*.x2proj\")"},{"Add":""},{"Add":"\t\tif (![string]::IsNullOrEmpty($this.contentOptionsJsonFilename)) {"},{"Add":"\t\t\t$xf += $this.contentOptionsJsonFilename"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\tWrite-Host \"Copying mod project to staging...\""},{"Add":"\t\tRobocopy.exe \"$($this.modSrcRoot)\" \"$($this.stagingPath)\" *.* $global:def_robocopy_args /XF @xf /XD \"ContentForCook\""},{"Add":"\t\tWrite-Host \"Copied project to staging.\""},{"Add":""},{"Add":"\t\tif ($this._HasScriptPackages()) {"},{"Add":"\t\t\tNew-Item \"$($this.stagingPath)/Script\" -ItemType Directory"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t# read mod metadata from the x2proj file"},{"Add":"\t\tWrite-Host \"Reading mod metadata from $($this.modX2ProjPath)\""},{"Add":"\t\t[xml]$x2projXml = Get-Content -Path \"$($this.modX2ProjPath)\""},{"Add":"\t\t$xmlPropertyGroup = $x2projXml.Project.PropertyGroup"},{"Add":"\t\t$modProperties = if ($xmlPropertyGroup -is [array]) { $xmlPropertyGroup[0] } else { $xmlPropertyGroup }"},{"Add":"\t\t$publishedId = $modProperties.SteamPublishID"},{"Add":"\t\tif ($this.publishID -ne -1) {"},{"Add":"\t\t\t$publishedId = $this.publishID"},{"Add":"\t\t\tWrite-Host \"Using override workshop ID of $publishedId\""},{"Add":"\t\t}"},{"Add":"\t\t$title = $modProperties.Name"},{"Add":"\t\t$description = $modProperties.Description"},{"Add":"\t\tWrite-Host \"Read.\""},{"Add":""},{"Add":"\t\tWrite-Host \"Writing mod metadata...\""},{"Add":"\t\tSet-Content \"$($this.xcomModPath)\" \"[mod]`npublishedFileId=$publishedId`nTitle=$title`nDescription=$description`nRequiresXPACK=true\""},{"Add":"\t\tWrite-Host \"Written.\""},{"Add":""},{"Add":"\t\t# Create CookedPCConsole folder for the mod"},{"Add":"\t\tif ($this.cookHL) {"},{"Add":"\t\t\tNew-Item \"$($this.stagingPath)/CookedPCConsole\" -ItemType Directory"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_CleanAdditional() {"},{"Add":"\t\t# clean"},{"Add":"\t\tforeach ($modName in $this.clean) {"},{"Add":"\t\t\t$cleanDir = \"$($this.sdkPath)/XComGame/Mods/$($modName)\""},{"Add":"\t\t\tif (Test-Path $cleanDir) {"},{"Add":"\t\t\t\tWrite-Host \"Cleaning $($modName)...\""},{"Add":"\t\t\t\tRemove-Item -Recurse -Force $cleanDir"},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_ConvertLocalization() {"},{"Add":"\t\tGet-ChildItem \"$($this.stagingPath)\\Localization\" -Recurse -File |"},{"Add":"\t\tForeach-Object {"},{"Add":"\t\t\t$content = Get-Content $_.FullName -Encoding UTF8"},{"Add":"\t\t\t$content | Out-File $_.FullName -Encoding Unicode"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_CopyToSrc() {"},{"Add":"\t\t# mirror the SDK's SrcOrig to its Src"},{"Add":"\t\tWrite-Host \"Mirroring SrcOrig to Src...\""},{"Add":"\t\tRobocopy.exe \"$($this.sdkPath)\\Development\\SrcOrig\" \"$($this.devSrcRoot)\" *.uc *.uci $global:def_robocopy_args"},{"Add":"\t\tWrite-Host \"Mirrored SrcOrig to Src.\""},{"Add":""},{"Add":"\t\t$this._ParseMacroFile(\"$($this.devSrcRoot)\\Core\\Globals.uci\")"},{"Add":""},{"Add":"\t\t# Copy dependencies"},{"Add":"\t\tWrite-Host \"Copying dependency sources to Src...\""},{"Add":"\t\tforeach ($depfolder in $this.include) {"},{"Add":"\t\t\tGet-ChildItem \"$($depfolder)\" -Directory -Name | Write-Host"},{"Add":"\t\t\t$this._CopySrcFolder($depfolder)"},{"Add":"\t\t}"},{"Add":"\t\tWrite-Host \"Copied dependency sources to Src.\""},{"Add":""},{"Add":"\t\tif ($this._HasScriptPackages()) {"},{"Add":"\t\t\t# copying the mod's scripts to the script staging location"},{"Add":"\t\t\tWrite-Host \"Copying the mod's sources to Src...\""},{"Add":"\t\t\t$this._CopySrcFolder(\"$($this.modSrcRoot)\\Src\")"},{"Add":"\t\t\tWrite-Host \"Copied mod sources to Src.\""},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_CopySrcFolder([string] $includeDir) {"},{"Add":"\t\tCopy-Item \"$($includeDir)\\*\" \"$($this.devSrcRoot)\\\" -Force -Recurse -WarningAction SilentlyContinue"},{"Add":"\t\t$extraGlobalsFile = \"$($includeDir)\\extra_globals.uci\""},{"Add":"\t\tif (Test-Path $extraGlobalsFile) {"},{"Add":"\t\t\t# append extra_globals.uci to globals.uci"},{"Add":"\t\t\t\"// Macros included from $($extraGlobalsFile)\" | Add-Content \"$($this.devSrcRoot)\\Core\\Globals.uci\""},{"Add":"\t\t\tGet-Content $extraGlobalsFile | Add-Content \"$($this.devSrcRoot)\\Core\\Globals.uci\""},{"Add":""},{"Add":"\t\t\t$this._ParseMacroFile($extraGlobalsFile)"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_ParseMacroFile([string]$file) {"},{"Add":"\t\t$lines = Get-Content $file"},{"Add":"\t\t# check for dupes"},{"Add":"\t\t$redefine = $false"},{"Add":"\t\t$lineNr = 1"},{"Add":"\t\tforeach ($line in $lines) {"},{"Add":"\t\t\t$defineMatch = $line | Select-String -Pattern '^\\s*`define\\s*([a-zA-Z][a-zA-Z0-9_]*)'"},{"Add":"\t\t\tif ($null -ne $defineMatch -and $defineMatch.Matches.Success) {"},{"Add":"\t\t\t\t[string]$macroName = $defineMatch.Matches.Groups[1]"},{"Add":"\t\t\t\t$prevDef = $this.macroDefs[$macroName]"},{"Add":"\t\t\t\tif ($null -ne $prevDef -and"},{"Add":"\t\t\t\t\t-not $redefine -and"},{"Add":"\t\t\t\t\t$prevDef.file -ne $file) {"},{"Add":"\t\t\t\t\tWrite-Host -ForegroundColor Red \"Error: Implicit redefinition of macro $($macroName)\""},{"Add":"\t\t\t\t\t$defineWord = if ($prevDef.redefine) { \"redefined\" } else { \"defined\" }"},{"Add":"\t\t\t\t\tWrite-Host \" Note: Previously $($defineWord) at $($prevDef.file)($($prevDef.lineNr))\""},{"Add":"\t\t\t\t\tWrite-Host \" Note: Implicitly redefined at $($file)($($lineNr))\""},{"Add":"\t\t\t\t\tWrite-Host \" Help: Rename the macro, or add ``// X2MBC-Redefine`` above to explicitly redefine and silence this warning.\""},{"Add":"\t\t\t\t\tThrowFailure \"Implicit macro redefinition.\""},{"Add":"\t\t\t\t}"},{"Add":"\t\t\t\t$macroDef = [PSCustomObject]@{"},{"Add":"\t\t\t\t\tfile = $file"},{"Add":"\t\t\t\t\tlineNr = $lineNr"},{"Add":"\t\t\t\t\tredefine = $redefine"},{"Add":"\t\t\t\t}"},{"Add":"\t\t\t\t$this.macroDefs[$macroName] = $macroDef"},{"Add":"\t\t\t} elseif ($line -match '^\\s*`define') {"},{"Add":"\t\t\t\tThrowFailure \"Unrecognized macro at $($file)($($line)). This is a bug in X2ModBuildCommon.\""},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\t$redefine = $line -match \"X2MBC-Redefine\""},{"Add":"\t\t\t$lineNr += 1"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_RunPreMakeHooks() {"},{"Add":"\t\tforeach ($hook in $this.preMakeHooks) {"},{"Add":"\t\t\t$hook.Invoke()"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[string]_GetCoreMtime() {"},{"Add":"\t\tif (Test-Path \"$($this.sdkPath)/XComGame/Script/Core.u\") {"},{"Add":"\t\t\treturn Get-Item \"$($this.sdkPath)/XComGame/Script/Core.u\" | Select-Object -ExpandProperty LastWriteTime"},{"Add":"\t\t} else {"},{"Add":"\t\t\treturn \"missing\""},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_CheckCleanCompiled() {"},{"Add":"\t\t# #16: Switching between debug and release causes an error in the make commandlet if script packages aren't deleted."},{"Add":"\t\t# #20: Changes to Globals.uci aren't tracked by UCC, so we must delete script packages if Globals.uci changes."},{"Add":"\t\t$lastBuildDetails = Get-Content $this.makeFingerprintsPath | ConvertFrom-Json"},{"Add":""},{"Add":"\t\t$buildMode = if ($this.debug -eq $true) { \"debug\" } else { \"release\" }"},{"Add":"\t\t$globalsHash = Get-FileHash \"$($this.sdkPath)\\Development\\Src\\Core\\Globals.uci\" | Select-Object -ExpandProperty Hash"},{"Add":"\t\t$coreTimeStamp = $this._GetCoreMtime()"},{"Add":""},{"Add":"\t\t$rebuild = if ($lastBuildDetails.buildMode -ne $buildMode) {"},{"Add":"\t\t\tWrite-Host \"Detected switch between debug and non-debug build.\""},{"Add":"\t\t\t$true"},{"Add":"\t\t} elseif ($lastBuildDetails.coreTimestamp -ne $coreTimeStamp) {"},{"Add":"\t\t\tWrite-Host \"Detected previous external rebuild.\""},{"Add":"\t\t\t$true"},{"Add":"\t\t} elseif ($lastBuildDetails.globalsHash -ne $globalsHash) {"},{"Add":"\t\t\tWrite-Host \"Detected change in macros (Globals.uci).\""},{"Add":"\t\t\t$true"},{"Add":"\t\t} else {"},{"Add":"\t\t\t$false"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t# Order: Deleting first cannot cause an issue because the compiler will just rebuild."},{"Add":"\t\tif ($rebuild) {"},{"Add":"\t\t\tWrite-Host \"Cleaning all compiled scripts from $($this.sdkPath)/XComGame/Script to avoid compiler error...\""},{"Add":"\t\t\tRemove-Item \"$($this.sdkPath)/XComGame/Script/*.u\""},{"Add":"\t\t\tWrite-Host \"Cleaned.\""},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t$lastBuildDetails.buildMode = $buildMode"},{"Add":"\t\t$lastBuildDetails.globalsHash = $globalsHash"},{"Add":""},{"Add":"\t\t# Similarly, recording the previous invocation fingerprints before the build is complete"},{"Add":"\t\t# cannot cause an issue because the compiler will simply continue an interrupted build."},{"Add":"\t\t$lastBuildDetails | ConvertTo-Json | Set-Content -Path $this.makeFingerprintsPath"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_RecordCoreTimestamp() {"},{"Add":"\t\t# Unfortunately, ModBuddy with Fxs' plugin can rebuild the packages under our nose."},{"Add":"\t\t# As a last resort, record the Core.u timestamp"},{"Add":"\t\t$lastBuildDetails = Get-Content $this.makeFingerprintsPath | ConvertFrom-Json"},{"Add":"\t\t$lastBuildDetails.coreTimestamp = $this._GetCoreMtime()"},{"Add":"\t\t$lastBuildDetails | ConvertTo-Json | Set-Content -Path $this.makeFingerprintsPath"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_RunMakeBase() {"},{"Add":"\t\t# build the base game scripts"},{"Add":"\t\t$scriptsMakeArguments = \"make -nopause -unattended\""},{"Add":"\t\tif ($this.final_release -eq $true)"},{"Add":"\t\t{"},{"Add":"\t\t\t$scriptsMakeArguments = \"$scriptsMakeArguments -final_release\""},{"Add":"\t\t}"},{"Add":"\t\tif ($this.debug -eq $true)"},{"Add":"\t\t{"},{"Add":"\t\t\t$scriptsMakeArguments = \"$scriptsMakeArguments -debug\""},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t$handler = [MakeStdoutReceiver]::new($this)"},{"Add":"\t\t$handler.processDescr = \"compiling base game scripts\""},{"Add":"\t\t$this._InvokeEditorCmdlet($handler, $scriptsMakeArguments, 50)"},{"Add":""},{"Add":"\t\t# If we build in final release, we must build the normal scripts too"},{"Add":"\t\tif ($this.final_release -eq $true)"},{"Add":"\t\t{"},{"Add":"\t\t\tWrite-Host \"Compiling base game scripts without final_release...\""},{"Add":"\t\t\t$scriptsMakeArguments = \"make -nopause -unattended\""},{"Add":"\t\t\t$handler = [MakeStdoutReceiver]::new($this)"},{"Add":"\t\t\t$handler.processDescr = \"compiling base game scripts\""},{"Add":"\t\t\t$this._InvokeEditorCmdlet($handler, $scriptsMakeArguments, 50)"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_RunMakeMod() {"},{"Add":"\t\t# build the mod's scripts"},{"Add":"\t\t$scriptsMakeArguments = \"make -nopause -mods $($this.modNameCanonical) $($this.stagingPath)\""},{"Add":"\t\tif ($this.debug -eq $true)"},{"Add":"\t\t{"},{"Add":"\t\t\t$scriptsMakeArguments = \"$scriptsMakeArguments -debug\""},{"Add":"\t\t}"},{"Add":"\t\t$handler = [MakeStdoutReceiver]::new($this)"},{"Add":"\t\t$handler.processDescr = \"compiling mod scripts\""},{"Add":"\t\t$this._InvokeEditorCmdlet($handler, $scriptsMakeArguments, 50)"},{"Add":"\t}"},{"Add":""},{"Add":"\t[bool]_HasNativePackages() {"},{"Add":"\t\t# Check if this is a Highlander and we need to cook things"},{"Add":"\t\t$anynative = $false"},{"Add":"\t\tforeach ($name in $this.modScriptPackages)"},{"Add":"\t\t{"},{"Add":"\t\t\tif ($global:nativescriptpackages.Contains($name)) {"},{"Add":"\t\t\t\t$anynative = $true"},{"Add":"\t\t\t\tbreak"},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":"\t\treturn $anynative"},{"Add":"\t}"},{"Add":""},{"Add":"\t[bool] _HasScriptPackages () {"},{"Add":"\t\treturn $this.modScriptPackages.Length -gt 0"},{"Add":"\t}"},{"Add":""},{"Add":"\t[bool] _ShouldCompileBase () {"},{"Add":"\t\tif ($this._HasScriptPackages()) {"},{"Add":"\t\t\treturn $true"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t# We need to compile base game scripts if cooking assets, otherwise the cooker will just crash if the SDK was cleaned beforehand"},{"Add":"\t\tif ($this._AnyAssetsToCook()) {"},{"Add":"\t\t\treturn $true"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\treturn $false"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_CopyScriptPackages() {"},{"Add":"\t\t# copy packages to staging"},{"Add":"\t\tforeach ($name in $this.modScriptPackages) {"},{"Add":"\t\t\tif ($this.cookHL -and $global:nativescriptpackages.Contains($name))"},{"Add":"\t\t\t{"},{"Add":"\t\t\t\t# This is a native (cooked) script package -- copy important upks"},{"Add":"\t\t\t\tCopy-Item \"$($this.cookerOutputPath)\\$name.upk\" \"$($this.stagingPath)\\CookedPCConsole\" -Force -WarningAction SilentlyContinue"},{"Add":"\t\t\t\tCopy-Item \"$($this.cookerOutputPath)\\$name.upk.uncompressed_size\" \"$($this.stagingPath)\\CookedPCConsole\" -Force -WarningAction SilentlyContinue"},{"Add":"\t\t\t\tWrite-Host \"$($this.cookerOutputPath)\\$name.upk\""},{"Add":"\t\t\t}"},{"Add":"\t\t\telse"},{"Add":"\t\t\t{"},{"Add":"\t\t\t\t# Or this is a non-native package"},{"Add":"\t\t\t\tCopy-Item \"$($this.sdkPath)\\XComGame\\Script\\$name.u\" \"$($this.stagingPath)\\Script\" -Force -WarningAction SilentlyContinue"},{"Add":"\t\t\t\tWrite-Host \"$($this.sdkPath)\\XComGame\\Script\\$name.u\""},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_PrecompileShaders() {"},{"Add":"\t\tWrite-Host \"Checking the need to PrecompileShaders\""},{"Add":"\t\t$contentfiles = @()"},{"Add":""},{"Add":"\t\t# We don't need to consider"},{"Add":"\t\t# .umaps - they will never contain material (instances) objects - only reference them"},{"Add":"\t\t# ContentForCook - seekfree packages have an inlined shader cache"},{"Add":""},{"Add":"\t\tif (Test-Path \"$($this.modSrcRoot)/Content\")"},{"Add":"\t\t{"},{"Add":"\t\t\t$contentfiles += Get-ChildItem \"$($this.modSrcRoot)/Content\" -Include *.upk -Recurse -File"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\tif ($contentfiles.length -eq 0) {"},{"Add":"\t\t\tWrite-Host \"No content files, skipping PrecompileShaders.\""},{"Add":"\t\t\treturn"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t# for ($i = 0; $i -lt $contentfiles.Length; $i++) {"},{"Add":"\t\t# \tWrite-Host $contentfiles[$i]"},{"Add":"\t\t# }"},{"Add":""},{"Add":"\t\t$need_shader_precompile = $false"},{"Add":"\t\t$shaderCacheName = \"$($this.modNameCanonical)_ModShaderCache.upk\""},{"Add":"\t\t$cachedShaderCachePath = \"$($this.buildCachePath)/$($shaderCacheName)\""},{"Add":""},{"Add":"\t\t# Try to find a reason to precompile the shaders"},{"Add":"\t\tif (!(Test-Path -Path $cachedShaderCachePath))"},{"Add":"\t\t{"},{"Add":"\t\t\t$need_shader_precompile = $true"},{"Add":"\t\t}"},{"Add":"\t\telseif ($contentfiles.length -gt 0)"},{"Add":"\t\t{"},{"Add":"\t\t\t$shader_cache = Get-Item $cachedShaderCachePath"},{"Add":""},{"Add":"\t\t\tforeach ($file in $contentfiles)"},{"Add":"\t\t\t{"},{"Add":"\t\t\t\tif ($file.LastWriteTime -gt $shader_cache.LastWriteTime -Or $file.CreationTime -gt $shader_cache.LastWriteTime)"},{"Add":"\t\t\t\t{"},{"Add":"\t\t\t\t\t$need_shader_precompile = $true"},{"Add":"\t\t\t\t\tbreak"},{"Add":"\t\t\t\t}"},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\tif ($need_shader_precompile)"},{"Add":"\t\t{"},{"Add":"\t\t\t# build the mod's shader cache"},{"Add":"\t\t\tWrite-Host \"Precompiling Shaders...\""},{"Add":"\t\t\t$precompileShadersFlags = \"precompileshaders -nopause platform=pc_sm4 DLC=$($this.modNameCanonical)\""},{"Add":""},{"Add":"\t\t\t$handler = [PassthroughReceiver]::new()"},{"Add":"\t\t\t$handler.processDescr = \"precompiling shaders\""},{"Add":"\t\t\t$this._InvokeEditorCmdlet($handler, $precompileShadersFlags, 10)"},{"Add":""},{"Add":"\t\t\tWrite-Host \"Generated Shader Cache.\""},{"Add":""},{"Add":"\t\t\tCopy-Item -Path \"$($this.stagingPath)/Content/$shaderCacheName\" -Destination $this.buildCachePath"},{"Add":"\t\t}"},{"Add":"\t\telse"},{"Add":"\t\t{"},{"Add":"\t\t\tWrite-Host \"No reason to precompile shaders, using existing\""},{"Add":"\t\t\tCopy-Item -Path $cachedShaderCachePath -Destination \"$($this.stagingPath)/Content\""},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_RunCookAssets() {"},{"Add":"\t\t$step = [ModAssetsCookStep]::new($this)"},{"Add":"\t\t$step.Execute()"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_RunCookHL() {"},{"Add":"\t\t$this._EnsureCookerOutputDirExists()"},{"Add":""},{"Add":"\t\t# Cook it"},{"Add":"\t\t# Normally, the mod tools create a symlink in the SDK directory to the game CookedPCConsole directory,"},{"Add":"\t\t# but we'll just be using the game one to make it more robust"},{"Add":"\t\t$cookedpcconsoledir = [io.path]::combine($this.gamePath, 'XComGame', 'CookedPCConsole')"},{"Add":""},{"Add":"\t\t[System.String[]]$files = \"GuidCache.upk\", \"GlobalPersistentCookerData.upk\", \"PersistentCookerShaderData.bin\""},{"Add":"\t\tforeach ($name in $files) {"},{"Add":"\t\t\tif(-not(Test-Path ([io.path]::combine($this.cookerOutputPath, $name))))"},{"Add":"\t\t\t{"},{"Add":"\t\t\t\tWrite-Host \"Copying $name...\""},{"Add":"\t\t\t\tCopy-Item ([io.path]::combine($cookedpcconsoledir, $name)) $this.cookerOutputPath"},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t# Ideally, the cooking process wouldn't modify the big *.tfc files, but it does, so we don't overwrite existing ones (/XC /XN /XO)"},{"Add":"\t\t# In order to \"reset\" the cooking direcory, just delete it and let the script recreate them"},{"Add":"\t\tWrite-Host \"Copying Texture File Caches...\""},{"Add":"\t\tRobocopy.exe \"$cookedpcconsoledir\" \"$($this.cookerOutputPath)\" *.tfc /NJH /XC /XN /XO"},{"Add":"\t\tWrite-Host \"Copied Texture File Caches.\""},{"Add":""},{"Add":"\t\t# Prepare editor args"},{"Add":"\t\t$cook_args = @(\"cookpackages\", \"-platform=pcconsole\", \"-quickanddirty\", \"-modcook\", \"-sha\", \"-multilanguagecook=INT+FRA+ITA+DEU+RUS+POL+KOR+ESN\", \"-singlethread\", \"-nopause\")"},{"Add":"\t\tif ($this.final_release -eq $true)"},{"Add":"\t\t{"},{"Add":"\t\t\t$cook_args += \"-final_release\""},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t# The CookPackages commandlet generally is super unhelpful. The output is basically always the same and errors"},{"Add":"\t\t# don't occur -- it rather just crashes the game. Hence, we just buffer the output and present it to user only"},{"Add":"\t\t# if something went wrong"},{"Add":""},{"Add":"\t\t# TODO: Filter more lines for HL cook? `Hashing`? `SHA: package not found`? `Couldn't find localized resource`?"},{"Add":"\t\t# `Warning, Texture file cache waste exceeds`? `Warning, Package _ is not conformed`?"},{"Add":"\t\t$handler = [BufferingReceiver]::new()"},{"Add":"\t\t$handler.processDescr = \"cooking native packages\""},{"Add":""},{"Add":"\t\t# Cook it!"},{"Add":"\t\tWrite-Host \"Invoking CookPackages (this may take a while)\""},{"Add":"\t\t$this._InvokeEditorCmdlet($handler, $cook_args, 10)"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void] _EnsureCookerOutputDirExists () {"},{"Add":"\t\tif(-not(Test-Path $this.cookerOutputPath)) {"},{"Add":"\t\t\tWrite-Host \"Creating Published/CookedPCConsole directory...\""},{"Add":"\t\t\tNew-Item $this.cookerOutputPath -ItemType Directory"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_CopyMissingUncooked() {"},{"Add":"\t\tif ($this.contentOptions.missingUncooked.Length -lt 1)"},{"Add":"\t\t{"},{"Add":"\t\t\tWrite-Host \"Skipping Missing Uncooked logic\""},{"Add":"\t\t\treturn"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\tWrite-Host \"Including MissingUncooked\""},{"Add":""},{"Add":"\t\t$missingUncookedPath = [io.path]::Combine($this.stagingPath, \"Content\", \"MissingUncooked\")"},{"Add":"\t\t$sdkContentPath = [io.path]::Combine($this.sdkPath, \"XComGame\", \"Content\")"},{"Add":""},{"Add":"\t\tif (!(Test-Path $missingUncookedPath))"},{"Add":"\t\t{"},{"Add":"\t\t\tNew-Item -ItemType \"directory\" -Path $missingUncookedPath"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\tforeach ($fileName in $this.contentOptions.missingUncooked)"},{"Add":"\t\t{"},{"Add":"\t\t\t(Get-ChildItem -Path $sdkContentPath -Filter $fileName -Recurse).FullName | Copy-Item -Destination $missingUncookedPath"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_FinalCopy() {"},{"Add":"\t\t# copy all staged files to the actual game's mods folder"},{"Add":"\t\t# TODO: Is the string interpolation required in the robocopy calls?"},{"Add":"\t\tRobocopy.exe \"$($this.stagingPath)\" \"$($this.finalModPath)\" *.* $global:def_robocopy_args"},{"Add":"\t}"},{"Add":""},{"Add":"\t[string[]] _PrepareBuildCacheEngineIniWithAdditions ([string] $fileNamePrefix, [array] $lines) {"},{"Add":"\t\t$localDefaultEngineIniPath = [io.path]::combine($this.buildCachePath, $fileNamePrefix + \"_DefaultEngine.ini\")"},{"Add":"\t\t$localXComEngineIniPath = [io.path]::combine($this.buildCachePath, $fileNamePrefix + \"_XComEngine.ini\")"},{"Add":""},{"Add":"\t\t$newEngineIniContent = $this.sdkEngineIniContent + \"`n\" + ($lines -join \"`n\") + \"`n\""},{"Add":"\t\t$newEngineIniContent | Set-Content $localDefaultEngineIniPath -NoNewline"},{"Add":""},{"Add":"\t\treturn @($localDefaultEngineIniPath, $localXComEngineIniPath)"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]_InvokeEditorCmdlet([StdoutReceiver] $receiver, [string] $makeFlags, [int] $sleepMsDuration) {"},{"Add":"\t\t# Create a ProcessStartInfo object to hold the details of the make command, its arguments, and set up"},{"Add":"\t\t# stdout/stderr redirection."},{"Add":"\t\t$pinfo = New-Object System.Diagnostics.ProcessStartInfo"},{"Add":"\t\t$pinfo.FileName = $this.commandletHostPath"},{"Add":"\t\t$pinfo.RedirectStandardOutput = $true"},{"Add":"\t\t$pinfo.RedirectStandardError = $true"},{"Add":"\t\t$pinfo.UseShellExecute = $false"},{"Add":"\t\t$pinfo.Arguments = $makeFlags"},{"Add":"\t\t$pinfo.WorkingDirectory = $this.commandletHostPath | Split-Path"},{"Add":""},{"Add":""},{"Add":"\t\t# Set the exited flag on our exit object on process exit."},{"Add":"\t\t# We need another object for the Exited event to set a flag we can monitor from this function."},{"Add":"\t\t$exitData = New-Object psobject -property @{ exited = $false }"},{"Add":"\t\t$exitAction = {"},{"Add":"\t\t\t$event.MessageData.exited = $true"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t# An action for handling data written to stderr. The Cmdlets don't seem to write anything here,"},{"Add":"\t\t# or at least not diagnostics, so we can just pass it through."},{"Add":"\t\t$errAction = {"},{"Add":"\t\t\t$errTxt = $Event.SourceEventArgs.Data"},{"Add":"\t\t\tWrite-Host $errTxt"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t$messageData = New-Object psobject -property @{"},{"Add":"\t\t\thandler = $receiver"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t# Create an stdout filter action delegating to the actual implementation"},{"Add":"\t\t$outAction = {"},{"Add":"\t\t\t[StdoutReceiver] $handler = $event.MessageData.handler"},{"Add":"\t\t\t[string] $outTxt = $Event.SourceEventArgs.Data"},{"Add":"\t\t\t$handler.ParseLine($outTxt)"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t# Create the process and register for the various events we care about."},{"Add":"\t\t$process = New-Object System.Diagnostics.Process"},{"Add":"\t\tRegister-ObjectEvent -InputObject $process -EventName OutputDataReceived -Action $outAction -MessageData $messageData | Out-Null"},{"Add":"\t\tRegister-ObjectEvent -InputObject $process -EventName ErrorDataReceived -Action $errAction | Out-Null"},{"Add":"\t\tRegister-ObjectEvent -InputObject $process -EventName Exited -Action $exitAction -MessageData $exitData | Out-Null"},{"Add":"\t\t$process.StartInfo = $pinfo"},{"Add":""},{"Add":"\t\t# All systems go!"},{"Add":"\t\t$process.Start() | Out-Null"},{"Add":"\t\t$process.BeginOutputReadLine()"},{"Add":"\t\t$process.BeginErrorReadLine()"},{"Add":""},{"Add":"\t\t# Wait for the process to exit. This is horrible, but using $process.WaitForExit() blocks"},{"Add":"\t\t# the powershell thread so we get no output from make echoed to the screen until the process finishes."},{"Add":"\t\t# By polling we get regular output as it goes."},{"Add":"\t\ttry {"},{"Add":"\t\t\tif ($sleepMsDuration -lt 1) {"},{"Add":"\t\t\t\twhile (!$exitData.exited) {"},{"Add":"\t\t\t\t\t# Just spin"},{"Add":"\t\t\t\t}"},{"Add":"\t\t\t} else {"},{"Add":"\t\t\t\twhile (!$exitData.exited) {"},{"Add":"\t\t\t\t\tStart-Sleep -m $sleepMsDuration"},{"Add":"\t\t\t\t}"},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":"\t\tfinally {"},{"Add":"\t\t\t# If we are stopping MSBuild hosted build, we need to kill the editor manually"},{"Add":"\t\t\tif (!$exitData.exited) {"},{"Add":"\t\t\t\tWrite-Host \"Killing $($receiver.processDescr) tree\""},{"Add":"\t\t\t\tKillProcessTree $process.Id"},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t$exitCode = $process.ExitCode"},{"Add":"\t\t$receiver.Finish($exitCode)"},{"Add":"\t}"},{"Add":""},{"Add":"\t[bool] _AnyAssetsToCook () {"},{"Add":"\t\treturn ($this.contentOptions.sfStandalone.Length -gt 0) -or ($this.contentOptions.sfMaps.Length -gt 0) -or ($this.contentOptions.sfCollectionMaps.Length -gt 0)"},{"Add":"\t}"},{"Add":"}"},{"Add":""},{"Add":"class ModAssetsCookStep {"},{"Add":"\t[BuildProject] $project"},{"Add":""},{"Add":"\t[string] $xpackTfcSuffix = '_XPACK_'"},{"Add":"\t[string] $actualTfcSuffix"},{"Add":""},{"Add":"\t[string] $contentForCookPath"},{"Add":"\t[string] $collectionMapsPath"},{"Add":""},{"Add":"\t[string] $sdkContentModsDir"},{"Add":"\t[string] $sdkContentModsOurDir"},{"Add":""},{"Add":"\t[string[]] $dirtyMaps"},{"Add":"\t[string[]] $cookedMaps"},{"Add":"\t[string[]] $sfCollectionOnlyMaps"},{"Add":""},{"Add":"\t[string] $engineIniDefaultPath"},{"Add":"\t[string] $engineIniXComPath"},{"Add":""},{"Add":"\t[string] $editorArgs"},{"Add":""},{"Add":"\t[string] $cookerOutputTrackerPath"},{"Add":"\t[object] $cookerOutputTracker"},{"Add":""},{"Add":"\tModAssetsCookStep ([BuildProject] $project) {"},{"Add":"\t\t$this.project = $project"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void] Execute() {"},{"Add":"\t\tif (!$this.project._AnyAssetsToCook()) {"},{"Add":"\t\t\tWrite-Host \"No asset cooking is requested, skipping\""},{"Add":"\t\t\treturn"},{"Add":""},{"Add":"\t\t\t# TODO: Check if there are any assets in ContentForCook when no cooking is configured"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\tWrite-Host \"Initializing assets cooking\""},{"Add":""},{"Add":"\t\t$this._Init()"},{"Add":"\t\t$this._VerifyProjectAndSdk()"},{"Add":""},{"Add":"\t\tWrite-Host \"Preparing assets cooking\""},{"Add":""},{"Add":"\t\t$this._PrepareSdkFolders()"},{"Add":"\t\t$this._PrepareProjectCache()"},{"Add":""},{"Add":"\t\t$this._VerifyCachedTfcsNotAltered() # Needs to be after _PrepareProjectCache (CollectionMaps are created) and _PrepareSdkFolders (otherwise Get-ChildItem for TFCs fails)"},{"Add":"\t\t$this._VerifyCachedSfPackagesNotAltered()"},{"Add":""},{"Add":"\t\t$this._DetermineDirtyMaps()"},{"Add":"\t\t$this._PrepareEngineIni()"},{"Add":"\t\t$this._PrepareEditorArgs()"},{"Add":""},{"Add":"\t\tWrite-Host \"Starting assets cooking\""},{"Add":""},{"Add":"\t\t$this._ExecuteCore()"},{"Add":"\t\t$this._WarnTfcGrowth()"},{"Add":"\t\t$this._RecordCookerOutputTracker()"},{"Add":"\t\t$this._StageArtifacts()"},{"Add":""},{"Add":"\t\tWrite-Host \"Assets cook completed\""},{"Add":"\t}"},{"Add":""},{"Add":"\t[void] _Init() {"},{"Add":"\t\t$this.actualTfcSuffix = \"_$($this.project.modNameCanonical)_DLCTFC$($this.xpackTfcSuffix)\""},{"Add":""},{"Add":"\t\t$this.contentForCookPath = \"$($this.project.modSrcRoot)\\ContentForCook\""},{"Add":"\t\t$this.collectionMapsPath = [io.path]::combine($this.project.buildCachePath, 'CollectionMaps')"},{"Add":""},{"Add":"\t\t$this.sdkContentModsDir = [io.path]::combine($this.project.sdkPath, 'XComGame', 'Content', 'Mods')"},{"Add":"\t\t$this.sdkContentModsOurDir = [io.path]::combine($this.sdkContentModsDir, $this.project.modNameCanonical)"},{"Add":""},{"Add":"\t\t$this.cookedMaps = @($this.project.contentOptions.sfMaps)"},{"Add":"\t\tforeach ($mapDef in $this.project.contentOptions.sfCollectionMaps) {"},{"Add":"\t\t\t$this.cookedMaps += $mapDef.name"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t$this.sfCollectionOnlyMaps = @()"},{"Add":"\t\tforeach ($mapDef in $this.project.contentOptions.sfCollectionMaps) {"},{"Add":"\t\t\tif ($null -eq (Get-ChildItem -Path $this.contentForCookPath -Filter $mapDef.name -Recurse)) {"},{"Add":"\t\t\t\t$this.sfCollectionOnlyMaps += $mapDef.name"},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t$this.cookerOutputTrackerPath = [io.path]::combine($this.project.buildCachePath, 'AssetsCookerOutputTracker.json')"},{"Add":""},{"Add":"\t\tif (Test-Path $this.cookerOutputTrackerPath) {"},{"Add":"\t\t\t$this.cookerOutputTracker = Get-Content $this.cookerOutputTrackerPath | ConvertFrom-Json"},{"Add":"\t\t} else {"},{"Add":"\t\t\t$this.cookerOutputTracker = [PSCustomObject]@{"},{"Add":"\t\t\t\ttfcFiles = @() # Assume no TFCs if no info is stored. This will cause a full recook if any are found"},{"Add":"\t\t\t\tsfPackages = @()"},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void] _VerifyProjectAndSdk() {"},{"Add":"\t\t# TODO: consider removing this requirement."},{"Add":"\t\t# It might be legitimate use case to cook a \"secondary\" vanilla package or a collection map that consists of only vanilla packages"},{"Add":"\t\tif (-not(Test-Path $this.contentForCookPath))"},{"Add":"\t\t{"},{"Add":"\t\t\tThrowFailure \"Asset cooking is requested, but no ContentForCook folder is present\""},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\tif (Test-Path $this.sdkContentModsOurDir) {"},{"Add":"\t\t\t# If we have any files, then something is happening here - abort"},{"Add":"\t\t\tif ($null -ne (Get-ChildItem -Path $this.sdkContentModsOurDir -Force -Recurse)) {"},{"Add":"\t\t\t\tThrowFailure \"$($this.sdkContentModsOurDir) is already in use (not empty)\""},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t# The DLC cooker needs to read/copy the shipped GPCD"},{"Add":"\t\t$shippedGpcdPath = [io.path]::combine($this.project.sdkPath, 'XComGame', 'CookedPCConsole', 'GlobalPersistentCookerData.upk')"},{"Add":"\t\tif (!(Test-Path $shippedGpcdPath)) {"},{"Add":"\t\t\tThrowFailure \"$shippedGpcdPath does not exist. Please verify your that your SDK is configured correctly\""},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void] _PrepareProjectCache() {"},{"Add":"\t\t# Prep the folder for the collection maps"},{"Add":"\t\t# Not the most efficient approach, but there are bigger time saves to be had"},{"Add":"\t\tRemove-Item $this.collectionMapsPath -Force -Recurse -WarningAction SilentlyContinue -ErrorAction SilentlyContinue"},{"Add":"\t\tNew-Item -ItemType \"directory\" -Path $this.collectionMapsPath"},{"Add":""},{"Add":"\t\tforeach ($map in $this.sfCollectionOnlyMaps) {"},{"Add":"\t\t\t# Important: we cannot use .umap extension here - git lfs (if in use) gets confused during git subtree add"},{"Add":"\t\t\t# See https://github.com/X2CommunityCore/X2ModBuildCommon/wiki/Do-not-use-.umap-for-files-in-this-repo"},{"Add":"\t\t\tCopy-Item \"$global:buildCommonSelfPath\\EmptyUMap\" \"$($this.collectionMapsPath)\\$map.umap\""},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void] _VerifyCachedTfcsNotAltered () {"},{"Add":"\t\tif (!$this._CheckCachedTfcsNotAltered()) {"},{"Add":"\t\t\tWrite-Host \"Performing a full recook\""},{"Add":"\t\t\tCleanModAssetCookerOutput $this.project.sdkPath $this.project.modNameCanonical @($this.contentForCookPath, $this.collectionMapsPath)"},{"Add":""},{"Add":"\t\t\t# Save that everything is deleted"},{"Add":"\t\t\t$this.cookerOutputTracker.tfcFiles = @()"},{"Add":"\t\t\t$this._RecordCookerOutputTracker()"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[bool] _CheckCachedTfcsNotAltered () {"},{"Add":"\t\t[System.Collections.ArrayList] $currentTfcs = @($this._GetOurTfcFiles() | Select-Object -ExpandProperty Name)"},{"Add":""},{"Add":"\t\tforeach ($trackedFileData in $this.cookerOutputTracker.tfcFiles) {"},{"Add":"\t\t\tif (!$currentTfcs.Contains($trackedFileData.fullFileName)) {"},{"Add":"\t\t\t\tWrite-Host \"$($trackedFileData.fullFileName) is missing\""},{"Add":"\t\t\t\treturn $false"},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\t$path = [io.path]::combine($this.project.cookerOutputPath, $trackedFileData.fullFileName)"},{"Add":"\t\t\t$file = Get-Item $path"},{"Add":""},{"Add":"\t\t\tif ($file.LastWriteTimeUtc.Ticks -ne $trackedFileData.lastUpdatedUtc) {"},{"Add":"\t\t\t\tWrite-Host \"$($trackedFileData.fullFileName) timestamp mismatch\""},{"Add":"\t\t\t\treturn $false"},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\t$currentTfcs.Remove($trackedFileData.fullFileName)"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\tif ($currentTfcs.Count -gt 0) {"},{"Add":"\t\t\tWrite-Host \"Unexpected TFCs found: $currentTfcs\""},{"Add":"\t\t\treturn $false"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\treturn $true"},{"Add":"\t}"},{"Add":""},{"Add":"\t# Why is this needed?"},{"Add":"\t# It's technically fine to cook the same package from multiple mods."},{"Add":"\t# However, if the package ends up having any textures that point to a TFC file,"},{"Add":"\t# they will be pointing to a TFC that we will not ship (as it is of a different DLC)"},{"Add":"\t# which at runtime will at best cause missing mip levels, and at worst, crash the game."},{"Add":"\t[void] _VerifyCachedSfPackagesNotAltered () {"},{"Add":"\t\t# Delete tracked if timestamp doesn't match"},{"Add":""},{"Add":"\t\tforeach ($trackedFileData in $this.cookerOutputTracker.sfPackages) {"},{"Add":"\t\t\t$path = [io.path]::combine($this.project.cookerOutputPath, $trackedFileData.fullFileName)"},{"Add":""},{"Add":"\t\t\tif (Test-Path $path) {"},{"Add":"\t\t\t\t$file = Get-Item $path"},{"Add":""},{"Add":"\t\t\t\tif ($file.LastWriteTimeUtc.Ticks -ne $trackedFileData.lastUpdatedUtc) {"},{"Add":"\t\t\t\t\tWrite-Host \"$($trackedFileData.fullFileName) timestamp mismatch - deleting\""},{"Add":"\t\t\t\t\tRemove-Item $path -Force"},{"Add":"\t\t\t\t}"},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t# Delete supposed-to-cook if they exist but are not tracked"},{"Add":""},{"Add":"\t\tforeach ($fileName in $this._GetDesiredOutputPackageFileNames()) {"},{"Add":"\t\t\t$path = [io.path]::combine($this.project.cookerOutputPath, $fileName)"},{"Add":"\t\t\t$trackedFileData = $this._GetSfPackageTrackerData($fileName)"},{"Add":""},{"Add":"\t\t\tif ($null -eq $trackedFileData -and (Test-Path $path)) {"},{"Add":"\t\t\t\tWrite-Host \"$fileName exists, but is not tracked - deleting\""},{"Add":"\t\t\t\tRemove-Item $path -Force"},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void] _DetermineDirtyMaps () {"},{"Add":"\t\t$this.dirtyMaps = @()"},{"Add":""},{"Add":"\t\t# Check the dev-made maps"},{"Add":"\t\t# Not the best (doesn't take into account the dependencies - FIXME) but will suffice for now."},{"Add":"\t\tforeach ($map in $this.cookedMaps) {"},{"Add":"\t\t\tif ($this.sfCollectionOnlyMaps.Contains($map)) { continue; }"},{"Add":""},{"Add":"\t\t\t$cookedPath = [io.path]::combine($this.project.cookerOutputPath, \"$map.upk\")"},{"Add":""},{"Add":"\t\t\tif (!(Test-Path $cookedPath)) {"},{"Add":"\t\t\t\tWrite-Host \"$map has no cooked version\""},{"Add":"\t\t\t\t$this.dirtyMaps += $map"},{"Add":"\t\t\t}"},{"Add":"\t\t\telse {"},{"Add":"\t\t\t\t$original = Get-ChildItem -Path $this.contentForCookPath -Include \"$map.umap\" -Recurse"},{"Add":""},{"Add":"\t\t\t\tif ($original.LastWriteTime -gt (Get-Item $cookedPath).LastWriteTime) {"},{"Add":"\t\t\t\t\t$this.dirtyMaps += $map"},{"Add":"\t\t\t\t\tWrite-Host \"$map original was updated\""},{"Add":"\t\t\t\t}"},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t# Check the collection maps"},{"Add":"\t\tforeach ($mapDef in $this.project.contentOptions.sfCollectionMaps) {"},{"Add":"\t\t\t$map = $mapDef.name"},{"Add":"\t\t\t$cookedPath = [io.path]::combine($this.project.cookerOutputPath, \"$map.upk\")"},{"Add":""},{"Add":"\t\t\tif ($this.dirtyMaps.Contains($map)) { continue; }"},{"Add":""},{"Add":"\t\t\tif (!(Test-Path $cookedPath)) {"},{"Add":"\t\t\t\tWrite-Host \"$map has no cooked version\""},{"Add":"\t\t\t\t$this.dirtyMaps += $map"},{"Add":"\t\t\t}"},{"Add":"\t\t\telse {"},{"Add":"\t\t\t\t$existingCooked = Get-Item $cookedPath"},{"Add":""},{"Add":"\t\t\t\tforeach ($package in $mapDef.packages) {"},{"Add":"\t\t\t\t\tif (((Get-ChildItem -Path $this.contentForCookPath -Include \"$package.upk\" -Recurse).LastWriteTime) -gt $existingCooked.LastWriteTime) {"},{"Add":"\t\t\t\t\t\tWrite-Host \"$map dependency was updated ($package)\""},{"Add":"\t\t\t\t\t\t$this.dirtyMaps += $map"},{"Add":"\t\t\t\t\t\tbreak"},{"Add":"\t\t\t\t\t}"},{"Add":"\t\t\t\t}"},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void] _PrepareEngineIni() {"},{"Add":"\t\t$this.engineIniDefaultPath, $this.engineIniXComPath ="},{"Add":"\t\t\t$this.project._PrepareBuildCacheEngineIniWithAdditions(\"AssetsCook\", $this._PrepareEngineIniAdditions())"},{"Add":"\t}"},{"Add":""},{"Add":"\t[string[]] _PrepareEngineIniAdditions () {"},{"Add":"\t\t$lines = @()"},{"Add":""},{"Add":"\t\t# \"Inject\" our assets into the SDK to make them visible to the cooker"},{"Add":"\t\t$lines += \"[Core.System]\""},{"Add":"\t\t$lines += \"+Paths=$($this.contentForCookPath)\""},{"Add":"\t\t$lines += \"-Paths=..\\..\\XComGame\\Content\\Mods\" # Do not actually load the packages from there"},{"Add":""},{"Add":"\t\tif ($this.sfCollectionOnlyMaps.Length -gt 0) {"},{"Add":"\t\t\t$lines += \"+Paths=$($this.collectionMapsPath)\""},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t# Stop all the \"Adding [...]\" garbage"},{"Add":"\t\t# TODO: our maps here?"},{"Add":"\t\t$lines += \"[Engine.X2DirectoriesToSkipEnumeration]\""},{"Add":"\t\t$lines += \".Directory=..\\..\\XComGame\""},{"Add":"\t\t$lines += \".Directory=..\\..\\Engine\""},{"Add":""},{"Add":"\t\t# Collection maps"},{"Add":"\t\t# TODO: Switch + to ."},{"Add":"\t\t$lines += \"[Engine.PackagesToForceCookPerMap]\""},{"Add":"\t\tforeach ($mapDef in $this.project.contentOptions.sfCollectionMaps) {"},{"Add":"\t\t\t$lines += \"+Map=$($mapDef.name)\""},{"Add":""},{"Add":"\t\t\tforeach ($package in $mapDef.packages) {"},{"Add":"\t\t\t\t$lines += \"+Package=$package\""},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\treturn $lines"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void] _PrepareSdkFolders () {"},{"Add":"\t\t$this.project._EnsureCookerOutputDirExists()"},{"Add":""},{"Add":"\t\tif (-not(Test-Path $this.sdkContentModsOurDir)) {"},{"Add":"\t\t\tWrite-Host \"Creating $($this.sdkContentModsOurDir) directory...\""},{"Add":"\t\t\tNew-Item $this.sdkContentModsOurDir -ItemType Directory"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void] _PrepareEditorArgs () {"},{"Add":"\t\t$cookerFlags = \"-platform=pcconsole -skipmaps -TFCSUFFIX=$($this.xpackTfcSuffix) -singlethread -unattended -DLCName=$($this.project.modNameCanonical)\""},{"Add":"\t\t$mapsString = $this.dirtyMaps -join \" \""},{"Add":""},{"Add":"\t\t$this.editorArgs = \"CookPackages $mapsString $cookerFlags -DEFENGINEINI=\"\"$($this.engineIniDefaultPath)\"\" -ENGINEINI=\"\"$($this.engineIniXComPath)\"\"\""},{"Add":"\t}"},{"Add":""},{"Add":"\t[void] _ExecuteCore () {"},{"Add":"\t\t# This try block needs to be kept as small as possible as it puts the SDK into a (temporary) invalid state"},{"Add":"\t\ttry {"},{"Add":"\t\t\tif ($this.project.contentOptions.sfStandalone.Length -gt 0) {"},{"Add":"\t\t\t\t# Create iterator guard (the first package alphabetically is always skipped)"},{"Add":"\t\t\t\t$this._CreateMarkerPackageFile('000000000_________IteratorGuard')"},{"Add":""},{"Add":"\t\t\t\t# Create dummy files for each of the seekfree standalone packages"},{"Add":"\t\t\t\tforeach ($package in $this.project.contentOptions.sfStandalone) {"},{"Add":"\t\t\t\t\t$this._CreateMarkerPackageFile($package)"},{"Add":"\t\t\t\t}"},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\t$this._InvokeAssetCooker($this.editorArgs)"},{"Add":"\t\t}"},{"Add":"\t\tfinally {"},{"Add":"\t\t\tWrite-Host \"Cleaning up the asset cooking hacks\""},{"Add":"\t\t\t$cleanupFailed = $false"},{"Add":""},{"Add":"\t\t\ttry {"},{"Add":"\t\t\t\tRemove-Item -Recurse -Force \"$($this.sdkContentModsOurDir)\\*\""},{"Add":"\t\t\t\tWrite-Host \"Emptied $($this.sdkContentModsOurDir)\""},{"Add":"\t\t\t}"},{"Add":"\t\t\tcatch {"},{"Add":"\t\t\t\tFailureMessage \"Failed to empty $($($this.sdkContentModsOurDir))\""},{"Add":"\t\t\t\tFailureMessage $_"},{"Add":""},{"Add":"\t\t\t\t$cleanupFailed = $true"},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\tif ($cleanupFailed) {"},{"Add":"\t\t\t\tWrite-Host \"\""},{"Add":"\t\t\t\tWrite-Host \"\""},{"Add":"\t\t\t\tThrowFailure \"Failed to clean up the asset cooking hacks - your SDK is now in a corrupted state. Please preform the cleanup manually before building a mod or opening the editor.\""},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void] _CreateMarkerPackageFile ([string] $packageName) {"},{"Add":"\t\tNew-Item -Path $this.sdkContentModsOurDir -Name \"$packageName.upk\" -ItemType File"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void] _InvokeAssetCooker ([string] $editorArguments) {"},{"Add":"\t\tWrite-Host $editorArguments"},{"Add":""},{"Add":"\t\t$handler = [ModcookReceiver]::new()"},{"Add":"\t\t$handler.processDescr = \"cooking mod packages\""},{"Add":""},{"Add":"\t\t# Even a sleep of 1 ms causes a noticable delay between cooker being done (files created)"},{"Add":"\t\t# and output completing. So, just spin"},{"Add":"\t\t$this.project._InvokeEditorCmdlet($handler, $editorArguments, 0)"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void] _WarnTfcGrowth () {"},{"Add":"\t\t$tfcs = $this._GetOurTfcFiles()"},{"Add":"\t\t$growthEntries = @()"},{"Add":""},{"Add":"\t\tforeach ($file in $tfcs) {"},{"Add":"\t\t\t$trackedFileData = $this._GetTfcTrackerData($file.Name)"},{"Add":""},{"Add":"\t\t\tif ($null -eq $trackedFileData) {"},{"Add":"\t\t\t\t# New file - ignore"},{"Add":"\t\t\t\tcontinue"},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\tif ($file.Length -eq $trackedFileData.originalSize) {"},{"Add":"\t\t\t\tcontinue"},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\t$increase = $file.Length / $trackedFileData.originalSize"},{"Add":""},{"Add":"\t\t\t$growthEntries += [PSCustomObject]@{"},{"Add":"\t\t\t\tName = $file.Name"},{"Add":"\t\t\t\tOriginalSize = FormatFileSize($trackedFileData.originalSize)"},{"Add":"\t\t\t\tCurrentSize = FormatFileSize($file.Length)"},{"Add":"\t\t\t\tIncrease = \"${increase}x\""},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\tif ($growthEntries.Length -gt 0) {"},{"Add":"\t\t\t$growthEntries | Format-Table | Out-String | Write-Host"},{"Add":""},{"Add":"\t\t\tWrite-Host \"WARNING: TFC files grew since initial creation. This could indicate data duplication.\""},{"Add":"\t\t\tWrite-Host \"Your mod will still function normally, but the file size might be larger than needed\""},{"Add":"\t\t\tWrite-Host \"(i.e. useless data present). See above for details.\""},{"Add":"\t\t\tWrite-Host \"You should consider doing a full rebuild before distributing your mod (e.g. via the workshop).\""},{"Add":"\t\t\tWrite-Host \"\""},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t# TODO: current logic doesn't account for case when a package (which has/had textures) is removed from the seekfree list."},{"Add":"\t\t# We will keep shipping the TFC (with useless data) in this case without any warnings"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void] _RecordCookerOutputTracker () {"},{"Add":"\t\t# TFCs"},{"Add":""},{"Add":"\t\t$tfcs = $this._GetOurTfcFiles()"},{"Add":""},{"Add":"\t\tforeach ($file in $tfcs) {"},{"Add":"\t\t\t$trackedFileData = $this._GetTfcTrackerData($file.Name)"},{"Add":""},{"Add":"\t\t\tif ($null -eq $trackedFileData) {"},{"Add":"\t\t\t\t# Write-Host \"New file: $($file.Name)\""},{"Add":""},{"Add":"\t\t\t\t$this.cookerOutputTracker.tfcFiles += [PSCustomObject]@{"},{"Add":"\t\t\t\t\tfullFileName = $file.Name"},{"Add":"\t\t\t\t\toriginalSize = $file.Length"},{"Add":"\t\t\t\t\tlastUpdatedUtc = $file.LastWriteTimeUtc.Ticks"},{"Add":"\t\t\t\t}"},{"Add":""},{"Add":"\t\t\t\tcontinue"},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\t# Not a new file - just store the new last updated time"},{"Add":"\t\t\t$trackedFileData.lastUpdatedUtc = $file.LastWriteTimeUtc.Ticks"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t# SF packages"},{"Add":""},{"Add":"\t\t$sfPackageFilesNames = $this._GetDesiredOutputPackageFileNames()"},{"Add":"\t\t# Write-Host \"sfPackages: $sfPackageFilesNames\""},{"Add":""},{"Add":"\t\t# SF packages (removed)"},{"Add":"\t\t$this.cookerOutputTracker.sfPackages = @($this.cookerOutputTracker.sfPackages | Where-Object { $sfPackageFilesNames.Contains($_.fullFileName) })"},{"Add":""},{"Add":"\t\t# SF packages (new/updated)"},{"Add":""},{"Add":"\t\tforeach ($fileName in $sfPackageFilesNames) {"},{"Add":"\t\t\t$file = Get-Item \"$($this.project.cookerOutputPath)\\$fileName\""},{"Add":"\t\t\t$trackedFileData = $this._GetSfPackageTrackerData($file.Name)"},{"Add":""},{"Add":"\t\t\tif ($null -eq $trackedFileData) {"},{"Add":"\t\t\t\t# Write-Host \"New file: $($file.Name)\""},{"Add":""},{"Add":"\t\t\t\t$this.cookerOutputTracker.sfPackages += [PSCustomObject]@{"},{"Add":"\t\t\t\t\tfullFileName = $file.Name"},{"Add":"\t\t\t\t\tlastUpdatedUtc = $file.LastWriteTimeUtc.Ticks"},{"Add":"\t\t\t\t}"},{"Add":""},{"Add":"\t\t\t\tcontinue"},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\t# Not a new file - just store the new last updated time"},{"Add":"\t\t\t$trackedFileData.lastUpdatedUtc = $file.LastWriteTimeUtc.Ticks"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t# Write the file"},{"Add":"\t\t$this.cookerOutputTracker | ConvertTo-Json | Set-Content -Path $this.cookerOutputTrackerPath"},{"Add":"\t}"},{"Add":""},{"Add":"\t[string[]] _GetDesiredOutputPackageFileNames () {"},{"Add":"\t\t$sfPackageFilesNames = @($this.project.contentOptions.sfStandalone | Foreach-Object { \"${_}_SF\" })"},{"Add":"\t\t$sfPackageFilesNames += $this.cookedMaps"},{"Add":""},{"Add":"\t\treturn @($sfPackageFilesNames | Foreach-Object { \"$_.upk\" })"},{"Add":"\t}"},{"Add":""},{"Add":"\t[PSCustomObject] _GetTfcTrackerData ([string] $fullFileName) {"},{"Add":"\t\tforeach ($fileData in $this.cookerOutputTracker.tfcFiles) {"},{"Add":"\t\t\tif ($fullFileName -eq $fileData.fullFileName) {"},{"Add":"\t\t\t\treturn $fileData"},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\treturn $null"},{"Add":"\t}"},{"Add":""},{"Add":"\t[PSCustomObject] _GetSfPackageTrackerData ([string] $fullFileName) {"},{"Add":"\t\tforeach ($fileData in $this.cookerOutputTracker.sfPackages) {"},{"Add":"\t\t\tif ($fullFileName -eq $fileData.fullFileName) {"},{"Add":"\t\t\t\treturn $fileData"},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\treturn $null"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void] _StageArtifacts () {"},{"Add":"\t\t# Prepare the folder for cooked stuff"},{"Add":"\t\t$stagingCookedDir = [io.path]::combine($this.project.stagingPath, 'CookedPCConsole')"},{"Add":"\t\tif (!(Test-Path $stagingCookedDir)) {"},{"Add":"\t\t\tNew-Item -ItemType \"directory\" -Path $stagingCookedDir"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t# Copy over the TFC files"},{"Add":"\t\t$this._GetOurTfcFiles() | Copy-Item -Destination $stagingCookedDir"},{"Add":""},{"Add":"\t\t# Copy over the maps"},{"Add":"\t\tfor ($i = 0; $i -lt $this.cookedMaps.Length; $i++)"},{"Add":"\t\t{"},{"Add":"\t\t\t$umap = $this.cookedMaps[$i];"},{"Add":"\t\t\tCopy-Item \"$($this.project.cookerOutputPath)\\$umap.upk\" -Destination $stagingCookedDir"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t# Copy over the SF packages"},{"Add":"\t\tfor ($i = 0; $i -lt $this.project.contentOptions.sfStandalone.Length; $i++)"},{"Add":"\t\t{"},{"Add":"\t\t\t$package = $this.project.contentOptions.sfStandalone[$i];"},{"Add":"\t\t\t$dest = [io.path]::Combine($stagingCookedDir, \"${package}.upk\");"},{"Add":""},{"Add":"\t\t\t# We need to remove the _SF suffix, otherwise the game won't find the package"},{"Add":"\t\t\tCopy-Item \"$($this.project.cookerOutputPath)\\${package}_SF.upk\" -Destination $dest"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[System.IO.FileInfo[]] _GetOurTfcFiles () {"},{"Add":"\t\treturn @(Get-ChildItem -Path $this.project.cookerOutputPath -Filter \"*$($this.actualTfcSuffix).tfc\")"},{"Add":"\t}"},{"Add":"}"},{"Add":""},{"Add":"class StdoutReceiver {"},{"Add":"\t[bool] $crashDetected = $false"},{"Add":"\t[string] $processDescr = \"\""},{"Add":""},{"Add":"\t[void]ParseLine([string] $outTxt) {"},{"Add":"\t\tif ($outTxt.Contains(\"Crash Detected\") -or $outTxt.Contains(\"(filename not found)\")) {"},{"Add":"\t\t\t$this.crashDetected = $true"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]Finish([int] $exitCode) {"},{"Add":"\t\tif ($this.crashDetected) {"},{"Add":"\t\t\tThrowFailure \"Crash detected while $($this.processDescr)\""},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\tif ($exitCode -ne 0) {"},{"Add":"\t\t\tThrowFailure \"Failed $($this.processDescr)\""},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":"}"},{"Add":""},{"Add":"class PassthroughReceiver : StdoutReceiver {"},{"Add":"\tPassthroughReceiver(){"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]ParseLine([string] $outTxt) {"},{"Add":"\t\t([StdoutReceiver]$this).ParseLine($outTxt)"},{"Add":"\t\tWrite-Host $outTxt"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]Finish([int] $exitCode) {"},{"Add":"\t\t([StdoutReceiver]$this).Finish($exitCode)"},{"Add":"\t}"},{"Add":"}"},{"Add":""},{"Add":"class BufferingReceiver : StdoutReceiver {"},{"Add":"\t[object] $logLines"},{"Add":"\tBufferingReceiver(){"},{"Add":"\t\t$this.logLines = New-Object System.Collections.Generic.List[System.Object]"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]ParseLine([string] $outTxt) {"},{"Add":"\t\t([StdoutReceiver]$this).ParseLine($outTxt)"},{"Add":"\t\t$this.logLines.Add($outTxt)"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]Finish([int] $exitCode) {"},{"Add":"\t\tif (($exitCode -ne 0) -or $this.crashDetected) {"},{"Add":"\t\t\tforeach ($line in $this.logLines) {"},{"Add":"\t\t\t\tWrite-Host $line"},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":"\t\t([StdoutReceiver]$this).Finish($exitCode)"},{"Add":"\t}"},{"Add":"}"},{"Add":""},{"Add":""},{"Add":"class MakeStdoutReceiver : StdoutReceiver {"},{"Add":"\t[BuildProject] $proj"},{"Add":"\t[string[]] $reversePaths"},{"Add":""},{"Add":"\tMakeStdoutReceiver("},{"Add":"\t\t[BuildProject]$proj"},{"Add":"\t){"},{"Add":"\t\t$this.proj = $proj"},{"Add":"\t\t# Since later paths overwrite earlier files, check paths in reverse order"},{"Add":"\t\t$this.reversePaths = @(\"$($this.proj.sdkPath)\\Development\\SrcOrig\") +"},{"Add":"\t\t\t$this.proj.include + @(\"$($this.proj.modSrcRoot)\\Src\")"},{"Add":"\t\t[array]::Reverse($this.reversePaths)"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]ParseLine([string] $outTxt) {"},{"Add":"\t\t([StdoutReceiver]$this).ParseLine($outTxt)"},{"Add":"\t\t$messagePattern = \"^(.*)\$([0-9]*)\$ : (.*)$\""},{"Add":"\t\tif (($outTxt -Match \"Error|Warning\") -And ($outTxt -Match $messagePattern)) {"},{"Add":"\t\t\t# extract original path from $matches automatic variable created by above -Match"},{"Add":"\t\t\t$origPath = $matches[1]"},{"Add":""},{"Add":"\t\t\t# create regex pattern specifically from the part we're interested in replacing"},{"Add":"\t\t\t$pattern = [regex]::Escape(\"$($this.proj.sdkPath)\\Development\\Src\")"},{"Add":""},{"Add":"\t\t\t$found = $false"},{"Add":"\t\t\tforeach ($checkPath in $this.reversePaths) {"},{"Add":"\t\t\t\t$testPath = $origPath -Replace $pattern,$checkPath"},{"Add":"\t\t\t\t# if the file exists, it's certainly the one that caused the error"},{"Add":"\t\t\t\tif (Test-Path $testPath) {"},{"Add":"\t\t\t\t\t# Normalize path to get rid of `..`s"},{"Add":"\t\t\t\t\t$testPath = [IO.Path]::GetFullPath($testPath)"},{"Add":"\t\t\t\t\t# this syntax works with both VS Code and ModBuddy"},{"Add":"\t\t\t\t\t$outTxt = $outTxt -Replace $messagePattern, ($testPath + '($2) : $3')"},{"Add":"\t\t\t\t\t$found = $true"},{"Add":"\t\t\t\t\tbreak"},{"Add":"\t\t\t\t}"},{"Add":"\t\t\t}"},{"Add":"\t\t\tif (-not $found) {"},{"Add":"\t\t\t\t$outTxt = $outTxt -Replace $messagePattern, ($origPath + '($2) : $3')"},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t$summPattern = \"^(Success|Failure) - ([0-9]+) error\$s\$, ([0-9]+) warning\$s\$ \$([0-9]+) Unique Errors, ([0-9]+) Unique Warnings\$\""},{"Add":"\t\tif (-Not ($outTxt -Match \"Warning/Error Summary\") -And $outTxt -Match \"Warning|Error\") {"},{"Add":"\t\t\tif ($outTxt -Match $summPattern) {"},{"Add":"\t\t\t\t$numErr = $outTxt -Replace $summPattern, '$2'"},{"Add":"\t\t\t\t$numWarn = $outTxt -Replace $summPattern, '$3'"},{"Add":"\t\t\t\tif (([int]$numErr) -gt 0) {"},{"Add":"\t\t\t\t\t$clr = \"Red\""},{"Add":"\t\t\t\t} elseif (([int]$numWarn) -gt 0) {"},{"Add":"\t\t\t\t\t$clr = \"Yellow\""},{"Add":"\t\t\t\t} else {"},{"Add":"\t\t\t\t\t$clr = \"Green\""},{"Add":"\t\t\t\t}"},{"Add":"\t\t\t} else {"},{"Add":"\t\t\t\tif ($outTxt -Match \"Error\") {"},{"Add":"\t\t\t\t\t$clr = \"Red\""},{"Add":"\t\t\t\t} else {"},{"Add":"\t\t\t\t\t$clr = \"Yellow\""},{"Add":"\t\t\t\t}"},{"Add":"\t\t\t}"},{"Add":"\t\t\tWrite-Host $outTxt -ForegroundColor $clr"},{"Add":"\t\t} else {"},{"Add":"\t\t\tWrite-Host $outTxt"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]Finish([int] $exitCode) {"},{"Add":"\t\t([StdoutReceiver]$this).Finish($exitCode)"},{"Add":"\t}"},{"Add":"}"},{"Add":""},{"Add":"class ModcookReceiver : StdoutReceiver {"},{"Add":"\t[bool] $lastLineWasAdding = $false"},{"Add":""},{"Add":"\tModcookReceiver(){"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]ParseLine([string] $outTxt) {"},{"Add":"\t\t([StdoutReceiver]$this).ParseLine($outTxt)"},{"Add":"\t\t$permitLine = $true # Default to true in case there is something we don't handle"},{"Add":""},{"Add":"\t\tif ($outTxt.StartsWith(\"GFx movie package\")) {"},{"Add":"\t\t\t\t$permitLine = $false"},{"Add":""},{"Add":"\t\t\t\tif (!$this.lastLineWasAdding) {"},{"Add":"\t\t\t\tWrite-Host \"[GFx movie packages ...]\""},{"Add":"\t\t\t}"},{"Add":""},{"Add":"\t\t\t$this.lastLineWasAdding = $true"},{"Add":"\t\t} else {"},{"Add":"\t\t\t$this.lastLineWasAdding = $false"},{"Add":"\t\t\t$permitLine = $true"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\tif ($permitLine) {"},{"Add":"\t\t\tWrite-Host $outTxt"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t[void]Finish([int] $exitCode) {"},{"Add":"\t\t([StdoutReceiver]$this).Finish($exitCode)"},{"Add":"\t}"},{"Add":"}"},{"Add":""},{"Add":"function FailureMessage($message)"},{"Add":"{"},{"Add":"\t[System.Media.SystemSounds]::Hand.Play()"},{"Add":"\tWrite-Host $message -ForegroundColor \"Red\""},{"Add":"}"},{"Add":""},{"Add":"function ThrowFailure($message)"},{"Add":"{"},{"Add":"\tthrow $message"},{"Add":"}"},{"Add":""},{"Add":"function SuccessMessage($message, $modNameCanonical)"},{"Add":"{"},{"Add":"\t[System.Media.SystemSounds]::Asterisk.Play()"},{"Add":"\tWrite-Host $message -ForegroundColor \"Green\""},{"Add":"\tWrite-Host \"$modNameCanonical ready to run.\" -ForegroundColor \"Green\""},{"Add":"}"},{"Add":""},{"Add":"function FormatElapsed($elapsed) {"},{"Add":"\treturn $elapsed.TotalSeconds.ToString(\"0.00s\", $global:invarCulture)"},{"Add":"}"},{"Add":""},{"Add":"# https://stackoverflow.com/a/55942155/2588539"},{"Add":"# $process.Kill() works but we really need to kill the child as well, since it's the one which is actually doing work"},{"Add":"# Unfotunately, $process.Kill($true) does nothing"},{"Add":"function KillProcessTree ([int] $ppid) {"},{"Add":"\tGet-CimInstance Win32_Process | Where-Object { $_.ParentProcessId -eq $ppid } | ForEach-Object { KillProcessTree $_.ProcessId }"},{"Add":"\tStop-Process -Id $ppid"},{"Add":"}"},{"Add":""},{"Add":"# https://superuser.com/a/468795/673577"},{"Add":"Function FormatFileSize () {"},{"Add":" Param ([int64]$size)"},{"Add":" If ($size -gt 1TB) {[string]::Format(\"{0:0.00} TB\", $size / 1TB)}"},{"Add":" ElseIf ($size -gt 1GB) {[string]::Format(\"{0:0.00} GB\", $size / 1GB)}"},{"Add":" ElseIf ($size -gt 1MB) {[string]::Format(\"{0:0.00} MB\", $size / 1MB)}"},{"Add":" ElseIf ($size -gt 1KB) {[string]::Format(\"{0:0.00} kB\", $size / 1KB)}"},{"Add":" ElseIf ($size -gt 0) {[string]::Format(\"{0:0.00} B\", $size)}"},{"Add":" Else {\"\"}"},{"Add":"}"}]}},{"FileAdd":{"meta":{"basename":"XCOM2.targets","metadata":0},"context":[{"change":0,"pos":1366}],"contents":[{"Add":""},{"Add":" "},{"Add":""},{"Add":" "},{"Add":" Program"},{"Add":" $(XCOM2_GamePath)\\..\\Binaries\\Win64\\Launcher\\StartDebugging.bat"},{"Add":" "},{"Add":" "},{"Add":" ."},{"Add":" "},{"Add":" "},{"Add":" ."},{"Add":" "},{"Add":" "},{"Add":" ."},{"Add":" "},{"Add":" "},{"Add":" $(MSBuildProjectDirectory)"},{"Add":" $(XCOM2_UserPath)\\Mods\\"},{"Add":" $(ModsDir)$(SafeName)\\"},{"Add":" "},{"Add":""},{"Add":" "},{"Add":" "},{"Add":""},{"Add":" "},{"Add":""},{"Add":" "},{"Add":" "},{"Add":" build.ps1"},{"Add":" $(ScriptsDir)$(BuildEntryFileName)"},{"Add":" "},{"Add":""},{"Add":" "},{"Add":" "},{"Add":" default"},{"Add":" debug"},{"Add":" "},{"Add":""},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" $(SafeName)"},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":""},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" $(BuildEntryConfig)"},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":""},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":" "},{"Add":"

"}]}},{"FileAdd":{"meta":{"basename":"README.md","metadata":0},"context":[{"change":0,"pos":1366}],"contents":[{"Add":"# X2ModBuildCommon"},{"Add":"An improved XCOM 2 mod build system. The following (in no praticular order) are its features/improvements over the default one:"},{"Add":""},{"Add":"* Path rewriting for script errors/warnings so that they no longer point to the temporary copies of files in SDK/Developement/Src"},{"Add":"* Automated including of compile-time dependencies (including CHL) so that you no longer need to pollute your SrcOrig with them"},{"Add":"* Caching of `ModShaderCache` and invoking the shader precompiler only when the mod content files have changed"},{"Add":"* Proper cancelling of the build mid-way (instead of waiting until it completes)"},{"Add":"* Configurable mod workshop ID"},{"Add":"* Automated including of SDK's content packages (for those which are missing in the cooked game) so that you don't need to store them in your project"},{"Add":"* Full HL building: final release compiling and cooking of native script packages"},{"Add":"* Scriptable hooks in the build process"},{"Add":"* Conversion of localization file(s) encoding (UTF8 in the project for correct git merging and UTF16 for correct game loading)"},{"Add":"* Mod asset cooking (experimental)"},{"Add":"* Correct removal of files from the steamapps/XCOM2/WOTC/XComGame/Mods (built mod) when they are deleted from the project"},{"Add":"* Mod-defined global macros (without explicit `include`s and without messing with your `SrcOrig`)"},{"Add":"* Most features are configurable!"},{"Add":""},{"Add":"# Getting started"},{"Add":"Foreword: the build system was designed to be flexible in how you want to set it up. This section describes"},{"Add":"the most common/basic setup that should work for 95% of mods out there. If you want to customize it, read the next section"},{"Add":""},{"Add":"## Getting the files"},{"Add":"First, create a `.scripts` folder in the root of your mod project (next to the `.XCOM_sln` file) - from now on referred"},{"Add":"to as `[modRoot]`. The next step depends on whether you are using git or not. Git is preferable but the build system"},{"Add":"will work just fine without it."},{"Add":""},{"Add":"### Your mod uses git"},{"Add":"Open a command line prompt (cmd or powershell, does not matter) in the `[modRoot]`. Ensure that"},{"Add":"your working tree is clean and run the following command:"},{"Add":""},{"Add":"```"},{"Add":"git subtree add --prefix .scripts/X2ModBuildCommon https://github.com/X2CommunityCore/X2ModBuildCommon v1.2.1 --squash"},{"Add":"```"},{"Add":""},{"Add":"### Your mod does not use git"},{"Add":"Download the source code of this repository from the latest release on the [Releases page](https://github.com/X2CommunityCore/X2ModBuildCommon/releases/latest)."},{"Add":"Unzip it and place so that `build_common.ps1` resides at `[modRoot]\\.scripts\\X2ModBuildCommon\\build_common.ps1`."},{"Add":""},{"Add":"## Ignoring the `BuildCache`"},{"Add":"The build system will create a `[modRoot]\\BuildCache` folder which is used for various file-based operations (such"},{"Add":"as recompiling the `ModShaderCache` only when mod's content has changed). This folder is fully managed by the build"},{"Add":"system and normally you should never open it. It is also safe to delete at any time (e.g. if you want to"},{"Add":"force a full rebuild)."},{"Add":""},{"Add":"As such, this folder is not meant to be shared with other developers working on the project or stored in"},{"Add":"backups/previous versions (e.g. when using a VCS) - this can lead to incorrect behaviour."},{"Add":""},{"Add":"If you are using git, you should add it (`BuildCache/`) to your `.gitignore`"},{"Add":""},{"Add":"## Setting up the build entrypoint"},{"Add":"Create `[modRoot]\\.scripts\\build.ps1` with the following content:"},{"Add":""},{"Add":"```ps1"},{"Add":"Param("},{"Add":"    [string] $srcDirectory, # the path that contains your mod's .XCOM_sln"},{"Add":"    [string] $sdkPath, # the path to your SDK installation ending in \"XCOM 2 War of the Chosen SDK\""},{"Add":"    [string] $gamePath, # the path to your XCOM 2 installation ending in \"XCOM2-WaroftheChosen\""},{"Add":"    [string] $config # build configuration"},{"Add":")"},{"Add":""},{"Add":"$ScriptDirectory = Split-Path $MyInvocation.MyCommand.Path"},{"Add":"$common = Join-Path -Path $ScriptDirectory \"X2ModBuildCommon\\build_common.ps1\""},{"Add":"Write-Host \"Sourcing $common\""},{"Add":". ($common)"},{"Add":""},{"Add":"$builder = [BuildProject]::new(\"YourProjectName\", $srcDirectory, $sdkPath, $gamePath)"},{"Add":""},{"Add":"switch ($config)"},{"Add":"{"},{"Add":"    \"debug\" {"},{"Add":"        $builder.EnableDebug()"},{"Add":"    }"},{"Add":"    \"default\" {"},{"Add":"        # Nothing special"},{"Add":"    }"},{"Add":"    \"\" { ThrowFailure \"Missing build configuration\" }"},{"Add":"    default { ThrowFailure \"Unknown build configuration $config\" }"},{"Add":"}"},{"Add":""},{"Add":"$builder.InvokeBuild()"},{"Add":"```"},{"Add":""},{"Add":"Replace `YourProjectName` with the mod project name (e.g. the name of your `.XCOM_sln` file without the extension)."},{"Add":""},{"Add":"If you're transitioning an existing mod to X2ModBuildCommon, this advice might come too late, but we recommend that"},{"Add":"the project name contain only ASCII alphabetic characters, numbers and underscores (matching the regular expression `^[A-Za-z][A-Za-z0-9_]*$`)."},{"Add":"The ModBuddy project generator lets you create projects with a large variety of characters that will break the ModBuddy"},{"Add":"build already (like brackets and dashes), but spaces and semicolons are allowed and work fine with the Firaxis ModBuddy plugin."},{"Add":"`X2ModBuildCommon` will do its best to support project names with spaces, but it's historically been a common source of bugs"},{"Add":"and you may run into fewer of them if you keep your mod name simple."},{"Add":""},{"Add":"## IDE integration"},{"Add":"At this point your mod is actually ready for building but invoking the powershell script with all the arguments each time manually"},{"Add":"is not convinient. Instead, we would like it to be invoked automatically when we press the build button in our IDE"},{"Add":""},{"Add":"### ModBuddy"},{"Add":"Close Modbuddy (or at least the solution) if you have it open. Open your `.x2proj` (in something like notepad++) and find the follwing line:"},{"Add":""},{"Add":"```xml"},{"Add":""},{"Add":"```"},{"Add":""},{"Add":"Replace it with following:"},{"Add":""},{"Add":"```xml"},{"Add":"  "},{"Add":"    $(MSBuildProjectDirectory)\\..\\"},{"Add":"    $(SolutionRoot).scripts\\"},{"Add":"    $(ScriptsDir)X2ModBuildCommon\\"},{"Add":"  "},{"Add":"  "},{"Add":"```"},{"Add":""},{"Add":"Note that the build tool does not care about most of the `.x2proj` file and will"},{"Add":"copy and compile files not referenced by the project file without issuing warnings."},{"Add":"Consider using a tool like [Xymanek/X2ProjectGenerator](https://github.com/Xymanek/X2ProjectGenerator)"},{"Add":"to automatically ensure the file list in ModBuddy accurately lists the files part of the project."},{"Add":""},{"Add":""},{"Add":"### VSCode"},{"Add":""},{"Add":"> FIXME(#1): Rename variables to remove HL references?"},{"Add":""},{"Add":"First, you need to tell Visual Studio code where to find the game and SDK (similar to the first-time ModBuddy setup)."},{"Add":"To do that, open the \"Settings (JSON)\" file by using the \"Ctrl+Shift+P\" shortcut and running \"Preferences: Open Settings (JSON)\""},{"Add":"or by clicking \"File->Preferences->Settings\" and clicking the \"Open Settings (JSON)\" button on the tab bar. Add the following"},{"Add":"two entries, adjusting paths as necessary."},{"Add":""},{"Add":"```json"},{"Add":"    \"xcom.highlander.sdkroot\": \"d:\\\\Steam\\\\SteamApps\\\\common\\\\XCOM 2 War of the Chosen SDK\","},{"Add":"    \"xcom.highlander.gameroot\": \"d:\\\\Steam\\\\SteamApps\\\\common\\\\XCOM 2\\\\XCom2-WarOfTheChosen\""},{"Add":"```"},{"Add":""},{"Add":"VS Code may tell you that the configuration settings are unknown. This is acceptable and can be ignored."},{"Add":""},{"Add":"Next up, you have to tell VS code about your build tasks. Create a folder `.vscode` next to the `.scripts` folder,"},{"Add":"and within it create a `tasks.json` file with the following content (replacing `MY_MOD_NAME` with the mod project"},{"Add":"name in the \"Clean\" task):"},{"Add":""},{"Add":"```json"},{"Add":"{"},{"Add":"    \"version\": \"2.0.0\","},{"Add":"    \"tasks\": ["},{"Add":"        {"},{"Add":"            \"label\": \"Build\","},{"Add":"            \"type\": \"shell\","},{"Add":"            \"command\": \"powershell.exe –NonInteractive –ExecutionPolicy Unrestricted -file '${workspaceRoot}\\\\.scripts\\\\build.ps1' -srcDirectory '${workspaceRoot}' -sdkPath '${config:xcom.highlander.sdkroot}' -gamePath '${config:xcom.highlander.gameroot}' -config 'default'\","},{"Add":"            \"group\": \"build\","},{"Add":"            \"problemMatcher\": []"},{"Add":"        },"},{"Add":"        {"},{"Add":"            \"label\": \"Build debug\","},{"Add":"            \"type\": \"shell\","},{"Add":"            \"command\": \"powershell.exe –NonInteractive –ExecutionPolicy Unrestricted -file '${workspaceRoot}\\\\.scripts\\\\build.ps1' -srcDirectory '${workspaceRoot}' -sdkPath '${config:xcom.highlander.sdkroot}' -gamePath '${config:xcom.highlander.gameroot}' -config 'debug'\","},{"Add":"            \"group\": \"build\","},{"Add":"            \"problemMatcher\": []"},{"Add":"        },"},{"Add":"        {"},{"Add":"            \"label\": \"Clean\","},{"Add":"            \"type\": \"shell\","},{"Add":"            \"command\": \"powershell.exe –NonInteractive –ExecutionPolicy Unrestricted -file '${workspaceRoot}\\\\.scripts\\\\clean.ps1' -modName 'MY_MOD_NAME' -srcDirectory '${workspaceRoot}' -sdkPath '${config:xcom.highlander.sdkroot}' -gamePath '${config:xcom.highlander.gameroot}'\","},{"Add":"            \"group\": \"build\","},{"Add":"            \"problemMatcher\": []"},{"Add":"        },"},{"Add":"        {"},{"Add":"            \"label\": \"Full rebuild\","},{"Add":"            \"dependsOrder\": \"sequence\","},{"Add":"            \"dependsOn\": [\"Clean\", \"Build\"]"},{"Add":"        }"},{"Add":"    ]"},{"Add":"}"},{"Add":"```"},{"Add":""},{"Add":"Note that the `-config 'debug'` or `-config 'default'` build configurations correspond to"},{"Add":"the build configurations in the `build.ps1` entry point created earlier. You can easily add"},{"Add":"existing build tasks with custom configurations by modifying `build.ps1` and configuring the"},{"Add":"`$builder` (see just below!)"},{"Add":""},{"Add":"> FIXME(microsoft/vscode#24865): Add problem matchers when they can be shared between tasks."},{"Add":""},{"Add":"## Ready!"},{"Add":"You can now successfully build your mod from your IDE using X2ModBuildCommon. Keep reading on to find about what you can configure."},{"Add":""},{"Add":"## Updating"},{"Add":"The build system is desinged to be version-pinned against your mod - you can continue using the old version as long as it suits your needs, even if a new one is released. If you would like to get the new features/improvements/bugfixes of the new version, the update procedure is simple."},{"Add":""},{"Add":"If you don't use git, simply download the new version and overwrite the old files inside the `X2ModBuildCommon` folder."},{"Add":""},{"Add":"If you use git, run the same command as before, replacing `add` with `pull`:"},{"Add":""},{"Add":"```"},{"Add":"git subtree pull --prefix .scripts/X2ModBuildCommon https://github.com/X2CommunityCore/X2ModBuildCommon v1.2.1 --squash"},{"Add":"```"},{"Add":""},{"Add":"# Configuration options"},{"Add":""},{"Add":"All the following examples are modifications that could be made to your `build.ps1`."},{"Add":""},{"Add":"## ThrowFailure"},{"Add":""},{"Add":"> FIXME: `ThrowFailure` vs `FailureMessage`?"},{"Add":""},{"Add":"Throw a failure. Example usage:"},{"Add":""},{"Add":"```ps1"},{"Add":"switch ($config) {"},{"Add":"  # ..."},{"Add":"  \"\" { ThrowFailure \"Missing build configuration\" }"},{"Add":"}"},{"Add":"```"},{"Add":""},{"Add":"## SetWorkshopID"},{"Add":""},{"Add":"Override the workshop ID from the x2proj file. Example usage:"},{"Add":""},{"Add":"```ps1"},{"Add":"# make sure beta builds are never uploaded to the stable workshop page"},{"Add":"if ($config -eq \"stable\") {"},{"Add":"  $builder.SetWorkshopID(1234567890)"},{"Add":"}"},{"Add":"else {"},{"Add":"  $builder.SetWorkshopID(6789012345)"},{"Add":"}"},{"Add":"```"},{"Add":""},{"Add":"## EnableFinalRelease"},{"Add":""},{"Add":"Pass the `-final_release` flag to the compiler for base-game script packages and the Highlander cooker."},{"Add":"Can only be used for Highlander-style mods that modify native packages. Example usage:"},{"Add":""},{"Add":"```ps1"},{"Add":"switch ($config) {"},{"Add":"  # ..."},{"Add":"  \"final_release\" {"},{"Add":"    $builder.EnableFinalRelease()"},{"Add":"  }"},{"Add":"  \"stable\" {"},{"Add":"    $builder.EnableFinalRelease()"},{"Add":"  }"},{"Add":"}"},{"Add":"```"},{"Add":""},{"Add":"## EnableDebug"},{"Add":""},{"Add":"Pass the `-debug` flag to all script compiler invocations. Incompatible with `EnableFinalRelease`, and will skip"},{"Add":"Highlander cooking process (accordingly you have to use `-noseekfreeloading` when launching the game). Example usage:"},{"Add":""},{"Add":"```ps1"},{"Add":"switch ($config) {"},{"Add":"  # ..."},{"Add":"  \"debug\" {"},{"Add":"    $builder.EnableDebug()"},{"Add":"  }"},{"Add":"}"},{"Add":"```"},{"Add":""},{"Add":"## AddPreMakeHook"},{"Add":""},{"Add":"Add a callback to be executed after all script sources have been added to `Src` but before the compiler is run."},{"Add":"Example usage:"},{"Add":""},{"Add":"```ps1"},{"Add":"# Checks if a certain automatically generated file actually compiles, but only with the \"compiletest\" configuration"},{"Add":"if ($compiletest) {"},{"Add":"    $builder.AddPreMakeHook({"},{"Add":"        Write-Host \"Including CHL_Event_Compiletest\""},{"Add":"        # n.b. this copies from the `target` directory where it is generated into, see tasks.json"},{"Add":"        Copy-Item \"..\\target\\CHL_Event_Compiletest.uc\" \"$sdkPath\\Development\\Src\\X2WOTCCommunityHighlander\\Classes\\\" -Force -WarningAction SilentlyContinue"},{"Add":"    })"},{"Add":"}"},{"Add":"```"},{"Add":""},{"Add":"The Highlander also uses it to embed the current git commit hash in some source files."},{"Add":""},{"Add":"## IncludeSrc"},{"Add":""},{"Add":"Add dependencies' source files to `Src`. This removes the step where mods whose sources you want to have available"},{"Add":"have to be copied to `SrcOrig`. Example usage (from Covert Infiltration):"},{"Add":""},{"Add":"```"},{"Add":"$builder.IncludeSrc(\"$srcDirectory\\X2WOTCCommunityHighlander\\X2WOTCCommunityHighlander\\Src\")"},{"Add":"$builder.IncludeSrc(\"$srcDirectory\\X2WOTCCommunityHighlander\\Components\\DLC2CommunityHighlander\\DLC2CommunityHighlander\\Src\")"},{"Add":"$builder.IncludeSrc(\"$srcDirectory\\SquadSelectAnyTime\\SquadSelectAtAnyTime\\Src\")"},{"Add":"```"},{"Add":""},{"Add":"## AddToClean"},{"Add":""},{"Add":"Deletes certain built mods from `SDK/XComGame/Mods`. Usually necessary for dependencies since their script compiler configuration"},{"Add":"files can cause the script compiler to choke. Covert Infiltration does this:"},{"Add":""},{"Add":"```ps1"},{"Add":"$builder.AddToClean(\"SquadSelectAtAnyTime\")"},{"Add":"```"},{"Add":""},{"Add":"## Content options"},{"Add":""},{"Add":"You can provide a \"content options\" file that will determine some additional content-related steps. This file should be checked"},{"Add":"in to your VSC (e.g. tracked by git) and must reside next to your `.x2proj` (note that the file will not be included in the"},{"Add":"final built mod). If using Modbuddy, you can add the file to the project for easier editing."},{"Add":""},{"Add":"Assuming the file is named `ContentOptions.json`:"},{"Add":""},{"Add":"```ps1"},{"Add":"$builder.SetContentOptionsJsonFilename(\"ContentOptions.json\")"},{"Add":"```"},{"Add":""},{"Add":"Four options are available: `missingUncooked`, `sfStandalone`, `sfMaps`, `sfCollectionMaps`. Omitting an option (or the file entirely)"},{"Add":"is treated the same as setting it to an empty array"},{"Add":""},{"Add":"### Including missing uncooked"},{"Add":""},{"Add":"In case your mod depends on some assets that were not shipped in a seek free package, you can automatically include it with your mod."},{"Add":"Example from Covert Infiltration:"},{"Add":""},{"Add":"```json"},{"Add":"{"},{"Add":"    \"missingUncooked\": ["},{"Add":"        \"CIN_TroopTransport.upk\","},{"Add":"        \"PCP_Archetypes_XPACK.upk\""},{"Add":"    ]"},{"Add":"}"},{"Add":"```"},{"Add":""},{"Add":"**IMPORTANT**: you need to be on the `full_content` branch of the SDK for this to work."},{"Add":""},{"Add":"### Asset cooking"},{"Add":""},{"Add":"The rest of the options are for the mod assets cooking. Because it is such a complex process, the package and map configuration is"},{"Add":"described in a separate file. See [Asset Cooking](https://github.com/X2CommunityCore/X2ModBuildCommon/wiki/Asset-cooking) for details."},{"Add":""},{"Add":"# Additional features"},{"Add":""},{"Add":"## extra_globals"},{"Add":""},{"Add":"This isn't a configuration option, but mods can create an `extra_globals.uci` file in the"},{"Add":"`Src` folder to have the build tool append its contents to `Globals.uci`. This allows mods"},{"Add":"to use custom macros."},{"Add":""},{"Add":"Moreover, the `extra_globals.uci` files of any dependencies added via `IncludeSrc` will be merged into `Globals.uci` too. This allows dependency mods to safely use custom macros"},{"Add":"without causing compilation problems for dependent mods."},{"Add":""},{"Add":"## Localization Encoding"},{"Add":""},{"Add":"Any files in the `Localization` folder will have its encoding rewritten from UTF-8 to UTF-16. This allows tracking"},{"Add":"localization files in the git-compatible UTF-8 text encoding even though the game only supports ASCII and UTF-16."},{"Add":""},{"Add":"# ModBuddy project customization"},{"Add":""},{"Add":"You can customize your `.x2proj` using the following properties:"},{"Add":""},{"Add":"Property | Default value | Notes"},{"Add":"-------- | ------------- | -----"},{"Add":"`SolutionRoot` | None (**required**) | The path to folder which houses your `.XCOM_sln` file"},{"Add":"`ScriptsDir` | None | Required if you don't set `BuildEntryPs1`. Ignored otherwise"},{"Add":"`BuildCommonRoot` | None (**required**) | The path to folder which houses the `InvokePowershellBuild.cs` file"},{"Add":"`BuildEntryFileName` | `build.ps1` | Required if you don't set `BuildEntryPs1`. Ignored otherwise"},{"Add":"`BuildEntryPs1` | `$(ScriptsDir)$(BuildEntryFileName)` |"},{"Add":"`BuildEntryConfig` | `default` or `debug` | Will be passed to your build entrypoint. Default is derived from `$(Configuration)` (build configuration dropdown)"},{"Add":""},{"Add":"Hint: if you want to add other build configurations, you can let the `default` and `debug` ones be handeled"},{"Add":"by the provided `XCOM2.targets`. Example from CHL:"},{"Add":""},{"Add":"```xml"},{"Add":"  "},{"Add":"    $(MSBuildProjectDirectory)\\..\\"},{"Add":"    $(SolutionRoot).scripts\\"},{"Add":"    $(ScriptsDir)X2ModBuildCommon\\"},{"Add":""},{"Add":"    "},{"Add":"    final_release"},{"Add":"    compiletest"},{"Add":"    stable"},{"Add":"  "},{"Add":"```"},{"Add":""},{"Add":"# Things to watch out for"},{"Add":""},{"Add":"Note that you can always check the issue tracker: https://github.com/X2CommunityCore/X2ModBuildCommon/issues?q=is%3Aissue+is%3Aopen+label%3Abug"},{"Add":""},{"Add":"## Deleting content files"},{"Add":""},{"Add":"If you **delete** content files (e.g. moved to a different mod or just completely removed) the current caching logic (e.g. for the"},{"Add":"shader cache) might not recognize it. As such, it's recommended that you simply delete the `BuildCache` folder in such cases."}]}},{"FileAdd":{"meta":{"basename":"LICENSE","metadata":0},"context":[{"change":0,"pos":1366}],"contents":[{"Add":"MIT License"},{"Add":""},{"Add":"Copyright (c) 2021 X2CommunityCore"},{"Add":""},{"Add":"Permission is hereby granted, free of charge, to any person obtaining a copy"},{"Add":"of this software and associated documentation files (the \"Software\"), to deal"},{"Add":"in the Software without restriction, including without limitation the rights"},{"Add":"to use, copy, modify, merge, publish, distribute, sublicense, and/or sell"},{"Add":"copies of the Software, and to permit persons to whom the Software is"},{"Add":"furnished to do so, subject to the following conditions:"},{"Add":""},{"Add":"The above copyright notice and this permission notice shall be included in all"},{"Add":"copies or substantial portions of the Software."},{"Add":""},{"Add":"THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR"},{"Add":"IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,"},{"Add":"FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE"},{"Add":"AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER"},{"Add":"LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,"},{"Add":"OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE"},{"Add":"SOFTWARE."}]}},{"FileAdd":{"meta":{"basename":"InvokePowershellTask.cs","metadata":0},"context":[{"change":0,"pos":1366}],"contents":[{"Add":"using System;"},{"Add":"using System.IO;"},{"Add":"using System.Threading;"},{"Add":"using System.Management.Automation;"},{"Add":""},{"Add":"using Microsoft.Build.Framework;"},{"Add":"using Microsoft.Build.Utilities;"},{"Add":""},{"Add":"public class InvokePowershellTask : Task, ICancelableTask"},{"Add":"{"},{"Add":"    [Required] public string EntryPs1 { get; set; }"},{"Add":"    [Required] public string SolutionRoot { get; set; }"},{"Add":"    [Required] public string SdkInstallPath { get; set; }"},{"Add":"    [Required] public string GameInstallPath { get; set; }"},{"Add":"    [Required] public ITaskItem[] AdditionalArgs { get; set; }"},{"Add":""},{"Add":"    private PowerShell _ps;"},{"Add":""},{"Add":"    private ManualResetEventSlim _startingMre = new ManualResetEventSlim(false);"},{"Add":""},{"Add":"    public override bool Execute()"},{"Add":"    {"},{"Add":"        bool isSuccess = false;"},{"Add":""},{"Add":"        try"},{"Add":"        {"},{"Add":"            _ps = PowerShell.Create();"},{"Add":""},{"Add":"            _ps"},{"Add":"                .AddCommand(\"Set-ExecutionPolicy\")"},{"Add":"                .AddArgument(\"Unrestricted\")"},{"Add":"                .AddParameter(\"Scope\",\"CurrentUser\");"},{"Add":""},{"Add":"            _ps"},{"Add":"                .AddStatement()"},{"Add":"                .AddCommand(EntryPs1)"},{"Add":"                .AddParameter(\"srcDirectory\", TrimEndingDirectorySeparator(SolutionRoot))"},{"Add":"                .AddParameter(\"sdkPath\", TrimEndingDirectorySeparator(SdkInstallPath))"},{"Add":"                .AddParameter(\"gamePath\", TrimEndingDirectorySeparator(GameInstallPath));"},{"Add":""},{"Add":"            foreach (ITaskItem Arg in AdditionalArgs)"},{"Add":"            {"},{"Add":"                string Val = Arg.GetMetadata(\"Value\");"},{"Add":"                if (string.IsNullOrEmpty(Val))"},{"Add":"                {"},{"Add":"                    _ps.AddParameter(Arg.ItemSpec);"},{"Add":"                }"},{"Add":"                else"},{"Add":"                {"},{"Add":"                    _ps.AddParameter(Arg.ItemSpec, Val);"},{"Add":"                }"},{"Add":"            }"},{"Add":""},{"Add":"            BindStreamEntryCallback(_ps.Streams.Debug, record => LogOutput(record.ToString()));"},{"Add":"            BindStreamEntryCallback(_ps.Streams.Information, record => LogOutput(record.ToString()));"},{"Add":"            BindStreamEntryCallback(_ps.Streams.Verbose, record => LogOutput(record.ToString()));"},{"Add":"            BindStreamEntryCallback(_ps.Streams.Warning, record => LogOutput(record.ToString())); // TODO: More flashy output?"},{"Add":""},{"Add":"            BindStreamEntryCallback(_ps.Streams.Error, record =>"},{"Add":"            {"},{"Add":"                // TODO: Less info than when from console"},{"Add":"                // TODO: More flashy output?"},{"Add":"                LogOutput(record.ToString());"},{"Add":"                Log.LogError(record.ToString());"},{"Add":"                isSuccess = false;"},{"Add":"            });"},{"Add":""},{"Add":"            _ps.InvocationStateChanged += (sender, args) =>"},{"Add":"            {"},{"Add":"                if (args.InvocationStateInfo.State == PSInvocationState.Running)"},{"Add":"                {"},{"Add":"                    _startingMre.Set();"},{"Add":"                }"},{"Add":"            };"},{"Add":""},{"Add":"            isSuccess = true;"},{"Add":"            _ps.Invoke();"},{"Add":"        }"},{"Add":"        catch (System.Exception e)"},{"Add":"        {"},{"Add":"            Log.LogError(e.Message);"},{"Add":"            isSuccess = false;"},{"Add":"        }"},{"Add":""},{"Add":"        return isSuccess;"},{"Add":"    }"},{"Add":""},{"Add":"    public void Cancel()"},{"Add":"    {"},{"Add":"        // Log.LogMessage(MessageImportance.High, \"Got cancel\");"},{"Add":""},{"Add":"        // Do not call Stop() until we know that we've actually started"},{"Add":"        // This could be more elaborate, but the time interval between Execute() and Invoke() being called is extremely small"},{"Add":""},{"Add":"        _startingMre.Wait();"},{"Add":"        _ps.Stop();"},{"Add":"    }"},{"Add":""},{"Add":"    private void LogOutput (string output)"},{"Add":"    {"},{"Add":"        // This is required to keep the empty lines in the output"},{"Add":"        if (string.IsNullOrEmpty(output)) output = \" \";"},{"Add":""},{"Add":"        Log.LogMessage(MessageImportance.High, output);"},{"Add":"    }"},{"Add":""},{"Add":"    private static readonly char[] DirectorySeparatorsForTrimming = new char[]"},{"Add":"    {"},{"Add":"        Path.DirectorySeparatorChar,"},{"Add":"        Path.AltDirectorySeparatorChar"},{"Add":"    };"},{"Add":""},{"Add":"    private static string TrimEndingDirectorySeparator(string path)"},{"Add":"    {"},{"Add":"        return path.TrimEnd(DirectorySeparatorsForTrimming);"},{"Add":"    }"},{"Add":""},{"Add":"    private static void BindStreamEntryCallback(PSDataCollection stream, Action handler)"},{"Add":"    {"},{"Add":"        stream.DataAdded += (object sender, DataAddedEventArgs e) => handler(stream[e.Index]);"},{"Add":"    }"},{"Add":"}"}]}},{"FileAdd":{"meta":{"basename":"EmptyUMap","metadata":0},"context":[{"change":0,"pos":1366}],"contents":[]}},{"FileAdd":{"meta":{"basename":"CHANGELOG.md","metadata":0},"context":[{"change":0,"pos":1366}],"contents":[{"Add":"## Next"},{"Add":""},{"Add":"## 1.2.1 (2021-12-22)"},{"Add":""},{"Add":"* Support mods without script packages"},{"Add":""},{"Add":"## 1.2.0 (2021-12-19)"},{"Add":""},{"Add":"* Significant improvements/rework of the asset cooking step (#70)"},{"Add":""},{"Add":"## 1.1.2 (2021-11-30)"},{"Add":""},{"Add":"* Shader precompile step is no longer triggered by maps"},{"Add":"* Asset cooking step no longer overwrites `DefaultEngine.ini` in the SDK"},{"Add":""},{"Add":"## 1.1.1 (2021-08-11)"},{"Add":""},{"Add":"* Support Rebuild ModBuddy target"},{"Add":"* Internal improvements and fixes to asset cooking functionality"},{"Add":"* Support projects with spaces in path (#55)"},{"Add":"* Fix cryptic error about `SteamPublishID` for some projects (#56)"},{"Add":"* Fail the build in case cooking cleanup fails, preventing silent SDK corruption (#54)"},{"Add":"* Properly rewrite error messages originating from `IncludeSrc`-ed files (#45)"},{"Add":""},{"Add":""},{"Add":"## 1.1.0 (2021-06-15)"},{"Add":""},{"Add":"* Remove compiled script packages when switching between debug and release mode to prevent compiler error (#16)"},{"Add":"* Remove compiled script packages when modifying macros (#20)"},{"Add":"* Overridden Steam UGC IDs can now be `long` (`int64`) (#22)"},{"Add":"* Use error syntax `file(line)` for compiler errors to be compatible with both ModBuddy and VS Code (#26)"},{"Add":"* Add a `clean.ps1` script, ModBuddy configuration and VS Code example task to remove all cached build artifacts (#24)"},{"Add":"* Remove project file verification. Consider using [Xymanek/X2ProjectGenerator](https://github.com/Xymanek/X2ProjectGenerator) instead (#28)"},{"Add":"* Catch macro name clashes through `extra_globals.uci` (#30)"},{"Add":"* Add debugging option to profile build times (#35)"},{"Add":""},{"Add":"## 1.0.0 (2021-05-22)"},{"Add":""},{"Add":"* Initial release"}]}}],"owner":"rohan","repo":"XCom2-TCO_bridge_SMG","token":"kkbEcwb7LdaHkusI5K8wwEpq+jlgUALOSJG9AGd37xY=","login":null}

…

Dependencies

Change contents