/SolastaUnfinishedBusiness

Primary LanguageC#MIT LicenseMIT

Solasta Unfinished Business

This is a collection of work from the Solasta modding community. It includes multiclass, feats, classes, subclasses, items, crafting recipes, gameplay options, UI improvements, and more. The general philosophy is everything is optional to enable, so you can install the mod and then enable the pieces you want. There are some minor bug fixes that are enabled by default.

How to install

Download the first ZIP file from releases and follow the installation guide.

How to report issues

  • The versions of Solasta and this mod.
  • A list of other mods you have installed [you shouldn't have any].
  • A short description of the bug.
  • A step-by-step procedure to reproduce it.
  • The save, character and log files.

HINT: Check the folder C:\Users*YOUR_USER_NAME\AppData\LocalLow\Tactical Adventures\Solasta* for the info we need.

How to contribute

Do you have a mod you want to see included here? We are happy to take new contributions! The best way to get involved is to:

  1. Make a branch off of the Dev branch, name it something related to the changes you are making.
  2. Commit your edits to your branch.
  3. Make sure to test your changes. This is a good opportunity to take screen shots so you can show off the changes.
  4. Make a pull request to merge your branch into Dev. You can help this process by sharing screen shots to show off the change as well as including an english description of what the change does.
  5. Wait for a review. We try to stay on top of this, but it's a hobby.
  6. Once the review is done, the changes will get merged in to the Dev branch. The Dev branch will periodically be tested and merged in to master to build releases.

How to compile

  1. Install all required development pre-requisites:
  2. Download and install Unity Mod Manager (UMM)
  3. Execute UMM, Select Solasta, and Install
  4. Create the environment variable SolastaInstallDir and point it to your Solasta game home folder
    • tip: search for "edit the system environment variables" on windows search bar
  5. Open the project and clean the solution. This is key to allow the publicize assembly to be created
  6. Use "Install Release" or "Install Debug" to have the Mod installed directly to your Game Mods folder

NOTE Unity Mod Manager and this mod template make use of Harmony

How to debug

  1. Open Solasta game folder
    • Rename UnityPlayer.dll to UnityPlayer.dll.original
    • Add below entries to Solasta_Data\boot.config: 
       wait-for-managed-debugger=1
 player-connection-debug=1
  2. Download and install 7zip
  3. Download Unity Editor 2019.4.37
  4. Open Downloads folder
    • Right-click UnitySetup64-2019.4.32f1.exe, 7Zip -> Extract Here
    • Navigate to Editor\Data\PlaybackEngines\windowsstandalonesupport\Variations\win64_development_mono
      • Copy UnityPlayer.dll and WinPixEventRuntime.dll to clipboard
    • Navigate to the Solasta game folder
      • Rename UnityPlayer.dll to UnityPlayer.dll.original
      • Paste UnityPlayer.dll and WinPixEventRuntime.dll from clipboard
  5. You can now attach the Unity Debugger from Visual Studio 2019, Debug -> Attach Unity Debug