跳到正文

Legacy Item Purger

作者:Raffman180

移除模组后,替换或清除世界中遗留的物品、方块和结构。

收藏

截图

介绍

介绍由机器翻译自 CurseForge 原页面,仅供参考。

旧物品清理器

移除模组后清理世界,同时保住你的装备。

你从整合包里移除了几个模组,或者把世界迁移到了缺少某些模组的新整合包。现在日志里满是未知物品报错,箱子里出现空位,你辛苦打来的 Boss 武器也不见了。旧物品清理器会在世界加载时修复存档数据;你还可以选择把缺失的武器、盔甲和其他列出的物品替换成仍然可用的物品。

测试版。 这是首个公开版本,会修改存档中的世界数据。请务必先备份世界,并在副本上测试。

功能说明

  • 在游戏尝试解码物品之前,查找箱子和其他容器、嵌套的模组物品栏(背包、存储模组)、玩家物品栏、末影箱和实体中,所属模组已不再安装的物品。
  • 根据所选模式,替换这些物品,或将其移除。
  • 将存档区块中的缺失方块替换为空气,并移除遗留的方块实体和方块刻。
  • 移除对已不存在结构的引用。
  • 移除未知实体属性,并迁移简单的旧版流体数据。
  • 清除会导致 "Item must not be minecraft:air" 错误的无效 minecraft:air 物品堆叠。
  • 报告所有问题,包括维度、位置、槽位、物品 ID 和原因。
  • 默认以预览模式启动。设置 dryRun = false 之前不会修改任何内容。

本模组没有针对特定模组的硬编码规则:如果某物品的 ID 不在当前安装环境的物品注册表中,它就会被视为“缺失”。

两种模式

在 mode 中设置 config/legacyitempurger-common.toml,或使用 /legacyitempurger mode <replace|remove>。

mode = "replace"(默认) mode = "remove"
缺失的武器和盔甲 替换为合适的物品;保留名称和附魔 移除
表格中列出的其他缺失物品(食物、作物、方块物品、杂项) 替换;保留数量和名称 移除
所有其他缺失物品 移除 移除
缺失的方块、结构、属性和流体 清理 清理
适用场景 希望玩家保留进度的世界 简单、可预期的清理

替换方式

  1. 你自己的映射 优先使用。
  2. 然后使用内置表格(见下方“内置替换表”)。
  3. 接着使用关键词推断规则,为未知模组的武器和盔甲进行替换(..._sword、katana、battleaxe、longbow、helm、greaves……以及 diamond 或 netherite 等等级词)。
  4. 没有可用替换物的物品会被移除。

被替换的武器和盔甲会保留自定义名称,以及所有仍然存在的附魔。模组专属数据和耐久损耗会被丢弃。每件替换物品都会添加一行描述旧物品的 lore,以及一个隐藏标记(minecraft:custom_data,其中包含原物品 ID),方便之后识别。

目标链:优先模组物品,原版物品作为后备

一个替换项可以按顺序指定多个目标。第一个已安装的目标会生效。

{ "from": "oldmod:fire_sword", "to": ["newmod:fire_sword", "minecraft:netherite_sword"], "kind": "weapon" }
weaponReplacements = ["oldmod:fire_sword=newmod:fire_sword|minecraft:netherite_sword"]
itemReplacements = ["oldmod:cheese_wheel=newmod:cheese|minecraft:bread"]

如果你想使用模组物品作为替换目标,请在清理前先将这些替换模组安装到世界副本中。如果没有安装,就会使用原版后备物品。如果目标链中的物品都未安装,则由推断规则决定(仅适用于武器和盔甲);否则该物品会被移除。

传家宝

内置表格中的 Boss 装备会获得合法的原版附魔,以弥补失去的特殊能力,无论它最终替换为模组物品,还是下表所示的下界合金等级原版装备。已有附魔始终优先,不会组合不兼容的附魔,附魔等级也不会超过原版上限。

旧物品(Cataclysm) 原版后备物品 传家宝附魔
The Incinerator 下界合金剑 锋利 V、火焰附加 II、耐久 III、经验修补
Meat Shredder 下界合金斧 锋利 V、效率 V、耐久 III、经验修补
Infernal Forge 重锤 密度 V、火焰附加 II、耐久 III、经验修补
Astrape 三叉戟 穿刺 V、忠诚 III、引雷、耐久 III、经验修补
Cursed Bow 弓 力量 V、火矢、耐久 III、经验修补
Ignitium Chestplate 下界合金胸甲 保护 IV、耐久 III、经验修补

可以关闭传家宝加成(heirloomBonusEnchantments = false)。

内置替换表

1.0.0 版本为以下已移除的模组提供了 613 个物品的替换表,另有 129 个会被刻意移除的物品(结构和 Boss 竞技场方块、仅创造模式物品等):

已移除的模组 条目数 推荐的目标模组 未安装目标模组时
L_Ender’s Cataclysm 220 World Bosses、Remnants(需要 Jauml)、The Graveyard 原版装备和材料;Boss 装备附有传家宝附魔
Bosses of Mass Destruction 19 World Bosses、Remnants 原版物品
Supplementaries / Amendments 211 / 2 Signpost(仅路标) 原版方块和物品
Cultural Delights 160 Croptopia 原版食物和作物
Ragdollified Player Corpses 1 无 重生指南针

其中 161 个条目优先使用模组物品作为替换目标。如果未安装这些模组,则会回退到原版物品,因此替换模组并非必需。服务器日志会在启动时显示有多少条目使用首选目标,又有多少条目使用目标链中的后续目标。游戏内并未针对原物品平衡替换物品的属性和能力;请将这些表格视为合理的默认设置,如有不同意见,可在配置中覆盖对应条目。被替换容器(袋子、箭袋、罐子、保险箱)中的内容不会转移。

