ModTemplateValheim

Template mod for Valheim using Bepinex. Works for Steam on either Windows or Linux systems. Everything required is automatically installed into Valheim:

BepInEx (Unstripped UnityEngine dlls too) + HarmonyX
Publicizes dlls from game as project dependencies
Moves your mod into the BepInEx plugins folder.

How to use template

Download or clone this repository then open in Visual Studio or JetBrains Rider.
(optional) Rename the ExampleCallMethodMod.csproj to your mod name.
Rebuild the solution.
If there are errors, restart your IDE.
Play Valheim to test your mod!

Any project in this solution that ends with Mod will automatically install itself into Valheim and reference the game code.

Requirements

MSBuild 16+ (also installed with Visual Studio)
If you want modern C# lang support you need https://dotnet.microsoft.com/en-us/download as well. See Directory.Build.props file to change language version.

Troubleshooting

Missing dependencies
- Run rebuild again
Code is red - IntelliSense broken
- Restart your IDE

I want to..

Rename my mod
Add (or change) the AssemblyName property to the mod's .csproj file. Note to run clean on this solution beforehand to uninstall your mods. Example:

<Project Sdk="Microsoft.NET.Sdk">
    <PropertyGroup>
        <AssemblyName>My cool mod name</AssemblyName>
    </PropertyGroup>
</Project>

Change mod author or version
Add (or change) the Authors property to the mod's .csproj file. Example:

<Project Sdk="Microsoft.NET.Sdk">
    <PropertyGroup>
        <Authors>Measurity;geocine;eai04191</Authors>
        <AssemblyName>My cool mod - the second</AssemblyName>
        <Version>1.0.0.1</Version>
    </PropertyGroup>
</Project>

Which will generate the BepInEx plugin metadata as:

public const string PluginAuthor = "Measurity & geocine & eai04191";
public const string PluginGuid = "com.github.measurity.Mycoolmodthesecond";
public const string PluginName = "My cool mod - the second";
public const string PluginVersion = "1.0.0.1";

Credits

https://github.com/MrPurple6411 - First to make a proper template. Used their declared project dependencies as a base.
https://github.com/sebastienvercammen - Providing help with overriding game DLLs with unstripped DLLs through UnityDoorstop.
https://github.com/js6pak - Primary author of BepInEx.AssemblyPublicizer.MSBuild which was a big help in figuring out MSBuild tasks.

And thanks to all contributors!

Details