From 71ee7b5ad29b4836337bbdf229abaa7376518e04 Mon Sep 17 00:00:00 2001
From: Sean Doherty <smaster7772@gmail.com>
Date: Sun, 17 May 2026 18:22:42 -0500
Subject: [PATCH] Support portable KSP build paths

---
 PAPIPlugin/PAPIPlugin.csproj                  | 34 ++++++++++++-------
 README.md                                     |  5 ++-
 .../PAPIPlugin/PAPIPluginContinued.version    |  4 +--
 3 files changed, 28 insertions(+), 15 deletions(-)

diff --git a/PAPIPlugin/PAPIPlugin.csproj b/PAPIPlugin/PAPIPlugin.csproj
index 205afe9..a02666b 100644
--- a/PAPIPlugin/PAPIPlugin.csproj
+++ b/PAPIPlugin/PAPIPlugin.csproj
@@ -12,6 +12,12 @@
     <TargetFrameworkVersion>v4.0</TargetFrameworkVersion>
     <FileAlignment>512</FileAlignment>
     <TargetFrameworkProfile />
+    <KSP_PATH Condition=" '$(KSP_PATH)' == '' and '$(KSPDIR)' != '' ">$(KSPDIR)</KSP_PATH>
+    <KSP_PATH Condition=" '$(KSP_PATH)' == '' and '$(KSP_DIR)' != '' ">$(KSP_DIR)</KSP_PATH>
+    <KSPManagedDir Condition=" '$(KSPManagedDir)' == '' and '$(KSP_PATH)' != '' and Exists('$(KSP_PATH)/KSP_x64_Data/Managed/Assembly-CSharp.dll') ">$(KSP_PATH)/KSP_x64_Data/Managed</KSPManagedDir>
+    <KSPManagedDir Condition=" '$(KSPManagedDir)' == '' and '$(KSP_PATH)' != '' and Exists('$(KSP_PATH)/KSP_Data/Managed/Assembly-CSharp.dll') ">$(KSP_PATH)/KSP_Data/Managed</KSPManagedDir>
+    <KSPManagedDir Condition=" '$(KSPManagedDir)' == '' ">$(KSP_PATH)/KSP_x64_Data/Managed</KSPManagedDir>
+    <RunPostBuildCopy Condition=" '$(RunPostBuildCopy)' == '' ">true</RunPostBuildCopy>
   </PropertyGroup>
   <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
     <DebugSymbols>true</DebugSymbols>
@@ -36,54 +42,54 @@
   <ItemGroup>
     <Reference Include="Assembly-CSharp">
       <SpecificVersion>False</SpecificVersion>
-      <HintPath>$(KSP_PATH)/KSP_x64_Data/Managed/Assembly-CSharp.dll</HintPath>
+      <HintPath>$(KSPManagedDir)/Assembly-CSharp.dll</HintPath>
       <Private>False</Private>
     </Reference>
     <Reference Include="Assembly-CSharp-firstpass">
       <SpecificVersion>False</SpecificVersion>
-      <HintPath>$(KSP_PATH)/KSP_x64_Data/Managed/Assembly-CSharp-firstpass.dll</HintPath>
+      <HintPath>$(KSPManagedDir)/Assembly-CSharp-firstpass.dll</HintPath>
       <Private>False</Private>
     </Reference>
     <Reference Include="System" />
     <Reference Include="System.Core" />
     <Reference Include="UnityEngine">
       <SpecificVersion>False</SpecificVersion>
-      <HintPath>$(KSP_PATH)/KSP_x64_Data/Managed/UnityEngine.dll</HintPath>
+      <HintPath>$(KSPManagedDir)/UnityEngine.dll</HintPath>
       <Private>False</Private>
     </Reference>
     <Reference Include="UnityEngine.CoreModule">
       <SpecificVersion>False</SpecificVersion>
-      <HintPath>$(KSP_PATH)/KSP_x64_Data/Managed/UnityEngine.CoreModule.dll</HintPath>
+      <HintPath>$(KSPManagedDir)/UnityEngine.CoreModule.dll</HintPath>
       <Private>False</Private>
     </Reference>
     <Reference Include="UnityEngine.IMGUIModule">
       <SpecificVersion>False</SpecificVersion>
-      <HintPath>$(KSP_PATH)/KSP_x64_Data/Managed/UnityEngine.IMGUIModule.dll</HintPath>
+      <HintPath>$(KSPManagedDir)/UnityEngine.IMGUIModule.dll</HintPath>
       <Private>False</Private>
     </Reference>
     <Reference Include="UnityEngine.TextRenderingModule">
       <SpecificVersion>False</SpecificVersion>
-      <HintPath>$(KSP_PATH)/KSP_x64_Data/Managed/UnityEngine.TextRenderingModule.dll</HintPath>
+      <HintPath>$(KSPManagedDir)/UnityEngine.TextRenderingModule.dll</HintPath>
       <Private>False</Private>
     </Reference>
     <Reference Include="UnityEngine.ImageConversionModule">
       <SpecificVersion>False</SpecificVersion>
