《深海迷航2》Mod Cnofig

《深海迷航2》Mod Cnofig会直接在游戏内置设置菜单中新增独立的模组专属分页，所有适配该框架的各类功能模组，都能自动将自身各项调节选项统一录入此页面之中。该配置框架支持多项设置数据跨游戏会话自动保存生效，多数参数修改后无需退出重进、不用重新读取存档即可实时应用，大幅简化玩家调试流程。

前置MOD

UE4SS - Subnautica 2>>>点击查看

安装方法

需要先安装《深海迷航 2》的 UE4SS。下载最新版本的 SN2ModSettings 压缩包。

对于手动安装，将其解压到 Subnautica2BinariesWin64ue4ssMods。最终模组会位于 ue4ssModsSN2ModSettings 中。

卸载步骤

直接删除文件夹即可。

Mod Cnofig说明

支持的控件类型

slider：滑块，用于数字。支持 min、max、step 和 format。

toggle：开关，用于布尔值。

keybind：按键绑定。用户点击后按下任意键，保存的值为字符串形式的 FKey 名称。

计划支持下拉框、按钮和单选按钮。

读取保存的值

每个设置都会镜像到一个以 SN2ModSettings/<你的模组>/<设置key> 为键的 UE4SS SharedVariable 中。该库会在启动时使用你的默认值预先设置好，因此第一次读取就能返回有效数据。

你可以在一个循环中读取 SharedVariable 并实时应用更改。

按键绑定使用方式

由于 UE4SS 没有暴露解绑函数，推荐在启动时为所有可能的按键注册一个处理函数。在处理函数中读取当前的配置，判断按下的键是否匹配主键或备选键。这样通过 UI 重新绑定快捷键可以立即生效，无需重启游戏。

注意事项

该库会在启动时为每个设置用你的默认值预先设置 SharedVariable。

enabled_by 仅影响 UI 控件的启用状态，你的模组仍需根据主开关的值来门控自身行为。

该库在设置更改时会立即写入保存文件，但应用更改是你的模组的职责。

发布后不要重命名你的模组 name，否则会使用户的已保存设置失效。

使用反馈

如果您在使用过程中出现错误或者希望有更多mod，欢迎在下方评论区反馈，感谢使用！