GK2MOD框架——基于BepInEx的《守墓人2》代码MOD框架，内置游戏内MOD菜单、通用设置界面、依赖检测与兼容性校验功能（2026-10-21更新）

鼓掌之间

转自：https://www.nexusmods.com/graveyardkeeper2/mods/42

前置要求

BepInEx v5.4.23.5：https://github.com/BepInEx/BepInEx/releases/tag/v5.4.23.5

简介

GK2MOD框架是为《守墓人2》代码MOD提供的通用BepInEx基础框架。它新增了游戏内MOD菜单、通用设置界面、兼容性报告、依赖检测与安全生命周期钩子，本身不会修改任何游戏玩法。

特性

- 风格贴合原版的MOD菜单，可从主菜单与游戏内ESC/暂停菜单中打开。
- 选中的MOD条目与其启用/禁用、设置控件之间的手柄导航逻辑清晰明确。
- 整数与浮点滑块均配备精确数值输入框，可直接输入99这类具体数值，无需在大范围滑块上反复调整。
- 便携版压缩包适配Linux/Steam Proton解压权限：目录权限0755，普通文件权限0644。
- 自动生成设置界面，支持开关、数值滑块、下拉菜单、按键绑定、文本与只读数值。
- 框架自带文本采用UTF-8 JSON本地化格式，集成MOD可选择接入本地化功能。
- 框架内置完整的英语、俄语、韩语界面文本。
- 对应语言环境下，框架生成的界面会自动调用游戏原生的韩语、日语、中文字体资源。
- 切换游戏语言后，框架自带的MOD与设置界面无需重启即可同步更新语言。
- MOD窗口与框架托管的MOD设置页面支持安全区域自适应适配。
- 专属的框架设置齿轮按钮，可在50%-100%范围内调节窗口缩放比例。
- MOD元数据、依赖检测、启用状态与兼容性详情集中展示。
- 内置版本指纹识别，需要在非相关游戏更新后仍稳定运行的MOD，可选择开启定向结构兼容性校验。
- 为MOD开发者提供文档完善的API、强依赖起步模板，以及可选的独立MOD+桥接集成模板。
- 基于BepInEx与HarmonyX开发，无需额外引入其他DLL加载器。
- 本框架是一款依赖组件与开发基础工具，本身不新增任何游戏玩法内容。

运行要求

- Windows 64位版《守墓人2》。已验证的完整程序集指纹包括Steam版本25506711；框架0.1.11版本的未知版本兼容路径，也在25509347版本上通过了运行时测试。
- 已安装并初始化64位版BepInEx 5.4.23.5。
- 无需任何DLC。

兼容性说明

0.1.11版本为后续游戏更新采用了更稳妥的兼容模式。框架仍会将未知完整程序集指纹标记为“未知版本”，但集成MOD可以自行校验其依赖的游戏方法、字段、常量与调用路径，主动确认对应当前版本的兼容性。该机制已在Steam 25509347版本上通过运行时测试：该版本的Assembly-CSharp哈希值发生变化，但反编译后的游戏C#代码与25506711版本完全一致。经过验证的调整包与超宽屏版本可正常兼容运行，而一款未做验证的旧版严格超宽屏MOD仍显示为“未知版本”。

0.1.12版本还修复了0.1.11版本后用户反馈的四个问题：适配Linux/Steam Proton解压的Unix便携版压缩包权限、清晰的列表到详情页手柄导航逻辑、游戏内ESC/暂停菜单新增MOD入口、整数/浮点滑块旁新增精确数值输入框。精确输入相关的运行时测试覆盖了直接数值输入、滑块同步、列表→控件→列表的导航逻辑，以及暂停→MOD→返回暂停菜单的操作流程。

本框架与MOD管理器的兼容性尚未验证。手柄模式下的MOD菜单入口与方向导航均通过运行时测试。响应式界面在1600×900分辨率下通过测试，同时额外验证了1366×768、1280×720、1920×1080与3840×2160分辨率的适配效果。实体手柄硬件与Proton环境下的完整游戏流程不在自动化测试范围内。

安装说明

1. 将64位版BepInEx 5.4.23.5安装到《守墓人2》游戏目录，启动一次游戏。
2. 将本压缩包解压至游戏目录，保留内置的BepInEx/plugins/GK2.Framework.dll路径结构。
3. 启动游戏。主菜单中会出现“MOD”按钮。0.1.12及以上版本中，游戏内ESC/暂停菜单也会加入MOD入口。

更新说明

关闭游戏，将完整的新版压缩包解压至游戏目录，覆盖已有的框架文件。从0.1.8版本起，本地化文件也会安装在BepInEx/plugins/GK2.Framework/Localization路径下，因此仅替换DLL文件无法完成更新。已有的MOD配置文件会被保留。

卸载说明

1. 关闭游戏。
2. 删除BepInEx/plugins/GK2.Framework.dll文件与BepInEx/plugins/GK2.Framework文件夹。

框架本身不会修改存档数据。依赖本框架的MOD在卸载后会停止加载；它们的配置文件以及MOD做出的所有修改不会被自动删除。

已知限制