-      <HintPath>$(KSP_PATH)/KSP_x64_Data/Managed/UnityEngine.ImageConversionModule.dll</HintPath>
+      <HintPath>$(KSPManagedDir)/UnityEngine.ImageConversionModule.dll</HintPath>
       <Private>False</Private>
     </Reference>
     <Reference Include="UnityEngine.InputLegacyModule">
       <SpecificVersion>False</SpecificVersion>
-      <HintPath>$(KSP_PATH)/KSP_x64_Data/Managed/UnityEngine.InputLegacyModule.dll</HintPath>
+      <HintPath>$(KSPManagedDir)/UnityEngine.InputLegacyModule.dll</HintPath>
       <Private>False</Private>
     </Reference>
     <Reference Include="UnityEngine.PhysicsModule">
       <SpecificVersion>False</SpecificVersion>
-      <HintPath>$(KSP_PATH)/KSP_x64_Data/Managed/UnityEngine.PhysicsModule.dll</HintPath>
+      <HintPath>$(KSPManagedDir)/UnityEngine.PhysicsModule.dll</HintPath>
       <Private>False</Private>
     </Reference>
     <Reference Include="UnityEngine.AnimationModule">
       <SpecificVersion>False</SpecificVersion>
-      <HintPath>$(KSP_PATH)/KSP_x64_Data/Managed/UnityEngine.AnimationModule.dll</HintPath>
+      <HintPath>$(KSPManagedDir)/UnityEngine.AnimationModule.dll</HintPath>
       <Private>False</Private>
     </Reference>
   </ItemGroup>
@@ -111,7 +117,11 @@
   </ItemGroup>
   <ItemGroup />
   <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
-  <PropertyGroup>
+  <Target Name="ValidateKSPReferences" BeforeTargets="BeforeBuild">
+    <Error Condition="!Exists('$(KSPManagedDir)/Assembly-CSharp.dll')" Text="KSP reference not found: $(KSPManagedDir)/Assembly-CSharp.dll. Set KSP_PATH, KSPDIR, KSP_DIR, or pass /p:KSPManagedDir=... to the build." />
+    <Error Condition="!Exists('$(KSPManagedDir)/UnityEngine.dll')" Text="KSP reference not found: $(KSPManagedDir)/UnityEngine.dll. Set KSP_PATH, KSPDIR, KSP_DIR, or pass /p:KSPManagedDir=... to the build." />
+  </Target>
+  <PropertyGroup Condition=" '$(RunPostBuildCopy)' != 'false' ">
     <PostBuildEvent>mkdir "$(SolutionDir)assets/GameData/PAPIPlugin/Plugins"
 xcopy /Y /I "$(TargetPath)" "$(SolutionDir)assets/GameData/PAPIPlugin/Plugins"</PostBuildEvent>
   </PropertyGroup>
@@ -122,4 +132,4 @@ xcopy /Y /I "$(TargetPath)" "$(SolutionDir)assets/GameData/PAPIPlugin/Plugins"</
   <Target Name="AfterBuild">
   </Target>
   -->
-</Project>
\ No newline at end of file
+</Project>
diff --git a/README.md b/README.md
index 7060256..9465bd6 100644
--- a/README.md
+++ b/README.md
@@ -19,8 +19,11 @@ This fork builds against Kerbal Space Program 1.12.x.
 2. Open the solution in Visual Studio or build it with MSBuild.
 3. Build the *Release* configuration.
 
-The project already references the required KSP and Unity assemblies from *<KSP_PATH>/KSP_x64_Data/Managed*.
+The project references the required KSP and Unity assemblies from *<KSP_PATH>/KSP_x64_Data/Managed*
+on Windows installs or *<KSP_PATH>/KSP_Data/Managed* on Linux installs.
+The *KSPDIR*, *KSP_DIR*, and *KSPManagedDir* MSBuild properties are also supported.
 The built DLL is copied to *assets/GameData/PAPIPlugin/Plugins* during the build.
+Pass */p:RunPostBuildCopy=false* for a compile-only build that skips the local copy step.
 
 Installation
 ----------
diff --git a/assets/GameData/PAPIPlugin/PAPIPluginContinued.version b/assets/GameData/PAPIPlugin/PAPIPluginContinued.version
index 2d836fd..7712d95 100644
--- a/assets/GameData/PAPIPlugin/PAPIPluginContinued.version
+++ b/assets/GameData/PAPIPlugin/PAPIPluginContinued.version
@@ -6,7 +6,7 @@
     {
         "USERNAME":"bssthu",
         "REPOSITORY":"PAPIPlugin",
-        "ALLOW_PRE_RELEASE":true,
+        "ALLOW_PRE_RELEASE":true
     },
     "VERSION":
     {
@@ -33,4 +33,4 @@
         "MINOR":12,
         "PATCH":99
     }
-} 
\ No newline at end of file
+}