-
Notifications
You must be signed in to change notification settings - Fork 2
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #11 from Tobi-Mob/1_0_2
* TurboAttack default active
- Loading branch information
Showing
6 changed files
with
104 additions
and
46 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,45 @@ | ||
## Full Installation Guide | ||
|
||
This is a more detailed description of things I did to get the mod working. If you just want to play with the mod, you don't have to read this. | ||
|
||
|
||
## Install BepInEx in your Skul Root folder | ||
Long general installation guide for BepInEx can be found [here](https://docs.bepinex.dev/master/articles/user_guide/installation/index.html). | ||
Shorter description for Skul below: | ||
|
||
At the time of writing, BepInEx 6 has no stable release. | ||
The current builds can be found here: [BepisBuilds](https://builds.bepis.io/projects/bepinex_be). | ||
|
||
For Windows use: BepInEx_UnityMono_x64 | ||
For Linux use: BepInEx_UnityMono_unix | ||
|
||
Extract the content of the archive into the Root folder of your Skul Installation. So that the Root folder of the game contains a "BepInEx" folder | ||
|
||
For Windows usually: C:\Program Files\Steam\steamapps\common\Skul\ | ||
For Linux usually: /home/MyUserName/.steam/debian-installation/steamapps/common/Skul/ | ||
|
||
Linux Only: | ||
- modify `run_bepinex.sh` to set the `executable_name` on line 15 like this: `executable_name="Skul.x86_64"` | ||
- make `run_bepinex.sh` executable. To do that, run in terminal: `chmod u+x run_bepinex.sh` | ||
- In Steam, under properties for Skul, set the Launch Options to `./run_bepinex.sh %command%` | ||
|
||
## Build the Mod/PlugIn | ||
|
||
Open the `Skul.Mod.csproj` and modify `<SkulDirectory>` to point to your Skul folder. | ||
Building the .net project will then build the .dll to `$(SkulDirectory)\BepInEx\plugins` where it will be automatically loaded by BepInEx | ||
|
||
## Unstrip Unity dlls | ||
Skul ships with stripped assemblies. ([for further reading](https://github.com/NeighTools/UnityDoorstop/issues/10#issuecomment-776921796)) | ||
Downloading the unstripped assemblies and dropping them into `$(SkulDirectory)\Skul_Data\Managed\` fixes that (overwriting existing files as needed). | ||
The `Managed` folder can be backed up in case something goes wrong. Alternatively Steams "Verify integrity of game files" can be used to restore the modified files. | ||
|
||
Long Description: [Guide by ghorsington](https://hackmd.io/@ghorsington/rJuLdZTzK) | ||
|
||
Short Description: | ||
- download https://unity.bepinex.dev/libraries/2020.3.22.zip and extract the content into `$(SkulDirectory)\Skul_Data\Managed\` | ||
- go to the [Unity Download Archives](https://unity3d.com/get-unity/download/archive) and download the Unity [UnitySetup64-2020.3.22f1.exe](https://download.unity3d.com/download_unity/e1a7f79fd887/Windows64EditorInstaller/UnitySetup64-2020.3.22f1.exe) (Linux users should download the Windows Version) | ||
- Install the Unity Editor and copy `$(UnityDirectory)/Editor/Data/MonoBleedingEdge/lib/mono/4.5` into `$(SkulDirectory)\Skul_Data\Managed\`. | ||
|
||
## Run the game | ||
|
||
If the mod is running correclty, pressing F1 while in the game will display a message above the player character. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,37 @@ | ||
Foreword | ||
=== | ||
|
||
If you already know C# and coded a bit in Unity you should be finde. If not, this could be a furstrating place to start learning. | ||
|
||
What technologies are used | ||
=== | ||
Skul itself is made with Unity. So most of the Unity C# API is also available to the modder: [Unity Monobehaviour](https://docs.unity3d.com/ScriptReference/MonoBehaviour.html) | ||
|
||
The Mod uses [BepInEx](https://github.com/BepInEx/BepInEx) which is build on top of [Harmony](https://github.com/pardeike/Harmony). They have a lot of documentation on how the stuff works and how it can be used. | ||
|
||
How does the build work | ||
=== | ||
|
||
The build requires 2 special things: | ||
* Skul game files | ||
* BepInEx dependencies | ||
|
||
### Skul game files | ||
|
||
The `Skul.Mod.csproj` has a `SkulDirectory` entry. | ||
The required gamefiles will be obtained from there and the build output of the mod will be copied there. | ||
|
||
If you change the entry, you may have to restart your IDE | ||
|
||
### BepInEx dependencies | ||
|
||
The required NuGets are inside the "Package"-directory of this repository. The original source for these NuGets is: https://nuget.bepinex.dev/v3/index.json | ||
|
||
The Build tries to get the NuGets from the "Package"-directory if possible, so you don't have to add the NuGets source manually. | ||
|
||
Where to get help | ||
=== | ||
First, consider the docs for [Unity](https://docs.unity3d.com/ScriptReference/MonoBehaviour.html), [BepInEx](https://docs.bepinex.dev/master/) and [Harmony](https://harmony.pardeike.net/). | ||
|
||
If that is not enough: | ||
This mod was only possible with help from the smart and motivated people from the BepInEx Discord. If you need help on Unity-Modding, that would be a good place to start. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters