Download .net 4.0 for B2SServerPluginInterface

Author: JockeJarre

.github/copilot-instructions.md

@@ -80,14 +80,14 @@ msbuild [solution].sln /t:Clean /p:Configuration=Debug /p:UICulture=en-US
 
 ### Validation Steps
 - All builds complete without errors (warnings are acceptable)
-- Generated executables appear in respective `bin/Debug` or `bin/x86/Debug` directories
+- Generated executables appear in the respective `bin/Debug` or `bin/Release` directories (Any CPU output)
 - B2SServerPluginInterface.dll must exist in `b2sbackglassserver/b2sbackglassserver/Plugin/` before building main server
 - No unit tests exist in this repository
 
 ## Project Architecture
 
 ### Main Components
-1. **b2sbackglassserver/** - Core COM server (DLL) and standalone executable (EXE)
+1. **b2sbackglassserver/** - Core COM server (DLL) and standalone executable (EXE) (the DLL calls the EXE depending on the configuration)
    - `B2SBackglassServer.vbproj` - COM server library
    - `B2SBackglassServerEXE.vbproj` - Standalone executable
    - Key files: `Server.vb`, `Classes/B2SVersionInfo.vb`
@@ -123,6 +123,7 @@ msbuild [solution].sln /t:Clean /p:Configuration=Debug /p:UICulture=en-US
 - Builds all configurations (Debug/Release) using Any CPU platform
 - Automatically updates version numbers from VB version constants
 - Creates release artifacts with all executables and documentation
+- Installs the .NET 4.0 developer pack and restores `Microsoft.NETFramework.ReferenceAssemblies.net40` via NuGet so the plugin can compile
 - **Prerelease workflow**: `.github/workflows/prerelease.yml` for tagged releases
 
 ### Development Notes
@@ -145,6 +146,7 @@ msbuild [solution].sln /t:Clean /p:Configuration=Debug /p:UICulture=en-US
 
 ### Common Issues and Workarounds
 - **Missing B2SServerPluginInterface.dll**: Always build this dependency first from the external repository
+- **B2SServerPluginInterface target**: The upstream project still targets .NET Framework 4.0; install the .NET 4.0 Developer Pack before building it locally
 - **Build configuration**: All projects now use "Any CPU" platform consistently
 - **Build order**: Some projects may have undocumented dependencies - build in the order listed above
 - **German build messages**: On German Windows systems, MSBuild may still show German messages even with `/p:UICulture=en-US`. The builds work correctly - focus on "Fehler" (errors) and "Warnung" (warnings) counts at the end

.github/workflows/b2s-backglass.yml

@@ -25,16 +25,17 @@ jobs:
         with:
           repository: DirectOutput/B2SServerPluginInterface
           path: B2SServerPluginInterface
-# Since the file is in the DirectOutput repository, we try to patch it here
-      - name: Patch B2SServerPluginInterface.csproj to use .NET Framework 4.8
+      - name: Setup NuGet
+        uses: NuGet/setup-nuget@v2
+      - name: Restore .NET 4 reference assemblies
         shell: pwsh
         run: |
-          $csproj = "B2SServerPluginInterface/B2SServerPluginInterface/B2SServerPluginInterface.csproj"
-          (Get-Content $csproj) -replace '<TargetFrameworkVersion>v4.0</TargetFrameworkVersion>', '<TargetFrameworkVersion>v4.8</TargetFrameworkVersion>' | Set-Content $csproj
-          $docProj = "B2SServerPluginInterface/Documentation/Documentation.csproj"
-          (Get-Content $docProj) -replace '<TargetFrameworkVersion>v4.0</TargetFrameworkVersion>', '<TargetFrameworkVersion>v4.8</TargetFrameworkVersion>' | Set-Content $docProj
-          (Get-Content $docProj) -replace '<TargetFrameworkProfile>Client</TargetFrameworkProfile>', '' | Set-Content $docProj
-
+          & "$env:ChocolateyInstall\bin\nuget.exe" install Microsoft.NETFramework.ReferenceAssemblies.net40 -Version 1.0.3 -OutputDirectory packages
+          $packageRoot = Join-Path $PWD 'packages/Microsoft.NETFramework.ReferenceAssemblies.net40.1.0.3'
+          $nupkg = Join-Path $packageRoot 'Microsoft.NETFramework.ReferenceAssemblies.net40.1.0.3.nupkg'
+          if (Test-Path $nupkg) {
+            Expand-Archive -LiteralPath $nupkg -DestinationPath $packageRoot -Force
+          }
       - id: version
         name: Update AssemblyInformationalVersion
         run: |
@@ -87,9 +88,10 @@ jobs:
           echo "tag=${VERSION_LONG}" >> $GITHUB_OUTPUT
       - uses: microsoft/setup-msbuild@v2
       - name: Build B2SServerPluginInterface
+        shell: pwsh
         run: |
-          msbuild B2SServerPluginInterface/B2SServerPluginInterface.sln /t:Rebuild /p:Configuration=${{ matrix.config }}
-        shell: cmd
+          $frameworkPath = Resolve-Path packages/Microsoft.NETFramework.ReferenceAssemblies.net40.1.0.3/build/.NETFramework/v4.0
+          msbuild B2SServerPluginInterface/B2SServerPluginInterface.sln /t:Rebuild /p:Configuration=${{ matrix.config }} /p:FrameworkPathOverride="$frameworkPath"
       - run: |
           cp B2SServerPluginInterface/B2SServerPluginInterface/bin/${{ matrix.config }}/B2SServerPluginInterface.dll b2sbackglassserver/b2sbackglassserver/Plugin
           if [[ "${{ matrix.config }}" == "Debug" ]]; then