Another Config Manager

Another Config Manager

Another Config Manager 是一款配置浏览器和编辑器。你可以浏览所有带有配置的模组，深入各个分区，使用合适的控件编辑数值，并在准备好后再保存。

它还为字符串列表添加了 CSV 表格，为颜色值添加了 HSV 颜色选择器；其他模组也可以注册自己的表格布局和颜色格式。

它有什么功能？

• 添加可搜索的模组配置浏览器，列出所有已加载且注册了 NeoForge 配置的模组，并显示模组图标。
• 按类型（客户端、通用、服务器、启动）分组显示各模组的配置，并可浏览分区树。
• 将所有编辑内容保存在缓冲区中。按下保存之前，不会将任何内容写入磁盘。
• 如果你尝试在有未保存更改时离开，会提示你选择保存 / 放弃 / 取消。
• 为没有配置界面的模组提供配置界面：未安装 Configured 时，ACM 会为任何拥有 NeoForge 配置且没有现有配置界面的模组注册自己的界面，让模组列表中的配置按钮也能用于这些模组。

配置编辑器

• 分区导航带有面包屑路径，并提供返回和返回列表按钮。
• 搜索框：优先显示当前分区中的匹配项，其后显示嵌套子菜单中匹配的数值和分区。
• 将注释作为工具提示：将鼠标悬停在数值上即可查看配置注释。
• 易读名称：像 maxItemsPerTick 这样的原始键名会显示为 "每刻最大物品数"（模组可以提供翻译后的名称，详见开发者指南）。
• 按类型提供控件：
  • 布尔值：开/关切换
  • 枚举：点击即可循环切换各个值
  • 数字和字符串：带验证功能的数值编辑器
  • 列表：列表编辑器（或 CSV 表格，见下文）
• 已修改的数值会以 * 标记并高亮显示。与默认值不同的数值会显示 默认值：… 提示。
• 可将数值还原为打开配置时的值，或重置为默认值。全部重置会重置整个配置。
• 访问规则：客户端、通用和启动配置始终可以打开。只有在你创建了世界（单人游戏 / 集成服务器）且拥有 2 级权限时，才能编辑服务器配置。

字符串列表的 CSV 表格

许多模组会在字符串列表中存储类似 minecraft:iron_ore;FFAA00 的行。ACM 可以将它们作为表格编辑：

• 电子表格风格的编辑器，提供命名或编号的列标题、单元格编辑框和设置单元格功能。
• 使用标题图标插入、移动和删除列。使用行图标添加或移除行。
• 可在表格内搜索，并使用水平滚动条浏览宽表格。
• 提供列表视图 / CSV 视图切换：随时编辑原始字符串，同时保留 CSV 规则。
• 可对任意普通字符串列表使用声明为 CSV：选择分隔符（1–8 个字符），ACM 会创建编号列规则并将其保存在自己的配置中。
• 颜色列可直接从选中的单元格打开颜色选择器。

颜色编辑器

• HSV 颜色选择器：饱和度/明度方块、色相条、可选的 Alpha 条、颜色预览色块，以及原版颜色调色板。
• Hex 输入框，以及用于输入精确数值的 R / G / B / (A) 数值框。
• 对单个值使用 声明颜色：字符串值会以十六进制形式存储，取值范围为 0–255 的整数值会以打包的 ARGB 形式存储。
• 颜色通道模式（Color ch. [3|4]）：选择 3 或 4 个取值范围为 0–255 的同级数值，将它们分别指定为 R/G/B/(A)，然后在同一个选择器中一起编辑。

命令与模组列表集成

浏览器中还有用于打开模组文件夹和 NeoForge 模组列表的按钮。

整合包制作者

ACM 自身的配置（another_config_manager-common.toml）包含：

因此，你可以在游戏中为任意模组的配置添加 CSV 或颜色编辑功能，并将设置结果随整合包一并发布。

开发者指南

ACM 无需编写任何代码即可工作：所有 ModConfigSpec 配置都会自动识别。集成是可选的，可用于自定义配置的外观和编辑方式。

依赖项

在你的 neoforge.mods.toml 中声明 ACM：

[[dependencies.yourmodid]]
    modId="another_config_manager"
    type="required"
    versionRange="[1.0.0.0.0,)"
    ordering="NONE"
    side="BOTH"

然后将 ACM jar 添加到编译类路径中。

始终使用 ACM 编辑器

标记你的模组，让 ACM 始终为其注册界面（即使已安装 Configured）：

[modproperties.yourmodid]
another_config_manager=true

运行时也可以调用 ConfigOpener.claim("yourmodid")。

注册 CSV 规则

为字符串列表注册默认表格布局（包 net.unfamily.anotherconfigmanager.config）：

CsvRuleRegistry.register("yourmodid", "scanner.ore_entries",
        ";yourmodid:scanner/ore_entries;0=yourmodid.config.csv.key;type:color_hex:order=rgb:prefix=none;1=yourmodid.config.csv.color");

• 规则格式：{sep}[rulePath]{sep}{colDef}{sep}{colDef}...（第一个字符是分隔符）。
• 列定义：0、0=lang.key、0-3、0-3=lang.key、2+、2+=lang.key，以及 0-3$（仅显示已声明的列）。
• 可选的类型化单元格：在列前添加 type:color_hex:order=rgb:prefix=none;（或 color_int_packed），即可为该列启用颜色选择器。
• 重载方法接受 ModConfig.Type（默认值为 COMMON）或 List<String> 路径。
• 无需编写 Java 代码，只需在值的注释中添加一行 iska_csv:<rule>。

注册颜色规则

ColorRuleRegistry.register("yourmodid", ModConfig.Type.COMMON, "scanner.default_color", "hex;rgb;prefix=none");

• 格式：storage;order[;prefix=…][;case=upper|lower][;scale=…]
• storage：hex（字符串）或 int（打包整数）。order：rgb / argb 的任意排列。

在代码中注册的规则是默认值。ACM 的 csv_manager / color_manager 中的条目会覆盖这些默认值。

通过代码打开界面

• ConfigOpener.open("yourmodid")：在客户端打开你的配置界面。
• ConfigOpener.open("yourmodid", ModConfig.Type.CLIENT)：打开指定类型的配置界面。
• ConfigOpener.openModBrowser()：打开模组配置浏览器。