CSharpLoader - 重生版

CSharpLoader - 重生版

CSharpLoader - 重启修复与增强,不再被遗弃!

[color=#7EB6FF]已在游戏版本 1.0.21.23831 上测试[/color]

[color=#D4D4D8]所有游戏版本均可使用。如果加载器无法启动,游戏中会显示红色横幅提示。[/color]

源代码、所有发行版和更新日志(GitHub)

github.com/KintaroModding/b1csharploader

描述

[color=#D4D4D8]C# Loader 可将用 C# 编写的模组加载到《黑神话:悟空》中。游戏的许多逻辑都用 C# 编写,其中一部分只能通过 C# 访问,无法通过虚幻引擎 C++ 或 Lua 访问。C# 模组可以使用游戏自身的代码、响应游戏事件并修改游戏函数。

本模组是 czastack 的 B1CSharpLoader 的维护分支,czastack 创建了 C# Loader 并编写了其几乎所有代码。原项目自 2024 年 10 月起就没有再更新。本分支使其在新游戏版本下继续可用,修复了错误,并添加了游戏内控制台。[/color]

安装说明

  1. [color=#D4D4D8]下载主文件。[/color]
  2. [color=#D4D4D8]打开 zip 压缩包,将 b1 文件夹复制到你的 BlackMythWukong 游戏文件夹中。复制后,你的游戏文件夹中应包含 b1/Binaries/Win64/version.dll 以及文件夹 b1/Binaries/Win64/CSharpLoader。[/color]
  3. [color=#D4D4D8]将每个 C# 模组放到各自的文件夹中:CSharpLoader/Mods/<ModName>/<ModName>.dll[/color]
  4. [color=#D4D4D8]启动游戏。屏幕顶部会出现横幅,显示 C# Loader 正在运行以及已加载的模组数量。[/color]

[color=#D4D4D8]更新: 将新版本的文件覆盖到旧文件上即可。你的 Mods 文件夹保持原样。如果你修改过 CSharpLoader/b1cs.ini,请保留你自己的一份副本。

卸载: 删除 b1/Binaries/Win64/version.dll 和文件夹 b1/Binaries/Win64/CSharpLoader。本加载器不会更改你的存档。

设置位于 CSharpLoader/b1cs.ini 中(1 = 开启,0 = 关闭):[/color]

  • [color=#D4D4D8]Overlay=1 - 游戏内控制台[/color]
  • [color=#D4D4D8]OverlayKey=F10 - 游戏内控制台的按键,例如 F9、Insert、Home 或 Tilde[/color]
  • [color=#D4D4D8]EnableJit=1 - 使用 Harmony 钩子的模组需要此项[/color]
  • [color=#D4D4D8]Develop=1 - 按 Ctrl+F5 重新加载所有 C# 模组[/color]
  • [color=#D4D4D8]Console=0 - 额外的 Windows 控制台窗口,仅用于故障排查[/color]

主要功能

  • [color=#D4D4D8]加载 C# 模组,从 CSharpLoader/Mods 文件夹中加载。[/color]
  • [color=#D4D4D8]游戏内控制台: 按 F10 可在游戏画面上方查看加载器和所有模组的日志。使用 Page Up 和 Page Down 可滚动查看最近 500 行。已加载的模组列在顶部,加载失败的模组以红色显示。[/color]
  • [color=#D4D4D8]横幅: 加载器运行时、无法启动时(例如游戏更新后)以及按下 Ctrl+F5 后,会显示一条简短横幅。当模组加载失败时横幅变为红色,当你的游戏版本比测试版本更新时变为黄色。[/color]
  • [color=#D4D4D8]错误标记: 控制台关闭时,右上角会出现一个小红框,提示有新的错误。[/color]
  • [color=#D4D4D8]日志文件: 每次启动游戏都会在 CSharpLoader/Logs 中写入一个日志文件。保留最近 5 个。[/color]
  • [color=#D4D4D8]模组热键: 支持键盘按键和 Xbox 手柄按钮,也支持按钮组合。[/color]
  • [color=#D4D4D8]Harmony 钩子, 让模组可以修改游戏函数。[/color]
  • [color=#D4D4D8]与其他 version.dll 插件兼容: 将其他插件重命名为任意以 .dll 结尾的名称,并放入 CSharpLoader/Plugins 中。[/color]
  • [color=#D4D4D8]游戏内控制台是一个独立的、可点击穿透的窗口。它从不占用鼠标或焦点,也不会改变游戏的渲染方式。[/color]

要求

  • [color=#D4D4D8]《黑神话:悟空》。已在游戏版本 1.0.21.23831 上测试。游戏更新可能导致加载器失效,直到加载器也更新为止。[/color]
  • [color=#D4D4D8]对于游戏内控制台,请以 无边框 或 窗口化 模式游玩。在独占全屏模式下可能无法显示。[/color]
  • [color=#D4D4D8]对玩家来说没有其他要求。C# Loader 自带其所需的一切。[/color]

[color=#D4D4D8]须知: 当 EnableJit=1 时,某些修改器(例如 FLiNG 修改器)将无法使用。如果你的模组不需要钩子,可以将 EnableJit 设为 0。

错误报告: 请附上 b1/Binaries/Win64/CSharpLoader/Logs 中最新的文件。[/color]

致谢

  • [color=#D4D4D8]czastack - C# Loader 的创建者。加载器的所有功劳都归于他们。[/color]
  • [color=#D4D4D8]reece15 - 手柄按钮组合修复[/color]
  • [color=#D4D4D8]TheFBplus - 含空格路径的构建修复[/color]
  • [color=#D4D4D8]inkydragon - 提取游戏 C# 文件的脚本[/color]
  • [color=#D4D4D8]bfxh - 输入线程和模组加载修复所依据的错误报告[/color]