GK2模组框架

创作者: SuperMan4eg

已更新:2026-10-08 16:12:21

114KB

下载

关于此 MOD

一个用于《墓场物语2》代码模组的BepInEx框架，带有游戏内模组菜单、共享设置界面、依赖项和兼容性检查

GK2模组框架

GK2 Mod Framework 是为《墓场物语2》代码模组打造的共享 BepInEx 基础框架。它添加了游戏内模组菜单、通用设置界面、兼容性报告、依赖项以及安全的生命周期钩子，但本身不会改变游戏玩法。

功能

融入主菜单的原生风格模组菜单。
用于开关、数值滑块、下拉菜单、键位绑定、文本和只读值的自动设置界面。
为模组窗口和框架托管的模组设置页面提供响应式安全区域适配，并支持可配置的50-100%窗口缩放。
模组元数据、依赖检查、启用状态和兼容性详情，一站尽览。
为必须拒绝未验证游戏版本的模组构建指纹识别。
为模组开发者提供已文档化的 API、硬依赖入门模板以及可选的独立与桥接集成模板。
使用BepInEx和HarmonyX，而非引入另一个DLL加载器。

此框架为依赖项与开发基础，其本身不添加玩法内容。

要求

《墓场物语2》Windows x64版，已验证Steam版本25467846。
BepInEx 5.4.23.5 x64 已安装并初始化。
无需DLC。

兼容性

版本0.1.6已通过《守墓人2》Steam构建25467846（运行于Unity Mono）验证。构建25457344和演示版构建25344626仍受支持。后续游戏构建需要重新进行兼容性检查；模组可要求指定已知构建，当当前指纹未经验证时将保持禁用状态。

尚未验证与模组管理器的兼容性。手柄模式下的模组菜单路径和方向导航仍经过运行时测试。响应式界面路径也已在1600x900下经过运行时测试，并额外针对1366x768、1280x720、1920x1080和3840x2160进行了适配检查。实体控制器硬件不在自动化测试范围内。

安装

将 BepInEx 5.4.23.5 x64 安装到 Graveyard Keeper 2 文件夹中，然后启动游戏一次。
将此压缩包解压到游戏文件夹中，保留包含的
```
BepInEx/plugins/GK2.Framework.dll
```
路径。
启动游戏。A 模组按钮应出现在主菜单中；已安装的框架模组将在那里列出。

正在更新

关闭游戏并替换现有的

BepInEx/plugins/GK2.Framework.dll

现有的模组配置文件已保留。

卸载

关闭游戏。
删除
```
BepInEx/plugins/GK2.Framework.dll
```
.

框架本身不会修改存档数据。需要该框架的模组在移除后将停止加载；这些模组的配置文件及其所做的任何更改不会被自动移除。

已知限制

未来的游戏版本需要进行新的兼容性审核，之后已知版本的模组才能被视为已验证。
手柄模式的模组菜单打开路径和方向导航已通过运行时测试；实体手柄硬件的覆盖范围仍然有限。
由框架托管的窗口在较低分辨率下会自动缩小以适应安全区域。在0.1.6版本中，可选的手动缩放比例存储在
```
BepInEx/config/ru.superman4eg.gk2.framework.cfg
```
作为
```
窗口缩放百分比
```
(50-100)。
该框架不会下载、更新或热重载模组。
运行时禁用仅适用于明确支持并能正确撤销其更改的模组。
框架接口字符串目前使用英文回退；各个模组提供自己的显示文本。

故障排除

模组按钮未显示

检查

BepInEx/LogOutput.log

对于

框架就绪

确认BepInEx为x64 5.4.23.5版本，并且

GK2.Framework.dll

在里面

BepInEx/plugins

.

缺少一个模组或被标记为不兼容

在模组菜单中打开其详情，查看兼容性或依赖说明。报告问题时，请附上游戏版本、框架版本以及以下相关内容：

日志输出.log

.

模组/设置窗口太大

版本0.1.6会自动将框架托管的窗口适配到当前安全区域。自动适配无需配置。如果你想让窗口更小，请关闭游戏并编辑

BepInEx/config/ru.superman4eg.gk2.framework.cfg

，然后设置

窗口缩放百分比

将其设置为50到100之间的值。默认值100在必要时仍会自动降低以防止裁剪。

面向模组开发者

该归档包含一个常规硬依赖启动模板、一个经过测试的可选独立模组与框架桥接模板、入门指南以及公开 API 参考文档。可选集成让独立模组在没有 GK2 Mod Framework 的情况下仍能正常工作，同时在桥接和框架存在时于模组菜单中公开其元数据与设置。0.1 版本为预览版 API；1.0 之前的破坏性变更将会记录在文档中。

源代码： GitHub — GK2模组框架

制作人员

由SuperMan4eg创建。需要BepInEx 5.4.23.5及其捆绑的HarmonyX/MonoMod运行时。依据MIT许可证授权。Graveyard Keeper 2及其资源归各自所有者所有；本框架不分发任何游戏资源。

支持与社区