OSF设置 - 模组配置菜单 (MCM)

[center][img]https://staticdelivery.nexusmods.com/mods/4187/images/18326/18326-1790377925-122665089.png[/img][/center]

[center][size=5][b]模组设置、快捷键与问题反馈[/b][/size][/center]

[center][img]https://staticdelivery.nexusmods.com/mods/4187/images/18326/18326-1790377941-456716716.png[/img][/center] [b]OSF Settings[/b] 为支持的模组提供统一的游戏内菜单，用于配置、快捷键和问题反馈。

从暂停菜单打开 [b]MOD SETTINGS[/b]（模组设置）即可调整模组选项、管理快捷键（与游戏原版控制项并列显示），并查看警告或错误，其中包含模组作者针对你的设置问题提供的解决指导。

[quote]OSF Settings 以专用框架取代了原 OSF UI 中内置的设置功能。[b]不再需要 OSF UI。[/b]两个框架可以同时安装。如果你的某个模组依赖 OSF UI，请保留它[/quote] [center][img]https://staticdelivery.nexusmods.com/mods/4187/images/18326/18326-1790377942-1911880524.png[/img][/center] [list] [][b]模组配置：[/b]为每个支持的模组提供开关、滑块、下拉菜单、文本输入框和快捷键控件。[/] [][b]统一快捷键[/b]：在游戏原版按键绑定旁查看已注册的模组快捷键。可分配主副绑定、检测冲突并交换绑定。[/] [][b]模组问题[/b]：支持的模组可报告警告和错误，说明受影响的内容，并提供解决步骤。[/] [][b]操作按钮[/b]：运行模组提供的操作，如重新扫描文件或重建索引，可选确认提示。[/] [][b]翻译支持[/b]：翻译者可为模组设置页面提供即插即用的翻译文件。[/] [][b]存档安全：[/b]设置绝不会触及你的存档；所有修改均在内存中完成并保存到 json 文件。[/] [/list] [i]模组专属的设置、快捷键和问题报告需要各个模组自身提供支持。OSF Settings 不会自动为每个已安装的模组添加配置页面。[/i]

[center][img]https://staticdelivery.nexusmods.com/mods/4187/images/18326/18326-1790377945-1819771296.png[/img][/center] [b]前置需求[/b] [list] [][url=https://www.nexusmods.com/starfield/mods/106]Starfield Script Extender (SFSE)[/url][/] [][url=https://www.nexusmods.com/starfield/mods/3256]Address Library for SFSE Plugins[/url][/] [/list] 安装前置需求，然后使用 MO2 或 Vortex 安装并启用 OSF Settings。 [b]OSF Settings 无需激活任何 ESM 或 ESP。[/b]

通过 SFSE 启动 Starfield，加载存档，然后从暂停菜单选择 [b]MOD SETTINGS[/b] 或按 [font=Courier New]F10[/font]。 你可以在 OSF Settings 页面或 [b]KEYBINDINGS[/b]（快捷键）标签页中重新绑定打开键。

[b]存档中途安装与更新[/b] 安装或更新 OSF Settings 无需新建存档。

[b]设置存储位置[/b] 标准设置页面将用户值按模组保存为 JSON 文件，位于： [code]Documents/My Games/Starfield/OSF/Settings[/code] [b]这些设置为共享，而非按角色独立。[/b] 使用同一 Documents 文件夹的存档、模组管理器配置和游戏安装共享同一套设置。

已注册的快捷键绑定单独存储在 Starfield 的 [font=Courier New]ControlMap_Custom.txt[/font] 中。

[b][color=#6aa84f][size=4]模组作者[/size][/color][/b] [b]无需自己构建配置界面即可添加设置页面。[/b] 用 JSON 定义你的页面，然后通过 C++ 或 Papyrus 连接你的模组，以读取设置、处理快捷键并报告问题。 [list] [][b]设置[/b] — 读取和写入值，并订阅实时变更。[/] [][b]快捷键[/b] — 在 Starfield 原生按键绑定系统中注册可重新绑定的操作。在按键触发时接收回调，或直接打开已注册的菜单。[/] [][b]问题报告[/b] — 在 C++ 中使用 [font=Courier New]OSFSettings_Diagnostics.h[/font]，或在 Papyrus 中使用 [font=Courier New]OSFSettings.ReportIssue[/font]，向 Mod Issues 报告和清除问题。[/] [/list][b]最简 schema 示例[/b] [spoiler] 将你的 schema 置于： [code]Data/SFSE/Plugins/OSF/Settings/schemas/mymod.json[/code][code]{
"title": "My mod",
"groups": {
"General": [
{
"key": "enabled",
"type": "bool",
"label": "Enable feature",
"default": true
}
]
},
"hotkeys": {
"toggle": {
"label": "Toggle feature",
"default": "F6"
}
}
}[/code][/spoiler] 有关集成指南、示例和完整 schema 参考，请参阅 [url=https://github.com/ozooma10/osf-settings]GitHub[/url]。

[center][img]https://staticdelivery.nexusmods.com/mods/4187/images/18326/18326-1790378233-433933835.png[/img][/center]

[b]暂停菜单中没有 MOD SETTINGS。[/b] 确认你是通过 SFSE 启动的，且 SFSE 日志显示 [font=Courier New]OSFSettings.dll[/font] 已成功加载。

[b]已安装的模组没有设置页面。[/b] 设置页面需要该模组提供 schema 和集成。仅安装 OSF Settings 不会为不支持的模组添加页面。

[b]绑定页面中缺少某个快捷键。[/b] 只会列出已注册的模组快捷键。OSF Settings 无法发现模组私自实现的快捷键。

[b]Mod Issues 页面为空是否意味着没有问题？[/b] 不一定，Mod Issues 会显示支持模组报告的问题，以及加载失败的 schema。

[b]报告 bug[/b] 请包含发生了什么、复现步骤、你的 OSF Settings 版本，以及以下位置的 OSF Settings 和 SFSE 日志： [code]Documents/My Games/Starfield/SFSE/Logs[/code] [center][img]https://staticdelivery.nexusmods.com/mods/4187/images/18326/18326-1790378233-542053130.png[/img][/center] [list] [][b]ianpatt 和 SFSE 团队[/b] ([url=https://sfse.silverlock.org/]SFSE[/url])[/] [][b]CommonLibSF 贡献者[/b] ([url=https://github.com/libxse/commonlibsf]CommonLibSF[/url])[/] [][b]meh321[/b] ([url=https://www.nexusmods.com/starfield/mods/3256]Address Library[/url])[/] [/list] 源代码、作者指南和问题追踪器见 [url=https://github.com/ozooma10/osf-settings]GitHub[/url]。