Hamunii.MonoMod.RuntimeDetour.HookGen.MSBuild 0.1.0

MonoMod.RuntimeDetour.HookGen.MSBuild

MonoMod's HookGen in MSBuild.
Forked from BepInEx.AssemblyPublicizer.

Note: This project is not officially linked with MonoMod.

Installation

Add this NuGet package in your csproj:

<ItemGroup>
    <PackageReference Include="Hamunii.MonoMod.RuntimeDetour.HookGen.MSBuild" Version="1.*" PrivateAssets="all"/>
</ItemGroup>

Usage

The usage is identical to BepInEx.AssemblyPublicizer, except HookGen is used instead of Publicize:

<ItemGroup>
    
    <Reference Include=".../TestProject.dll" HookGen="true" />
    <ProjectReference Include="../TestProject/TestProject.csproj" HookGen="true" />
    <PackageReference Include="TestProject" HookGen="true" />

    
    <HookGen Include="TestProject" />
</ItemGroup>

What is HookGen?

MonoMod's HookGen takes an assembly a generates a new assembly from it which contains MonoMod Hooks (On namespace) and ILHooks (IL namespace) as C# Events for almost every method, which you can subscribe to.

static class Example
{
    internal static void Init()
    {
        // Subscribing to hook events provided by HookGen
        On.SomeNamespace.SomeType.Method += MyHook;
        IL.SomeNamespace.SomeType.Method += MyILHook;
    }
    
    private static void MyHook(On.SomeNamespace.SomeType.orig_Method orig, SomeType self)
    {
        Plugin.Logger.LogInfo("Hello from MonoMod Hook!");
        orig(self); 
    }

    private static void MyILHook(ILContext il)
    {
        ILCursor c = new(il);
        // ...
        Plugin.Logger.LogInfo("IL modifications done!");
    }
}

What is not HookGen?

It's probably more likely that you only know HookGen, but not manual Hooking. For that, see the Lethal Company Modding Wiki.