- 未来的游戏版本暂未全局验证。使用0.1.11定向兼容API的MOD，只有通过自身的结构契约校验才能继续运行；未开启该校验的MOD会默认停止加载。
- 手柄模式下的MOD菜单入口与方向导航通过运行时测试；实体手柄硬件的适配覆盖范围仍有限。
- 低分辨率下，框架托管的窗口会自动缩小以适配安全区域。可在“MOD→框架设置”中手动调节缩放比例，设置保存在BepInEx/config/ru.superman4eg.gk2.framework.cfg文件中。
- 框架不具备MOD下载、更新与热重载功能。
- 仅支持显式兼容运行时禁用、且能正确还原修改的MOD，才能在运行时关闭。
- 英语始终作为完整的备用语言。可通过UTF-8 JSON语言文件为框架补充更多翻译。切换游戏语言后，框架自带界面会更新翻译文本与对应原生字体。第三方MOD的元数据、设置界面及自定义界面的本地化，由各MOD自行负责。

故障排查

“MOD”按钮未显示

查看BepInEx/LogOutput.log中是否有GK2_FRAMEWORK_READY标识。确认BepInEx为64位5.4.23.5版本，且GK2.Framework.dll位于BepInEx/plugins文件夹内。

MOD列表为空或某个MOD未显示

列表仅显示向GK2MOD框架注册的MOD。独立的BepInExMOD仍可正常运行，但不会出现在列表中，除非安装了适配框架的版本或是可选的框架桥接插件。查看BepInEx/LogOutput.log中是否有“已注册GK2MOD[]”的记录。如果某个插件没有对应记录，说明加载的版本未集成框架适配。如果MOD已注册但仍未显示，反馈时请附上游戏版本、框架版本与相关日志片段。

MOD/设置窗口过大

框架托管的窗口会自动适配当前安全区域，无需额外配置。如果想要更小的窗口，打开“MOD→框架设置”，将窗口缩放比例从100%调低至50%即可，修改即时生效。默认的100%比例也会在必要时自动缩小，避免内容超出屏幕。

致MOD开发者

压缩包内包含标准强依赖起步模板、经过测试的可选独立MOD+框架桥接模板、入门指南与公开API参考。可选集成模式下，独立MOD在没有GK2MOD框架时也能正常运行；当安装了桥接插件与框架后，其元数据与设置会显示在MOD菜单中。从0.1.8版本起，集成MOD可选择接入通用UTF-8 JSON本地化；0.1.9及以上版本的框架，自带界面会调用游戏原生的中日韩TMP字体。从0.1.11版本起，严格适配的MOD可校验自身的游戏端契约，调用ConfirmCurrentBuildCompatibility(...)方法，这样非相关的游戏更新不会仅因为Assembly-CSharp整体哈希变化就导致MOD失效。0.1版本为预览版API；1.0版本之前的破坏性变更都会出具文档说明。

源代码：GitHub — GK2 Mod Framework：https://github.com/SuperMan4eg/GK2-Mod-Framework

下载地址：

游客，如果您要查看本帖隐藏内容请回复

银色小骑骑

111111111111111111111111

wdassd

1111111111111

yukikana940

谢谢大佬，很需要了

253125888

原来这样啊

．·柒夜㎡

GK2MOD框架——基于BepInEx的《守墓人2》代码MOD框架，内置游戏内MOD菜单、通用设置界面、依赖检测与兼容性校验功能

离不开好

楼主一生平安！好人一生平安！厉害了！先收藏，再回复！谢谢！

zhanwuxuanyuan

强强强强

wapun

RE: GK2MOD框架——基于BepInEx的《守墓人2》代码MOD框架，内置游戏内MOD菜单、通用设置界面、依赖检测与兼容性校验功能 [[url=]修改[/url]]

a1140337439

紫薯布丁

°今昔⌒

youmeiyouqianzhimod

a13863957784

666666666666

gemini165038

1111111111111111

yan1768

666666666666666666

max1866

谢谢分享谢谢分享谢谢分享

chen1216

666666666666

帝梦

谢谢分享

地狱笨笨

十分感谢分享！

o0money0o

太好了！！！！！！！！！！！！

jonlei

6666666666666666666666666

鼓掌之间

2026-09-27更新

qwer123.x

666666666666666666666666666

a6954712

zls957258012

感谢分享

monefire

66666666666666

m”颓废﹎

谢谢分享

oメ(_鈊(_亂o

zhichi!!!!!!!!!

luoshui000

ddddddddddddddddddd

yolanda23456

66666666666666666

dfxaa753

压缩包内包含标准强依赖起步模板、经过测试的可选独立MOD+框架桥接模板、入门指南与公开API参考。可选集成模式下，独立MOD在没有GK2MOD框架时也能正常运行；当安装了桥接插件与框架后，其元数据与设置会显示在MOD菜单中。从0.1.8版本起，集成MOD可选择接入通用UTF-8 JSON本地化；0.1.9及以上版本的框架，自带界面会调用游戏原生的中日韩TMP字体。从0.1.11版本起，严格适配的MOD可校验自身的游戏端契约，调用ConfirmCurrentBuildCompatibility(...)方法，这样非相关的游戏更新不会仅因为Assembly-CSharp整体哈希变化就导致MOD失效。0.1版本为预览版API；1.0版本之前的破坏性变更都会出具文档说明。