CSharpLoader

C# mod加載器，允許使用C#編寫mod，調用遊戲內部的C#接口

CSharpLoader

🎮 **黑神話：悟空專用C#模組加載器**

✨ 核心功能

這個模組加載器允許你加載使用C#編寫的mod！黑神話：悟空使用USharp作爲腳本引擎，很多遊戲邏輯都是用C#實現的，而一些內部接口無法通過UE C++或Lua訪問。

C# mod可以調用來自b1-managed和虛幻引擎的C# API，還可以向遊戲內部的事件和委託添加回調函數！

🚀 安裝說明

將文件解壓到遊戲目錄：

```

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

```

mod的dll文件需要放置在：

```

CSharpLoader/Mods//.dll

```

例如：

```

CSharpLoader/Mods/CSharpExample/CSharpExample.dll

```

💡 **提示**：如果安裝後遊戲無法打開，嘗試將hid.dll重命名爲version.dll（新版默認使用version.dll）

⚙️ 配置文件

編輯 `CSharpLoader/b1cs.ini` 文件：

• **Develop**：開啓開發模式，可以按Ctrl+F5重新加載C# mods
• **Console**：顯示控制台窗口打印日誌
• **EnableJit**：開啓JIT模式（請查看下面的注意事項）

⚠️ 重要注意事項

從0.0.7版本開始，爲了支持C# patch/hook，遊戲的Mono運行時執行模式已從默認的解釋器模式改爲JIT（即時編譯）模式。

**JIT模式可能帶來：**

• 一定程度的性能提升
• 可能影響遊戲穩定性（未經遊戲開發商充分測試）
• 與一些修改器不兼容（包括風靈月影等）

🔧 插件兼容性

"version.dll"是常用的插件名稱。如果存在命名衝突，可以將其他插件的DLL重命名爲除"version.dll"外的其他名稱（後綴必須是".dll"），然後放置在"CSharpLoader/Plugins/"目錄中，C#加載器會一起加載這些插件。

🛠️ 開發資源

如果你想了解如何使用C#開發黑神話：悟空的mod，可以查看：

📝 更新日誌

**0.1.0版本：**

• 重新提前了初始化時間，避免出現錯誤，方便一些mod提前hook

**0.0.9版本：**

• 將0.0.8版本提前的初始化時機加回等待時間，避免一些現有mod初始化失敗

**0.0.8版本：**

• 支持C# Patch/Hook
• 支持手柄按鍵（暫不支持PS和Switch手柄）
• 兼容其他使用version.dll的插件
• 嘗試支持遊戲中文路徑

---

🌟 **特別感謝**：感謝獸-雲軒等mod作者的使用和反饋，幫助完善了這個C#加載器！