Merge branch 'msbuild-refactor' into next

# Conflicts:
#	.github/actions/compile/action.yml
#	docs/msbuild/dependencies.md

Author: drewcassidy

.github/actions/compile/action.yml

@@ -69,12 +69,12 @@ runs:
     - name: Restore Mod Solution
       shell: bash
       working-directory: ${{ inputs.working-directory }}
-      run: nuget restore ${{ inputs.solution-file-path }} -Verbosity detailed
+      run: dotnet restore ${{ inputs.solution-file-path }} ${{ runner.debug && '-v:diagnostic' }}
 
     - name: Build Mod Solution
       shell: bash
       working-directory: ${{ inputs.working-directory }}
-      run: |
-        dotnet msbuild -m:1 -p:Configuration=${{ inputs.build-configuration }} \
-        -p:ManagedRelativePath=KSP_x64_Data/Managed ${{ inputs.solution-file-path }} \
-        ${{ runner.debug && '-v:detailed' }}
+      run: >
+        dotnet msbuild -m:1 -p:Configuration=${{ inputs.build-configuration }}
+        -p:ManagedRelativePath=KSP_x64_Data/Managed ${{ inputs.solution-file-path }}
+        ${{ runner.debug && '-v:diagnostic' }}

.github/workflows/internal-ci.yml

@@ -19,7 +19,7 @@ jobs:
     env:
       DOTNET_SKIP_FIRST_TIME_EXPERIENCE: 1
       DOTNET_NOLOGO: true
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     outputs:
       package-version: ${{ steps.get-version.outputs.version }}
     steps:
@@ -60,17 +60,14 @@ jobs:
     with:
       package-version: ${{ needs.build.outputs.package-version }}
 
-  test-plugin-legacy:
-    uses: './.github/workflows/internal-test-plugin-legacy.yml'
-
   test-assetbundle:
     uses: './.github/workflows/internal-test-assetbundle.yml'
     if: github.event_name != 'pull_request'
     secrets: inherit
 
   deploy:
     runs-on: ubuntu-22.04
-    needs: [ build, test-plugin, test-plugin-nuget, test-plugin-legacy, test-assetbundle ]
+    needs: [ build, test-plugin, test-plugin-nuget, test-assetbundle ]
     environment:
       name: "NuGet"
       url: "https://www.nuget.org/packages/KSPBuildTools"

.github/workflows/internal-test-assetbundle.yml

@@ -12,19 +12,20 @@ env:
 
 jobs:
   build:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
 
       - uses: actions/checkout@v4
         with:
-          repository: 'drewcassidy/Resurfaced'
+          repository: 'Tantares/Resurfaced'
+          ref: "v.1.3.1"
           path: 'Resurfaced'
 
       - uses: ./.github/actions/build-assetbundles
         with: 
           assetbundle-name: foo.shab
-          asset-files: 'Resurfaced/*.shader Resurfaced/*.cginc'
+          asset-files: 'Resurfaced/Source/Shaders/*.shader Resurfaced/Source/Shaders/*.cginc'
         env:
           UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
           UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}

.github/workflows/internal-test-plugin-legacy.yml

@@ -13,8 +13,12 @@ env:
   NuGetDirectory: ${{ github.workspace}}/nuget
 
 jobs:
+
   build:
-    runs-on: ubuntu-22.04
+    strategy:
+      matrix:
+        dotnet-version: [ 5.x, 7.x, 9.x ]
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
 
@@ -26,7 +30,7 @@ jobs:
       - name: Setup Nuget Package Sources
         run: |
           mkdir -p ${{ env.NuGetDirectory }}/local
-          nuget sources add -Name local -Source ${{ env.NuGetDirectory }}/local
+          dotnet nuget add source ${{ env.NuGetDirectory }}/local -n local
 
       - uses: actions/download-artifact@v4
         with:
@@ -39,11 +43,12 @@ jobs:
         with:
           ksp-zip-url: https://github.com/KSPModdingLibs/KSPLibs/raw/main/KSP-1.12.5.zip
           working-directory: ${{ env.TESTDIR }}
-          solution-file-path: plugin-mod.csproj
+          solution-file-path: plugin-mod-nuget.csproj
+          dotnet-version: ${{ matrix.dotnet-version }}
         env:
           KSPBuildToolsVersion: ${{ inputs.package-version }}
 
       - uses: ./.github/actions/assemble-release
         with:
           artifacts: ${{ env.TESTDIR }}/GameData
-          output-file-name: plugin-mod-nuget
+          output-file-name: plugin-mod-nuget-${{ matrix.dotnet-version }}

.github/workflows/internal-test-plugin-nuget.yml

@@ -9,7 +9,7 @@ env:
 
 jobs:
   build:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
 

.github/workflows/internal-test-plugin.yml

@@ -27,7 +27,7 @@ on:
 
 jobs:
   publish-to-spacedock:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     steps:
       - name: get-release-info
         id: get-release-info

.github/workflows/publish-to-spacedock.yml

@@ -6,7 +6,7 @@ on:
 
 jobs:
   validate:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     steps:
       - name: Checkout repo
         uses: actions/checkout@v4

.github/workflows/validate.yml

@@ -2,6 +2,12 @@
 bin
 obj
 *.nupkg
+packages
 
 # docs
 docs/_build
+
+# misc
+.DS_Store
+.idea
+*.user

.gitignore

@@ -2,6 +2,25 @@
 
 All notable changes to this project will be documented in this file
 
+## 0.1.0-alpha.1 - 2025-08-06
+
+### Msbuild
+
+- Renamed global msbuild properties to have the `KSPBT_` prefix to avoid namespace collisions with other frameworks
+  - `KSPRoot` is now `KSPBT_GameRoot`. It should no longer be referenced within a .csproj file
+  - `RepoRootPath` is now `KSPBT_ModRoot`, and should now point to the mod folder within GameData rather than the
+    root of a git repo
+  - `BinariesOutputRelativePath` is now `KSPBT_ModPluginFolder`
+  - `GenerateKSPAssemblyAttribute` is now `KSPBT_GenerateAssemblyAttribute` and defaults to true
+  - `GenerateKSPAssemblyDependencyAttributes` is now `KSPBT_GenerateDependencyAttributes` and defaults to true
+  - `ReferenceUnityAssemblies` is now `KSPBT_ReferenceUnityAssemblies`
+  - `ReferenceKSPAssemblies` is now `KSPBT_ReferenceGameAssemblies`
+- Added the `KSPBT_ReferenceSystemAssemblies` property to control referencing the mono system DLLs within the KSP
+  managed folder. Setting this property to false will load the implicit framework DLLs instead.
+- Mod dependencies should now be declared with
+  `ModReference` items. This avoids the need for the KSP install path to be known at evaluation time.
+
+
 ## 0.0.4 - 2025-06-15
 
 ### Library