典型工作流程:移除模组后迁移世界

  1. 停止服务器并进行完整备份。请在世界副本上操作。
  2. 移除不再需要的模组。将 Legacy Item Purger 放入 mods。可选:安装能够提供模组替代目标的模组。
  3. 预览。使用默认的 dryRun = true 启动服务器。加载受影响的区域,并查看以 [LegacyItemPurger] 开头的日志行。计划替换的内容示例如 old -> new | REPLACED_WEAPON (dry-run: would replace)。
  4. 选择模式(replace 或 remove),也可以按需添加自定义映射。
  5. 应用。设置 dryRun = false 并重启。区块会在加载时清理;玩家及其末影箱会在登录时清理。
  6. 若要清理整个世界,请将所有现有区块加载一次,例如使用 Chunky 等能够强制加载现有区块的预生成工具。
  7. 检查结果,然后将清理后的世界移至正式服务器。

命令

需要权限等级 2(管理员或服务器控制台)。切换模式需要等级 3。

命令 作用
/legacyitempurger status 显示模式、自动清理、试运行状态和排队中的区块数量
/legacyitempurger mode 显示当前模式
/legacyitempurger mode replace / mode remove 切换模式并保存到配置文件
/legacyitempurger scan [radius] 预览你周围已加载方块容器中的物品(半径 0 至 8 个区块,默认 4)
/legacyitempurger apply [radius] 清理你周围已加载方块容器中的物品;即使在 dryRun = true

scan 和 apply 状态下也不会额外加载区块。

配置概览

config/legacyitempurger-common.toml

键 默认值 说明
mode "replace" "replace" 或 "remove"
dryRun true 仅预览。设置 false 以更改数据
automatic true 数据加载时进行检查
removeMissingItems、removeAirEntries true 物品清理开关
removeMissingBlocks、removeMissingStructures true 区块清理开关
removeUnknownAttributes、migrateLegacyFluids、cleanDistantHorizons true 其他旧版数据
blockedItemIds、blockedNamespaces、allowedItemIds 空 强制移除物品或保护指定物品
replaceMissingWeapons、replaceMissingArmor、replaceMissingOtherItems true 允许替换的内容(仅替换模式)
weaponReplacements、armorReplacements、itemReplacements 空 自定义映射,"old:item=first:target|second:target"(仅替换模式)
weaponFallback、armorFallback true 关键词启发式判断(仅替换模式)
addReplacementLore、heirloomBonusEnchantments true 物品描述行和传家宝加成(仅替换模式)
loreLanguage "en" 物品描述行的语言:"en" 或 "de"(仅替换模式)
blockInventoriesPerTick、slotsPerTick、detailsPerReport 8 / 256 / 20 性能和日志限制

兼容性

  • Minecraft 1.21.1、NeoForge 21.1.264 或更新的 21.1.x 版本Java 21。
  • 服务器端和客户端均可使用。同一个 JAR 可用于独立服务器、单人游戏和客户端。只在服务器端安装即可清理服务器世界:客户端无需安装此模组也能加入。若客户端也安装此模组,还能清理客户端本地解码的数据。
  • 可选的 Distant Horizons 支持(基于 NeoForge 版 DH 3.3.3 构建):读取 LOD 数据时会规范化缺失的方块 ID。不安装 Distant Horizons 时,此功能不会启用。
  • 除 NeoForge 外无需其他前置。

常见问题

安装后会自动删除内容吗?
不会。默认设置为 dryRun = true,只会显示报告。需要你自行关闭该设置。

能找回已移除或替换的物品吗?
只能从备份中恢复。因此请先预览。

我从 replace 切换到了 remove。被替换的物品会消失吗?
不会。替换后的物品属于普通物品。模式只决定如何处理仍然缺失的物品。

捆绑表中没有我的模组。
武器和盔甲通常会被关键词启发式判断识别。其他物品请在配置中添加自定义映射。

会扫描整个世界吗?
数据在加载时才会清理。没有人加载的区块会保持原样,直到被加载。若要一次性清理所有内容,请使用能加载全部现有区块的工具。

它会隐藏日志中的错误吗?
不会。它会修复导致错误的数据。其他模组中与缺失物品、方块或结构无关的消息仍会照常显示。

如果出错,物品会被移除吗?
不会。如果检查物品栏失败,会保留原始数据并记录问题。

警告

  • 设置 dryRun = false 前请先备份。移除和替换操作无法撤销。
  • 这是一个 测试版。它经过自动回归测试和测试服务器验证,但并未在所有整合包中测试。
  • 替换内容只是近似物品。模组物品的特殊能力会丢失。
  • 替换物品时会写入物品描述行(“传家宝:焚烧者(灾变)” / “已替换:牛油果(Cultural Delights)”)。应用前请选择 loreLanguage(en 或 de),或通过 addReplacementLore = false 关闭此功能。
  • 仍在安装的模组所添加的物品不会被处理,除非你将其列入 blockedItemIds 或 blockedNamespaces。

许可证与鸣谢

MIT 许可证,版权所有 (c) 2026 Raffman180。许可证全文包含在 JAR 中。

此模组由 Raffman180 借助 AI 协作(vibecoded)制作。

常见问题

Legacy Item Purger 支持哪些 Minecraft 版本?

Legacy Item Purger 支持 Minecraft Java 版 1.21.1,可用的加载器:NeoForge。下载时注意选择和你游戏版本一致的文件。

Legacy Item Purger 怎么安装?

先用 PCL2 或 HMCL 启动器安装对应版本的 NeoForge,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。

评论

登录后评论和评分

Raffman180 的其他作品

查看全部 →