重新映射ID

重新映射ID

在运行时重定向物品、方块、实体、流体、标签、配方和战利品表ID到替代ID

RemapIDs

将任意物品、方块、流体或实体ID重映射为另一ID:数据驱动,零配置代码。

RemapIDs 是一个面向整合包开发者的实用模组,让你通过简单的 JSON 文件在整个游戏过程中重定向注册表 ID。统一不同模组中的重复矿石、替换废弃物品,或在模组版本间迁移世界……全部无需编写一行代码。

Wiki: https://tysontheember.dev/remapids/

功能

注册表重映射 支持以下 7 种注册表类型的重映射:

  • 方块、物品、流体、实体类型
  • 标签、合成配方、战利品表

重映射会深度应用:合成配方、战利品表、标签、物品栏和容器中的 NBT 数据都会自动重写。

数据驱动配置 将 JSON 文件放入 config/remapids/remaps/ 即可完成:

{
  "remaps": [
    {
      "source": "iceandfire:silver_ingot",
      "target": "othermod:silver_ingot",
      "types": ["item", "recipe", "loot_table"]
    }
  ]
}

通配符模式 通过单条规则批量重映射整类物品:

{
  "source": "iceandfire:silver_*",
  "target": "othermod:silver_*"
}

标签转物品合成配方转换 将合成配方中的标签原料替换为指定物品:

{
  "source": "#forge:ingots/silver",
  "target": "othermod:silver_ingot",
  "types": ["recipe"]
}

智能链式解析 如果 A 重映射到 B,且 B 重映射到 C,模组会自动将其扁平化为 A→C。循环依赖会被检测并拒绝。

实时重载 标签、合成配方和战利品表的重映射会在 /reload 后重新应用——无需重启。

零运行时开销 方块、物品、流体和实体的重映射在启动时作为注册表别名应用。此后没有性能开销。

支持的版本

Minecraft 加载器
1.20.1 Forge
1.20.1 Fabric
1.21.1 NeoForge
1.21.1 Fabric

应用场景

  • 矿石统一:将来自 5 个不同模组的所有银锭重定向到一个规范 ID
  • 模组迁移:用替代品替换已移除模组的物品,且不破坏现有世界
  • 战利品/合成配方清理:重写战利品表和合成配方以使用你想要的物品
  • 世界升级:物品栏和容器中的物品在加载时通过 NBT 进行重映射

快速开始

  1. 为你的加载器安装模组
  2. 如果 config/remapids/remaps/ 不存在,则创建它
  3. 根据重映射定义添加任意数量的 .json 文件
  4. 启动游戏,重映射会自动应用