From 2c278b970385486232b2c2727ab74c20e7730921 Mon Sep 17 00:00:00 2001
From: Jesse Plamondon-Willard <github@jplamondonw.com>
Date: Sun, 22 Jan 2017 22:52:41 -0500
Subject: add support for setting a custom game path globally

---
 README.md           | 49 ++++++++++++++++++++++++++++++++++++-------------
 build/smapi.targets |  8 +++++++-
 2 files changed, 43 insertions(+), 14 deletions(-)

diff --git a/README.md b/README.md
index f3be04b3..f472049c 100644
--- a/README.md
+++ b/README.md
@@ -63,28 +63,51 @@ This will deploy your mod files into the game directory, launch SMAPI, and attac
 
 ## Troubleshoot
 ### "Failed to find the game install path"
-If you see this error:
+That error means the package couldn't figure out where the game is installed. You need to specify
+the game location yourself. There's two ways to do that:
 
-> Failed to find the game install path automatically; edit the *.csproj file and manually add a
-> &lt;GamePath&gt; setting with the full directory path containing the Stardew Valley executable.
+* **Option 1: set the path in the project file.**  
+  _(You'll need to do it for every project that uses the package.)_
+  1. Get the folder path containing the Stardew Valley `.exe` file.
+  2. Add this to your `.csproj` file under the `<Project` line:
 
-...the package couldn't find your game install path automatically. You'll need to specify the
-game location:
+     ```xml
+     <PropertyGroup>
+       <GamePath>PATH_HERE</GamePath>
+     </PropertyGroup>
+     ```
 
-1. Get the full folder path containing the Stardew Valley executable.
-2. Add this to your `.csproj` file under the `<Project` line (with the correct game path):
-   
-   ```xml
-   <PropertyGroup>
-     <GamePath>C:\Program Files (x86)\GalaxyClient\Games\Stardew Valley</GamePath>
-   </PropertyGroup>
-   ```
+  3. Replace `PATH_HERE` with your custom game install path.
+
+* **Option 2: set the path globally.**  
+  _This will apply to every project that uses version 1.5+ of package._
+
+  1. Get the full folder path containing the Stardew Valley executable.
+  2. Create this file path:
+  
+     platform  | path
+     --------- | ----
+     Linux/Mac | `~/stardewvalley.targets`
+     Windows   | `%USERPROFILE%\stardewvalley.targets`
+
+  3. Save the file with this content:
+
+     ```xml
+     <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+        <PropertyGroup>
+          <GamePath>PATH_HERE</GamePath>
+        </PropertyGroup>
+     </Project>
+     ```
+
+  4. Replace `PATH_HERE` with your custom game install path.
 
 The configuration will check your custom path first, then fall back to the default paths (so it'll
 still compile on a different computer).
 
 ## Versions
 1.5 (upcoming):
+* Added support for setting a custom game path globally.
 * Added default GOG path on Mac.
 
 1.4:
diff --git a/build/smapi.targets b/build/smapi.targets
index ed513846..de3420d1 100644
--- a/build/smapi.targets
+++ b/build/smapi.targets
@@ -1,4 +1,10 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <!--######
+  ## import global settings
+  #######-->
+  <Import Condition="$(OS) != 'Windows_NT' AND Exists('$(HOME)\stardewvalley.targets')" Project="$(HOME)\stardewvalley.targets" />
+  <Import Condition="$(OS) == 'Windows_NT' AND Exists('$(USERPROFILE)\stardewvalley.targets')" Project="$(USERPROFILE)\stardewvalley.targets" />
+
   <!--######
   ## select target OS
   #######-->
@@ -94,6 +100,6 @@
   #######-->
   <Target Name="BeforeBuild">
     <!-- if game path is invalid, show one user-friendly error instead of a slew of reference errors -->
-    <Error Condition="!Exists('$(GamePath)')" Text="Failed to find the game install path automatically; edit the *.csproj file and manually add a &lt;GamePath&gt; setting with the full directory path containing the Stardew Valley executable." />
+    <Error Condition="!Exists('$(GamePath)')" Text="Failed to find the game install path. See https://github.com/Pathoschild/Stardew.ModBuildConfig#troubleshoot for help." />
   </Target>
 </Project>
\ No newline at end of file
-- 
cgit