模组设置同步

模组设置同步

Mod Settings的扩展:任意mod的可编辑预设,以及保持同步的菜单。

[size=5][b][i]ModSettingsSync[/i][/b][/size]
[i]Mod Settings 的扩展:可为任意模组编辑预设,以及一个保持同步的菜单。[/i]





[color=#3c78d8][size=4][b][i]面向玩家[/i][/b][/size][/color]
[b]ModSettingsSync 本身不执行任何操作。[/b]它不添加任何选项、任何菜单页面,也不会改变你的游戏。它是一个[toolbox],供[b]其他模组[/b]用来提供预设。

[b]我需要它吗?[/b]
[list]
[][b]需要[/b],如果你使用的某个模组在其需求中列出了 ModSettingsSync。[/]
[]否则[b]不需要[/b]。单独安装它无害,但你不会看到任何区别。[/]
[/list][b]在使用它的模组中你能获得:[/b]
[list]
[]其 Mod Settings 页面上有一个[b]预设选择器[/b]:选择一个预设,其所有选项会同时更改。[/]
[]选择器正下方有[b]保存[/b]和[b]重置[/b]按钮:按你的喜好调整预设,保存为你自己的版本,并随时恢复原始版本。支持鼠标和手柄。[/]
[]你保存的预设会在会话之间保留,并在模组更新后依然存在。[/]
[]如果该模组提供热键,你可以在游戏中切换预设,菜单会实时更新。[/]
[/list]

[color=#3c78d8][size=4][b][i]面向模组作者[/i][/b][/size][/color]
带保存/重置、持久化和实时 UI 同步的预设通常意味着编写自己的存储、自己的按钮,并与 Mod Settings 控件较劲。ModSettingsSync 为你完成所有这些:[b]一个类,大约二十行[/b]。




[b]@if(ModuleExists("ModSettingsSync"))
public class MyPresets extends PresetDefinition {
  public func ModName() -> CName { return n"My Mod"; }
  public func PresetVar() -> CName { return n"ActivePreset"; }
  public func ManagedVars() -> array<CName> { return [n"ShowHud", n"Volume"]; }

  public func Defaults(preset: Int32) -> Void {
    switch preset {
      case 0: this.SetBool(n"ShowHud", false); this.SetInt(n"Volume", 20); break;
      case 1: this.SetBool(n"ShowHud", true);  this.SetInt(n"Volume", 100); break;
      default: break;
    }
  }
}[/b]



就是这样。你能获得:
[list]
[][b]零 UI 代码[/b]:保存和重置按钮会注入到你的选择器下方,并在没有可保存或重置的内容时自动置灰。支持鼠标和手柄。[/]
[][b]无需在你的模组中做任何改动[/b]:预设值会真正写入 Mod Settings,因此你现有的配置读取会立即看到当前预设。[/]
[][b]可选依赖[/b]:用 [font=Courier New]@if(ModuleExists("ModSettingsSync"))[/font] 保护你的预设代码,你的模组在没有它的情况下仍能编译和运行。[/]
[][b]防更新[/b]:选择预设时,会先应用你的默认值,再叠加玩家保存的版本,因此你之后添加的选项会获得其默认值。[/]
[][b]为所有人提供实时控件同步[/b]:当任何 Mod Settings 值从脚本更改时,开关、滑块和列表会在屏幕上刷新。无需设置。[/]
[][b]游戏内 API[/b]:[font=Courier New]Presets.Get / Set / Next / Notify[/font],用于从你自己的热键(通过 Input Loader)切换预设。[/]
[][b]持久化已处理[/b]:Codeware 持久化存储,并在安装了 RedFileSystem 时立即写入磁盘。日志可帮助你调试。[/]
[]可选的[b]自定义[/b]预设,会记住玩家的自由设置。[/]
[/list][b]Modder resources[/b] 文件(Optional Files)包含完整的 README(分步指南、API 参考、已知陷阱)以及两个可直接安装的示例模组:一个最小示例和一个完整示例。



[i][color=#3c78d8][size=4][b]需求[/b][/size][/color][/i]
[list]
[][url=https://www.nexusmods.com/cyberpunk2077/mods/4885]Mod Settings[/url](必需)[/]
[][url=https://github.com/psiberx/cp2077-codeware][/url][url=https://www.nexusmods.com/cyberpunk2077/mods/7780]Codeware[/url](必需)[/]
[][url=https://www.nexusmods.com/cyberpunk2077/mods/13378]RedFileSystem[/url](可选,推荐):立即将预设保存到磁盘,因此它们能在崩溃后保留。[/]
[/list]已在 Cyberpunk 2077 2.31、Mod Settings 0.2.21、Codeware 1.20.3 和 RedFileSystem 0.15.1 上测试。



[i][color=#3c78d8][size=4][b]安装[/b][/size][/color][/i]
使用 Vortex 安装,或将压缩包解压到你的 Cyberpunk 2077 文件夹中。



[i][color=#3c78d8][size=4][b]已知限制[/b][/size][/color][/i]
[list]
[]Mod Settings 菜单底部的自带“Reset”按钮会恢复[b]默认值[/b],而不是你上次保存的值。这是 Mod Settings 的行为,不是 ModSettingsSync 的。[/]
[]如果没有 RedFileSystem,在会话期间保存的预设如果会话以崩溃结束,将会丢失。[/]
[/list]
[color=#3c78d8][size=4][b][i]致谢[/i][/b][/size][/color]
[b]jackhumbert[/b] 制作了 Mod Settings 
[b]psiberx[/b] 制作了 Codeware 
[b]rayshader[/b] 制作了 RedFileSystem