ModSettings 扩展版

ModSettings 扩展版

赛博朋克2077模组设置的布局扩展:可折叠分类、嵌套分区、分隔符、信息文本和实时显示/隐藏规则。它运行在模组设置之上,不替换任何内容。

[center][b][size=5]Mod Settings Expanded[/size][/b][/center]

一个为 [url=https://www.nexusmods.com/cyberpunk2077/mods/4885]Mod Settings[/url] 添加更丰富布局的框架:可折叠分类、嵌套分区、分隔线、信息文本,以及在你拨动开关的瞬间就会显示或隐藏的选项。它运行于 Mod Settings 之上,不替换任何内容。

[b]这是一个供其他模组使用的框架。[/b] 单独安装它不会产生任何变化;它只会影响支持它的模组的页面。如果你使用的某个模组将其列为前置或可选附加项,请安装它。

[center][line]
[b][size=4]面向玩家[/size][/b][/center]
[list]
[][b]可折叠的分类与分区[/b] - 冗长的设置页面可以折叠成可点击展开的分组。分组中还可以包含其他分组。[/]
[][b]实时显示 / 隐藏[/b] - 依赖某个开关的选项会在你拨动开关的瞬间出现或消失,无需点击 Apply 或重新打开菜单。[/]
[][b]更整洁的页面[/b] - 当分类中的所有内容都被隐藏时,分类标题也会消失;关闭主开关也会隐藏其下嵌套的所有内容。[/]
[][b]分隔线与信息文本[/b] - 模组可以在选项之间添加分隔线和简短说明。[/]
[][b]你的数值不会发生任何改变[/b] - 选项仍然是常规的 Mod Settings 选项。保存、Apply、Reset 和 Restore defaults 的工作方式与之前相同。[/]
[][b]对使用它的模组而言是可选的[/b] - 支持 Mod Settings Expanded 的模组在没有它的情况下仍可运行,显示为常规的扁平 Mod Settings 页面。[/]
[/list]
[center][line]
[b][size=4]面向模组作者[/size][/b][/center]

在单个 redscript 类中描述你的布局。Mod Settings Expanded 会自动找到它:无需 hooks,无需 imports。将其置于 [i]@if(ModuleExists("ModSettingsExpanded"))[/i] 之后,你的模组就能为未安装 Mod Settings Expanded 的玩家继续编译。

[code]@if(ModuleExists("ModSettingsExpanded"))
public class MyModSettingsLayout extends ModSettingsExpandedLayout {
public func OnRegister(r: ref<ModSettingsExpandedRegistry>) -> Void {
let cls: CName = n"MyMod.MyModConfig";
// collapsible category, shown only while "enableAdvanced" is on
r.Category(n"MyMod.advanced", n"My Mod", n"Advanced", MSECollapse.StartCollapsed);
r.VisibleWhen(n"MyMod.advanced", cls, n"enableAdvanced");
// titled, collapsible section inside it
r.Section(n"MyMod.hud", n"None", n"My Mod", n"Advanced", "HUD", MSECollapse.StartExpanded);
r.AddToSection(n"MyMod.hud", cls, [n"hudScale", n"hudOpacity"]);
r.InfoText(cls, n"enableAdvanced", MSEPosition.After, "Turn on to show the advanced options.");
}
}[/code]
可用元素:
[list]
[][b]Category[/b] - 注册一个 Mod Settings 分类,使其可折叠,并在为空时自动隐藏[/]
[][b]Section[/b] - 一组选项,可带标题或不带标题,可选可折叠,可嵌套[/]
[][b]VarSection[/b] - 以现有选项作为标题的分组;它会与该选项一同隐藏[/]
[][b]VisibleWhen / VarVisibleWhen[/b] - 仅在某个 Bool 开关开启时显示某个分组、分类或单个选项,并实时更新[/]
[][b]Dependency mode[/b] - 隐藏的选项要么消失,要么留在屏幕上变暗[/]
[][b]Separator[/b] 和 [b]InfoText[/b] - 放置在任何选项之前或之后[/]
[/list]
你现有的 [i]ModSettings.dependency[/i] 属性可以保持不变:它们对未安装 Mod Settings Expanded 的玩家仍然有效,而在你的某条规则生效的地方会被忽略。

[b][size=3]AGENTS.md - 集成指南(可选文件)[/size][/b]

[b]AGENTS.md[/b] 可选文件是面向模组作者的完整参考。玩家不需要它,它在游戏中也不起任何作用。它涵盖:
[list]
[]完整 API,包含每个函数、参数和枚举值[/]
[]布局规则:嵌套、排序、可见性与依赖关系的判定方式、展开/关闭状态[/]
[]如何保持集成的可选性,以及在安装了 Mod Settings Expanded 后可以关闭哪些 Mod Settings 的变通方案[/]
[]一个完整、真实的集成示例([i]Modular E3 Crosshair[/i])[/]
[]已知限制,以及面向想要参与 Mod Settings Expanded 本身开发的人的说明[/]
[/list]
它的编写方式使其既可作为供你阅读的文档,也可作为 AI 编码助手的指令。许多此类工具(Claude Code、Codex、Cursor 等)会自动读取 [i]AGENTS.md[/i] 文件。将其放在你的模组项目根目录,或将该文件指向你的助手,助手就能按照相同规则为你编写布局类。

[center][line]
[b][size=4]前置需求[/size][/b][/center]
[list]
[][url=https://www.nexusmods.com/cyberpunk2077/mods/2380]RED4ext[/url][/]
[][url=https://www.nexusmods.com/cyberpunk2077/mods/1511]redscript[/url][/]
[][url=https://www.nexusmods.com/cyberpunk2077/mods/7780]Codeware[/url][/]
[url=https://www.nexusmods.com/cyberpunk2077/mods/4885]Mod Settings[/url][/]
[
][url=https://www.nexusmods.com/cyberpunk2077/mods/4198]ArchiveXL[/url] [/]
[/list]
[center][line]
[b][size=4]安装[/size][/b][/center]

使用 Vortex 或 MO2 安装,或将压缩包解压到你的 Cyberpunk 2077 文件夹中,以便得到:

[code]r6/scripts/ModSettingsExpanded/
.reds[/code]
可选的 [b]AGENTS.md[/b] 文件不会安装到游戏中。模组作者需单独下载它,并与自己的项目放在一起(见 [i]面向模组作者[/i])。

[center][line]
[b][size=4]兼容性[/size][/b][/center]
[list]
[]不替换或编辑任何 Mod Settings 文件;Mod Settings 保留其自己的页面、按钮和保存功能。[/]
[]只有注册了布局的模组的页面会被改变。其他所有模组的页面看起来与之前完全一样。[/]
[]自行隐藏 Mod Settings 分类标题的模组,可能会与注册了相同分类的布局发生冲突。支持 Mod Settings Expanded 的模组应在它安装后关闭此类变通方案。[/]
[/list]
[center][line]
[b][size=4]已知限制[/size][/b][/center]
[list]
[]以选项作为标题的分区(VarSection)目前尚不能折叠。[/]
[]在页面打开时被隐藏、随后通过实时规则出现的选项,在你重新打开该模组的页面之前,悬停时不会显示其描述。[/]
[]折叠标记以 [b][+][/b] 和 [b][-][/b] 的形式显示在标题中。[/]
[/list]
[center][line]
[b][size=4]卸载[/size][/b][/center]

删除 [i]r6/scripts/ModSettingsExpanded[/i] 文件夹。支持它的模组将恢复到常规的 Mod Settings 页面。不会影响任何设置或存档数据。