CSharpLoader

C# mod loader, allowing mods to be written in C# and calling the C# interface inside the game

CSharpLoader

🎮 **Black Myth: Wukong Special C# Module Loader**

✨ Core Functions

This mod loader allows you to load mods written in C#! Black Myth: Wukong uses USharp as the script engine. Many game logics are implemented in C#, and some internal interfaces cannot be accessed through UE C++ or Lua.

C# mods can call C# APIs from b1-managed and Unreal Engine, and can also add callbacks to events and delegates inside the game!

🚀 Installation instructions

Extract the files to the game directory:

```

BlackMythWukong/b1/Binaries/Win64/

CSharpLoader/

Data/

Mods/

Plugins/

0Harmony.dll

CSharpManager.bin

CSharpModBase.dll

Mono.Cecil.dll

Mono.Cecil.Pdb.dll

Mono.Cecil.Rocks.dll

b1cs.ini

version.dll

```

The mod's dll file needs to be placed in:

```

CSharpLoader/Mods//.dll

```

For example:

```

CSharpLoader/Mods/CSharpExample/CSharpExample.dll

```

💡 **Tip**: If the game cannot be opened after installation, try renaming hid.dll to version.dll (the new version uses version.dll by default)

⚙️ Configuration file

Edit the `CSharpLoader/b1cs.ini` file:

• **Develop**: Turn on development mode, you can press Ctrl+F5 to reload C# mods
• **Console**: Display the console window and print the log
• **EnableJit**: Turn on JIT mode (please see the notes below)

⚠️ IMPORTANT NOTES

Starting from version 0.0.7, in order to support C# patch/hook, the game's Mono runtime execution mode has been changed from the default interpreter mode to JIT (just in time compilation) mode.

**JIT mode may bring: **

• Some performance improvements
• May affect game stability (not fully tested by game developers)
• Incompatible with some modifiers (including Wind Spirit Moon Shadow, etc.)

🔧 Plug-in Compatibility

"version.dll" is a commonly used plug-in name. If there is a naming conflict, you can rename the DLLs of other plug-ins to names other than "version.dll" (the suffix must be ".dll"), and then place them in the "CSharpLoader/Plugins/" directory, and the C# loader will load these plug-ins together.

🛠️ Development resources

If you want to know how to use C# to develop Black Myth: Wukong mod, you can check out:

📝 Update log

**Version 0.1.0:**

• The initialization time has been advanced again to avoid errors and facilitate some mods to hook in advance.

**Version 0.0.9:**

• Add the early initialization timing of version 0.0.8 back to the waiting time to avoid initialization failures of some existing mods

**Version 0.0.8:**

-Support C# Patch/Hook

• Supports handle buttons (PS and Switch handles are not supported yet)
• Compatible with other plug-ins that use version.dll
• Try to support the Chinese path of the game

---

🌟 **Special thanks**: Thanks to beast-Yunxuan and other mod authors for their use and feedback, which helped improve this C# loader!