《深海迷航2》模组设置

创作者: JustChaldea

已更新:2026-05-17 20:57:40

12KB

关于此 MOD

为《Subnautica 2》的设置菜单添加“模组”选项卡，供其他模组注册自身设置。依赖于此功能的模组必须安装。部分设置可跨存档保留，并无需重读存档即可实时生效。安装后，所有

安装

需要《深海迷航2》UE4SS增强模组 ——先安装那个。

获取最新内容 SN2模组设置-vX.Y.zip请将压缩包解压至《Subnautica 2》的安装根目录（即包含 《深海迷航2》 和 引擎\ 将其中的模组文件放置好后，启动游戏。模组文件最终会存放在 Subnautica2\Binaries\Win64\ue4ss\Mods\SN2ModSettings\.

单看这个不会有任何可见变化。只有在至少一个支持的模组注册了设置后，模组选项卡才会显示。

给模组开发者

SN2ModSettings 在游戏内设置界面新增了一个“模组”选项卡。你的模组需在 Lua 清单中放置相关配置。 SN2模组设置/注册/库房通过原版菜单所用的相同控件类来渲染UI：数字用滑块，布尔值用开关，且部分控件支持 启用者 添加一个主开关，以便其关联项可以变灰显示。

每个注册模组都会在“模组”标签页中拥有独立的版块。显示将字符串作为分节标题（样式与原版“显示”、“音频”等保持一致）。模组按字母顺序列出。名称因此启动顺序是固定的。描述当玩家聚焦某项设置（悬停或通过键盘/控制器操作）时，该字段会在右侧面板中显示。

用户更改设置时，新值将被保存 SN2ModSettings/保存/<你的模组>.lua 在约200毫秒内，你的模组读取该文件（启动时一次性读取或循环轮询）并实时应用更改，无需重新加载存档。
UE4SS 为每个 Lua 模组提供独立的隔离环境 _G因此，你无法通过全局变量在不同模组之间共享表格需要光盘是唯一可靠的途径。

文件布局

ue4ss/Mods/SN2ModSettings/
注册/
│ └── YourMod.lua   <- 加载时编写此文件
└── saved/
保存/
    └── YourMod.lua <- 库在此写入用户调整数值

正在编写你的清单

选择简短且稳定的名字该文件同时用于注册信息和存档数据，因此发布后重命名会导致用户已有的存档丢失。

本地 MANIFEST_PATH = "./ue4ss/Mods/SN2ModSettings/registrations/MyMod.lua"

local function write_text(path, body)
    local dir = path:match("(.*[/\\])")
本地目录 = path:match("(.*[/\\])")
    os.execute('mkdir "' .. dir:gsub("/", "\\") .. '" 2>nul')
    打开文件失败
    if not f then return false end
    f:写入(body)
    f:close()
    返回真
结束

本地清单 = [=[
{
return {
}
    name = "我的模组",
    display = "我的模组"
    settings = {
    ——此处应为等号后花括号内的具体键值对内容，但当前输入未提供具体键值数据，故无法生成完整翻译。  
    （示例假设内容，实际需根据输入的键值对翻译）  
    audio = { volume = 0.8 },  
    language = "zh-CN"  
}  
→  
设置 = {  
    音频 = { 音量 = 0.8 },  
    语言 = "简体中文"  
}
        { key="Enabled", title="启用模组" }
          描述="总开关。关闭后，下方的滑块将变灰。"
          type="toggle", 默认启用 },
        { key="Intensity", title="强度（%）" }
          描述="效果强度。"
          type="slider", 默认=1.0，最小值=0.0，最大值=2.0，步长=0.1
          enabled_by="已启用" }
    }
}
]=]

write_text(MANIFEST_PATH, manifest)

顶级清单键：

名称:内部标识符和存档基础文件名。简短稳定，发布后不可更改。
显示模组标签页的小节标题（例如：“消耗倍率”、“轻松合成”）
设置设置定义数组。

预设按键：

键保存文件中用作字段名的标识符。
标题: 小组件旁的标签，降级为钥匙若省略。
描述边栏显示此内容，用户专注于设置时可见。若无，则留空。
类型: 滑块或切换.
默认滑块用数字，开关用布尔值。请与Lua脚本中的默认值保持一致。
启用者 （可选）：另一项设定的键同一模组中。当该条件为假（开关关闭，或数值为零）时，此控件变灰并停止响应输入。

滑块也承受最小, 最大, 和步骤（例： 0.1 （精确到一位小数）。最小/最大值绘制在滑块轨道两端。

读取已保存数据

图书馆记录 `SN2ModSettings/saved/<your-mod>.lua` 每次设定变更时，每秒轮询一次，并在检测到变化时重新应用：

```lua
local Config = {
```
    启用 = true，-- 必须与清单默认值一致
    强度 = 1.0，
}

```lua
local function LoadSavedConfig()
    读取已保存设置()
```
    local f = io.open("./ue4ss/Mods/SN2ModSettings/saved/MyMod.lua", "r")
    if not f then return false end
    local content = f:read("*all")
    f:close()
    如果内容为空或不存在，则返回 false
    local loader = load(content)
    if not loader then return false end
    local ok, data = pcall(loader)
    如果失败或数据类型不是“表格”，则返回假

    local changed = false
    for k, v in pairs(data) do
        如果 Config[k] 不为空且不等于 v 时
            Config[k] = v
            changed = true
        结束
    结束
    已更改
结束

加载已保存配置()  -- 启动时获取持久化数据

循环异步(1000, function())
    ---
在游戏线程中执行(function()
)
        if LoadSavedConfig() then  
→ 若已加载存档配置
            [MyMod] 配置已变更，正在重新应用
            -- 套用设定：启用 / 强度 / 等
        结束
    结束)
结束)

支持的控件

当前：滑块和切换. 已规划但尚未接入： 组合框 （下拉菜单）按钮（动作触发） 收音机 （单选组）原版SN2设置已包含所有这些选项，因此底层控件类已存在。 按键绑定 由于它经过增强输入用户设置系统且流程较复杂，所以优先级较低。

中招了

默认值必须匹配 - 若用户尚未进行任何操作，存档文件可能尚未生成，且你的Lua脚本内设置默认站位。与清单对齐默认否则首次启动时可能出现异常行为。
已保存数值类型。 滑块数值以Lua数字返回，开关以布尔值返回。需要整数滑块？请自行取整。
由启用项决定（仅界面显示）。 滑块置灰会阻止用户拖拽，但不会改变模组从磁盘读取的内容。若总开关关闭，模组需自行限制行为。SN2-DrainRates的模式为：总开关关闭 → 将所有滑条数值强制设为默认1.0；总开关重新开启 → 从已保存的滑块数值恢复。
库会在数据发生变更时立即写入存档文件，但实际应用该变更则是模组的任务。具体到GAS属性，你需要使用 OnRep_<字段名> 聚合器刷新技巧——SN2-DrainRates有一个有效引用。若无此引用，GE捕获状态将保持停滞，你的改动仅在存档重载后才会生效。
发布后请勿重命名模组 - 名称此为存档文件密钥；更改后会导致所有用户的现有设置失效。