https://github.com/pgilbertschmitt/gillyjotunnmodtutorial
Trying the Jotunn Mod library tutorials
https://github.com/pgilbertschmitt/gillyjotunnmodtutorial
Last synced: 2 months ago
JSON representation
Trying the Jotunn Mod library tutorials
- Host: GitHub
- URL: https://github.com/pgilbertschmitt/gillyjotunnmodtutorial
- Owner: PGilbertSchmitt
- License: mit-0
- Created: 2024-06-30T14:00:24.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-06-30T14:03:21.000Z (11 months ago)
- Last Synced: 2025-01-17T14:36:12.303Z (4 months ago)
- Language: PowerShell
- Size: 175 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.MD
- License: LICENSE
Awesome Lists containing this project
README
# JötunnModStub
A Valheim mod stub project using [Jötunn](https://github.com/Valheim-Modding/Jotunn) including build tools and a basic Unity project stub.
There is no actual plugin content included, just a minimum plugin class.
# Setup Guide
Please see [Jötunn Docs](https://valheim-modding.github.io/Jotunn/guides/overview.html) detailed documentation and setup.
### Post Build automations
Included in this repo is a PowerShell script `publish.ps1`.
The script is referenced in the project file as a post-build event.
Depending on the chosen configuration in Visual Studio the script executes the following actions.
### Building Debug
The compiled dll and a dll.mdb debug file are copied to `\BepInEx\plugins` (or the path set in MOD_DEPLOYPATH).
### Building Release
A compressed file with the binaries is created in `\Packages`ready for upload to ThunderStore.
Dont forget to include your information in the manifest.json and to change the project's readme file.
## Developing Assets with Unity
New Assets can be created with Unity and imported into Valheim using the mod.
A Unity project is included in this repository under `\JotunnModUnity`.
### Unity Editor Setup
1. [Download](https://public-cdn.cloud.unity3d.com/hub/prod/UnityHubSetup.exe) UnityHub directly from Unity or install it with the Visual Studio Installer via `Individual Components` -> `Visual Studio Tools for Unity`
2. You will need an Unity account to register your PC and get a free licence. Create the account, login with it in Unity Hub and get your licence via `Settings` -> `Licence Management`
3. Install Unity Editor version 2022.3.17f
4. Compile the project. This copies all assemblies into `\JotunnModUnity\Assets\Assemblies`. Don't open Unity yet before this step, it will remove assembly references.
5. **Warning:** These assembly files are copyrighted material and you can theoretically get into trouble when you distribute them in your github repository. To avoid that there is a .gitignore file in the Unity project folder. Keep that when you clone or copy this repository
6. Open Unity Hub and add the JotunnModUnity project
7. Open the project in Unity
8. Install the `AssetBundle Browser` package in the Unity Editor via `Window`-> `Package Manager` for easy bundle creation
## Debugging
See the Wiki page [Debugging Plugins via IDE](https://github.com/Valheim-Modding/Wiki/wiki/Debugging-Plugins-via-IDE) for more information
## Actions after a game update
When Valheim updates it is likely that parts of the assembly files change.
If this is the case, the references to the assembly files must be renewed in Visual Studio and Unity.
### Prebuild actions
1. There is a file called DoPrebuild.props included in the solution. When you set its only value to true, Jötunn will automatically generate publicized assemblies for you. Otherwise you have to do this step manually.
### Unity actions
1. Copy all `assembly_*.dll` from `\valheim_Data\Managed` into `\JotunnModUnity\Assets\Assemblies`.
**Do this directly in the filesystem - don't import the dlls in Unity**.
2. Go to Unity Editor and press `Ctrl+R`. This reloads all files from the filesystem and "re-imports" the copied dlls into the project.