卡米纳的统一

卡米纳的统一

自动将不同模组间的重复物品统一映射,而不移除注册表定义的物品统一模组

Kamina's Unified 是一个物品统一模组,它会在不同模组之间映射重复物品,而不会移除物品或更改注册表定义。它为每个分组指定一个主物品,并将所有其他条目视为可替换的重复项。

统一机制

物品根据优先级被分为主条目和重复条目:

iron_ingots = minecraft:iron_ingot, mekanism:ingot_iron, thermal:iron_ingot

在此示例中,minecraft:iron_ingot 是主物品。顺序很重要:第一个可用且已注册的物品 ID 会成为主物品。如果第一个 ID 不可用,模组会跳过它并检查下一个条目。

适用范围

  • 物品栏与世界掉落物: 世界中的物品在生成时会被转换。玩家物品栏会在登录和拾取物品时被检查。物品数量和组件数据会被保留。容器内容和已装备物品不会被自动修改。
  • 配方: 服务端 RecipeManager 中的有序配方和无序配方会被重建。重复的原料会被替换为主物品,重复的配方产物会被转换为主物品,同时保留堆叠数量和组件。其他配方类型利用 Ingredient 钩子和受支持的产物装配管线。自定义机器配方引擎可能需要专用适配器。
  • 创造模式: 重复项会通过 BuildCreativeModeTabContentsEvent 从标准创造模式标签页中过滤掉。SEARCH 标签页保持不变。
  • JEI 集成: 如果安装了 Just Enough Items (JEI),专用插件会从物品列表和搜索结果中隐藏重复项。JEI 为可选依赖。

配置

主配置文件:config/kaminas_unified-local.toml

[automatic]
scan = true
unification = true
tag_search = ["c:ores/*", "c:ingots/*", "c:dusts/*", "c:plates/*", "c:gears/*"]
mod_priority = ["minecraft", "mekanism", "thermal", "techreborn"]

[manual_unification]
groups = [
    "iron_ores = minecraft:iron_ore, mekanism:iron_ore",
    "iron_ingots = minecraft:iron_ingot, mekanism:ingot_iron, thermal:iron_ingot"
]
  • automatic.scan: 启用后在服务器启动时对相似物品执行一次启发式扫描。发现的建议会追加到自动生成的数据文件中。
  • automatic.unification: 启用自动分组(基于标签的分组和已保存的自动分组)的应用。如果禁用,手动分组仍保持生效。
  • automatic.tag_search: 指定用于自动分组评估的物品标签。尾部斜杠匹配嵌套路径(例如 c:ores/ 匹配 c:ores/iron 和 c:ores/copper)。
  • automatic.mod_priority: 设置在自动生成的分组中分配主物品时的命名空间优先级。
  • manual_unification.groups: 显式分组列表,格式为 "name = primary_ID, duplicate_ID, duplicate_ID"。手动分组优先于自动分组。

数据文件:config/kaminas-unified-auto.toml 存储自动生成的建议和由扫描器创建的分组。列出的第一个 ID 作为主物品。

命令

  • /dkid 或 /dkid hand – 显示主手中物品的 ID 和标签。点击可复制。
  • /dkid inventory – 复制玩家物品栏中所有已占用槽位的 ID。
  • /dkid hotbar – 复制快捷栏中所有物品的 ID。
  • /dkid rescan – 触发自动重新扫描(需要 OP 等级 2)。
  • /dkid help – 显示命令帮助。

运行 /reload 或更改配置会重新加载分组定义并更新映射,而不会触发完整重新扫描。使用 /dkid rescan 扫描新条目。

社区与支持

如需报告错误、提问或一般性讨论,请加入我们团队的 Discord 服务器: https://discord.gg/3pKHUrmXF