/SharpPluginLoader

A C# plugin loader for Monster Hunter World

Primary LanguageC#

SharpPluginLoader

A C# plugin loader for Monster Hunter World based on .NET 8.0.

For more detailed documentation and tutorials, visit the wiki.

How to use

  1. Install .NET 8.0 (Get the .NET Desktop Runtime 8.0.0)
  2. Download the latest release from the releases page and extract it into your Monster Hunter World directory.

Plugin Development

  1. Install the Visual Studio 2022 17.8 Preview 2 or later.
  2. Create a new .NET 8.0 class library project and add a reference to SharpPluginLoader.Core.dll.
  3. Create a class that implements the SharpPluginLoader.Core.IPlugin interface.
  4. Implement the required methods.
  5. Put the compiled assembly into nativePC/plugins/CSharp. Assemblies are also allowed to be in subdirectories.

Dependency Resolution

The native host (SharpPluginLoader.Native.dll) loads the Bootstrapper assembly (SharpPluginLoader.Bootstrapper.dll) into the default AssemblyLoadContext (ALC). The Bootstrapper then loads the core assembly into a custom ALC (CoreLoadContext).

The CoreLoadContext resolves all dependencies either from the current directory, or via the Default ALC.

The core assembly then loads all plugins into a custom ALC (PluginLoadContext) and resolves all dependencies from the CoreLoadContext. Each plugin is loaded into a separate ALC.

Enabling C# Debugging

  1. Make sure all projects are compiled in Debug mode.
  2. Open the mhw-cs-plugin-loader project properties, make sure the Debug configuration is selected and go to General > Debugging. Here set the Debugger Type to Mixed (.NET Core).
  3. In the Attach to Process dialog, make sure Managed (.NET Core, .NET 5+) and Native are selected.

Hosting Docs Locally

  1. python -m venv venv
  2. venv\Scripts\activate
  3. pip install -r requirements.txt
  4. mkdocs serve

Libraries Used