MIReplacer - (Requires MMOItems) - MIReplacer - 自动替换MMO物品插件

💡简介

MIReplacer 是一款 MMOItems 的扩展插件，能够自动将原版物品转换为配置好的 MMOItem 物品。所有转换均在玩家合成、熔炼、拾取物品等过程中自动完成。

🎮支持的转换事件

当前支持在以下事件发生时自动转换物品，所有事件均可独立启用或禁用：

• 当物品被合成时。
• 当物品被熔炼时。
• 当物品被拾取时。
• 当箱子被打开时。
• 当物品在背包内移动时。

🎮配置说明

默认配置文件提供了一个使用默认 MMOItem 物品和部分原版物品的示例。

主要选项

• cacheConfig: 设置为 true 时，将整个配置缓存到内存中以提升性能。强烈建议启用。如果配置非常庞大，可能会占用较多内存。注意：如果设置为 false，部分功能可能无法正常工作或完全失效，仅当插件造成严重卡顿时才考虑禁用。
• worldList: 指定 MIReplacer 生效的世界列表。留空 [] 则在服务器所有世界生效。示例：["world", "world_nether"]
• keepEnchantments: 转换后的物品是否保留原物品的附魔。
• keepCustomNames: 转换后的物品是否保留原物品的自定义名称。
• previewItemName: 在合成预览中，随机物品的显示名称。支持颜色代码。
• previewItemIndex: 预览时，每个可能物品的显示格式。{itemname} 会被替换为具体物品名。
• craftingLorePreview: 预览物品时显示的 Lore。设为 [] 可禁用此功能。

转换事件开关

• pickup: 拾取物品时转换。
• craft: 在工作台合成时转换。
• smelt: 在熔炉（1.14+ 包括高炉和烟熏炉）熔炼时转换。重要：修改此配置后必须重启服务器才能生效。
• chest: 打开箱子时转换。此效果对每个独立的箱子/矿车仅生效一次（服务器重启后重置）。
• inventory-change: 物品在背包内移动时转换。此事件调用非常频繁，可能不适合大型服务器。通常无需启用，建议保持关闭。

物品转换规则

在 ConversionItems 部分配置具体的转换规则。左侧为原版物品ID，右侧为对应的 MMOItem 类型与ID。

基础转换示例

ConversionItems:
  BRICK: MATERIAL.STEEL_INGOT
  IRON_SWORD: SWORD.CUTLASS
  DIAMOND_SWORD: SWORD.FALCON_BLADE

此配置会将所有砖块转为钢锭，所有铁剑转为弯刀，所有钻石剑转为猎鹰之刃。

覆盖全局设置

可以为单个物品设置独立的 keepEnchantments 或 keepCustomNames 选项，覆盖全局设置。

ConversionItems:
  GOLD_NUGGET:
    item: MISCELLANEOUS.GOLD_COIN
    keepEnchantments: false
    # keepCustomNames: false  # 同样可以单独设置

随机权重转换

可以配置一个权重列表，使转换结果随机。权重越高，被选中的概率越大。

ConversionItems:
  IRON_AXE:
    1:
      item: AXE.BUTCHER_AXE
      weight: 5
    2:
      item: AXE.BONE_CRACKER
      weight: 5
    3:
      item: AXE.SKULL_BREAKER
      weight: 2

此配置下，铁斧将有较高概率转为屠夫之斧或碎骨者，较低概率转为碎颅者。

❓注意事项与提示

• 修改熔炼相关配置后，必须重启服务器才能生效。
• inventory-change 事件对性能影响较大，非必要请勿启用。
• 从 2.0 版本开始，可以为每个转换物品单独设置 keepEnchantments 和 keepCustomNames。
• 配置项的顺序有时会影响最终结果，请确保最终配置是你期望的。

🔧支持与捐赠

如果喜欢这个插件，请考虑捐赠！您的支持将极大地帮助插件的维护与后续开发。

需要帮助？请加入支持 Discord 服务器。