截图
介绍
旧物品清理器
移除模组后清理世界,同时保住你的装备。
你从整合包里移除了几个模组,或者把世界迁移到了缺少某些模组的新整合包。现在日志里满是未知物品报错,箱子里出现空位,你辛苦打来的 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" |
|
|---|---|---|
| 缺失的武器和盔甲 | 替换为合适的物品;保留名称和附魔 | 移除 |
| 表格中列出的其他缺失物品(食物、作物、方块物品、杂项) | 替换;保留数量和名称 | 移除 |
| 所有其他缺失物品 | 移除 | 移除 |
| 缺失的方块、结构、属性和流体 | 清理 | 清理 |
| 适用场景 | 希望玩家保留进度的世界 | 简单、可预期的清理 |
替换方式
- 你自己的映射 优先使用。
- 然后使用内置表格(见下方“内置替换表”)。
- 接着使用关键词推断规则,为未知模组的武器和盔甲进行替换(
..._sword、katana、battleaxe、longbow、helm、greaves……以及diamond或netherite等等级词)。 - 没有可用替换物的物品会被移除。
被替换的武器和盔甲会保留自定义名称,以及所有仍然存在的附魔。模组专属数据和耐久损耗会被丢弃。每件替换物品都会添加一行描述旧物品的 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 个条目优先使用模组物品作为替换目标。如果未安装这些模组,则会回退到原版物品,因此替换模组并非必需。服务器日志会在启动时显示有多少条目使用首选目标,又有多少条目使用目标链中的后续目标。游戏内并未针对原物品平衡替换物品的属性和能力;请将这些表格视为合理的默认设置,如有不同意见,可在配置中覆盖对应条目。被替换容器(袋子、箭袋、罐子、保险箱)中的内容不会转移。
典型工作流程:移除模组后迁移世界
- 停止服务器并进行完整备份。请在世界副本上操作。
- 移除不再需要的模组。将 Legacy Item Purger 放入
mods。可选:安装能够提供模组替代目标的模组。 - 预览。使用默认的
dryRun = true启动服务器。加载受影响的区域,并查看以[LegacyItemPurger]开头的日志行。计划替换的内容示例如old -> new | REPLACED_WEAPON (dry-run: would replace)。 - 选择模式(
replace或remove),也可以按需添加自定义映射。 - 应用。设置
dryRun = false并重启。区块会在加载时清理;玩家及其末影箱会在登录时清理。 - 若要清理整个世界,请将所有现有区块加载一次,例如使用 Chunky 等能够强制加载现有区块的预生成工具。
- 检查结果,然后将清理后的世界移至正式服务器。
命令
需要权限等级 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 的其他作品
查看全部 →Raffman’s Detailed Map
一个精细的立体模型风格地图和小地图,支持团队共享战争迷雾、路径点、队伍、外交和区块认领。
Raffman’s Optimiser
设定目标帧率,它会自动调整你的图形和光影以达到该帧率。
Raffman’s Titles
通过游玩解锁 1,000 个装饰称号,包含动态边框和一本魔法称号书。
Jurgens Shader
色彩鲜艳、效果逼真的 Iris 光影:物理天空、柔和光照下的体积云、澄净的夜空、平静的水面、柔和阴影和彩色光照——1440p 下使用 HIGH 画质也很流畅。
评论
登录后评论和评分