CSharpLoader

黑神话悟空使用USharp作为脚本引擎，很多逻辑使用c#实现，提供接口给UE使用，而一些内部接口不能通过UE c++/lua访问。

这个mod加载器可以加载c#写的mod。C# mod可以调用USharp端提供的api，包括游戏内部的和C#包装的UE引擎的接口，也可以往游戏内部的事件和委托增加回调。

悟空使用 USharp 作为脚本引擎，很多逻辑都用 C# 实现。有些 api 只能在 C# 中访问，不能在 UE C++ 中访问。

这个 mod 加载器允许你加载用 C# 编写的 mod。C# mod 可以调用来自 b1-managed 和虚幻引擎的 csharp api。

更新记录

0.1.0:

• 重新提前了初始化时间，并避免出现错误，方便一些mod提前hook

0.0.9:

• 0.0.8提前了初始化时机，此版本把等待时间加回来，避免一些现有的mod初始化失败

0.0.8:

• 支持C# Patch/Hook，请注意说明
• 支持手柄按键（暂不支持PS和Switch手柄），也可以直接hook OnAnyKeyTriggerEvent
• 兼容其他使用version.dll的插件（放到CSharpLoader/Plugins目录中）
• 尝试支持游戏中文路径

更新日志

0.1.0:

• 初始化时间再次提前，并避免出现错误，让 mod 可以更早地 hook。

0.0.9:

• 0.0.8 版本把初始化时机提前了，此版本把等待时间加了回来，避免一些现有的 mod 初始化失败。

0.0.8:

• 支持 C# Patch/Hook，请注意说明。
• 支持手柄按键（目前不支持 PS 和 Switch 手柄），也可以直接 hook OnAnyKeyTriggerEvent。
• 兼容其他使用 version.dll 的插件（把它们放到 CSharpLoader/Plugins 目录中）。
• 尝试支持游戏中文路径。

使用说明 / 用法

解压到游戏目录

解压到游戏文件夹。

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需要放在

mod 的 dll 应放在

CSharpLoader/Mods/<ModName>/<ModName>.dll

例如

CSharpLoader/Mods/CSharpExample/CSharpExample.dll

如果你安装后游戏打不开，请尝试把hid.dll改名成version.dll (新版默认使用version.dll)

如果你安装后游戏打不开，请尝试把 hid.dll 改名成 version.dll

配置文件 CSharpLoader/b1cs.ini

Develop: 开启开发模式，可以按ctrl+f5重新加载C# mods

Console: 显示控制台窗口，打印log

EnableJit: 开启jit模式，请看下面的注意

配置文件 CSharpLoader/b1cs.ini

Develop: 开启开发模式，可以按 ctrl+f5 重新加载 C# mods

Console: 显示控制台窗口，打印 log

EnableJit: 请看下面的注意

注意

C# loader 0.0.7之后的版本为了支持C# patch/hook，把游戏的mono运行时的运行模式从默认的解释执行模式，改成了jit(运行时编译执行)模式。jit一定程度上可能会带来一些性能提升，但可能并未经过游戏开发商的充分测试，可能会对游戏的稳定性带来一些影响。同时由于修改了游戏的底层执行代码，目前与一些修改器不兼容，包括风灵月影在内的一些修改器会失效，请根据你使用的mod的说明，决定是否使用支持hook的C# loader。

注意

从 C# loader 0.0.7 版本开始，为了启用 C# patch/hook，游戏的 Mono 运行时执行模式已从默认的解释器模式改为 JIT（即时编译）模式。JIT 有可能带来一些性能提升，但它可能并未经过游戏开发商的充分测试，可能会对游戏的稳定性造成影响。此外，它目前与一些修改器不兼容，包括 flingtrainer，这些修改器可能会失效。请根据你使用的 mod 的说明，决定是否使用支持 hook 的 C# loader。

与其他插件的兼容

version.dll是常用的插件名字，如果你使用了其他有名称冲突的插件，可以把这些插件的dll，改成除version.dll外的其他名字（后缀得是.dll），放到CSharpLoader/Plugins/目录里，C# loader会一起加载这些插件

与其他插件的兼容性

"version.dll" 是常用的插件名字。如果你使用了其他有名称冲突的插件，可以把这些插件的 dll 改成除 "version.dll" 外的其他名字（后缀必须是 ".dll"），放到 "CSharpLoader/Plugins/" 目录里，C# loader 会一起加载这些插件。

如果你想了解如何用C# 开发黑神话悟空的mod，可以看这里：

如果你有兴趣开发 C# mod。

https://github.com/czastack/B1CSharpLoader/

感谢禽兽-云轩等mod作者的使用和反馈，帮助完善了这个C# loader，期待他们做出的优秀mod.

也感谢之前我修改器的用户们的使用和赞助，C# loader最开始在修改器上实验，并逐渐完善。

感谢 禽兽-云轩 等 mod 作者的使用和反馈，帮助完善了这个 C# loader，期待他们做出优秀的 mod。

也感谢我之前的修改器用户们的使用和赞助，C# loader 最开始在修改器上实验，并逐渐完善。

作者：chenstack