Release 1.0.0-alpha.3

### 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.
- Only include Log.cs (or anything else in include/unity) when `KSPBT_ReferenceUnityAssemblies` is `true` (#61)
- Fix `KSP_VERSION_MAX` getting mangled when using an existing version file (#64)
- Fix incorrect behavior when building without a solution (#50)

### Actions

- KSPBT actions used in reusable workflows are now pinned with each tag, instead of using actions from `main`. All calls to reusable workflows should be pinned to a tag to ensure the correct actions are being used. (#21)
- `compile` action: Use `dotnet restore` instead of `nuget restore` by default, allowing the action to work on any Ubuntu runner image. Added the `use-nuget-restore` option to restore the previous behavior for projects that use packages.config for dependencies. (#68)
- `compile` action: Removed call to`actions/setup-dotnet`. Setting up .NET should be done as a separate step. (#65)
- `setup-ckan` action: Sped up execution by skipping recommended packages and man-db updates
- `setup-ckan` action: Add `ckan-install-method` option for installation method. Currently supports `'apt'` for installation on Debian/Ubuntu, or `'skip'` to skip installation for runners that already have CKAN installed.
- `assemble-release` action: `outputs.artifact-path` now includes the `.zip` extension (#51)

Author: drewcassidy

.github/workflows/build.yml

@@ -60,17 +60,17 @@ jobs:
           dotnet-version: ${{ inputs.dotnet-version }}
 
       # Install CKAN and set up an instance
-      - uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].2
+      - uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].3
         if: ${{ (inputs.use-ckan && inputs.use-msbuild) || inputs.dependency-identifiers }}
 
       # Install any listed CKAN dependencies
-      - uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].2
+      - uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].3
         if: ${{ inputs.dependency-identifiers }}
         with:
           dependency-identifiers: ${{ inputs.dependency-identifiers }}
 
       # Compile the mod
-      - uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].2
+      - uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].3
         if: ${{ inputs.use-msbuild }}
         with:
           build-configuration: ${{ inputs.build-configuration }}
@@ -80,7 +80,7 @@ jobs:
           use-nuget-restore: ${{ inputs.use-nuget-restore }}
 
       # Assemble the mod into a release package and upload it as an artifact
-      - uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].2
+      - uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].3
         with:
           artifacts: ${{ inputs.artifacts }}
           output-file-name: ${{ github.event.repository.name }}-${{ inputs.build-configuration }}

.github/workflows/create-release.yml

@@ -64,7 +64,7 @@ jobs:
           submodules: true
 
       - name: update-version
-        uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].2
+        uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].3
         with:
           version-string: ${{ inputs.version-string }}
           template-extension: ${{ inputs.version-template-extension }}
@@ -81,18 +81,18 @@ jobs:
           git tag -f -a "$VERSION_STRING" -m "$VERSION_STRING"
 
       # Install CKAN and set up an instance
-      - uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].2
+      - uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].3
         if: ${{ (inputs.use-ckan && inputs.use-msbuild) || inputs.dependency-identifiers }}
 
       # Install any listed CKAN dependencies
-      - uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].2
+      - uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].3
         if: ${{ inputs.dependency-identifiers }}
         with:
           dependency-identifiers: ${{ inputs.dependency-identifiers }}
 
       - name: compile
         if: ${{ inputs.use-msbuild }}
-        uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].2
+        uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].3
         with:
           build-configuration: ${{ inputs.build-configuration }}
           ksp-zip-url: ${{ inputs.ksp-zip-url }}
@@ -101,7 +101,7 @@ jobs:
 
       - name: assemble-release
         id: assemble-release
-        uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].2
+        uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].3
         with:
           artifacts: ${{ inputs.artifacts }}
           output-file-name: ${{ github.event.repository.name }}-${{ env.VERSION_STRING }}

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

@@ -31,7 +31,7 @@ jobs:
     steps:
       - name: get-release-info
         id: get-release-info
-        uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].2
+        uses: KSPModdingLibs/KSPBuildTools/.github/actions/[email protected].3
         with:
           release-tag: ${{ inputs.release-tag }}
 

CHANGELOG.md

@@ -2,7 +2,7 @@
 
 All notable changes to this project will be documented in this file
 
-## 1.0.0-alpha.2 - 2025-11-07
+## 1.0.0-alpha.3 - 2025-11-14
 
 ### Msbuild