当模组只收人物不收物品时，到底发生了什么？

凌晨三点，我第N次在测试模组时遇到这个诡异情况——村民交易框里明明摆了钻石剑，NPC却死活只收走我背包里的生鸡肉。这种"选择性失明"在模组开发圈里都快成玄学了，今天咱们就掰开揉碎聊聊这个现象。

一、先搞清楚基础机制

Minecraft原版的交易系统其实是个精密齿轮组，三个关键部件咬合运作：

• 输入槽：玩家放物品的格子（左边）
• 输出槽：NPC给物品的格子（右边）
• 经济系统：那个显示绿宝石图标的小标签

但模组开发者Tommaso Checchi在2017年的技术分享会上提过，很多自定义交易模组会偷偷修改这个流程。就像给自动售货机接了个第三方读卡器，原版机制还在，但信号可能被劫持了。

二、常见翻车现场实录

上周测试Medieval Economy模组时就遇到个典型——铁匠铺老板死活不认我打的钢锭，后来发现是温度系统给金属加了隐藏NBT值。这种问题用常规调试根本看不出来，得祭出/data get entity这种武器。

2.1 物品匹配的暗箱操作

原版匹配逻辑其实很单纯：

• 基础物品ID对上了没？
• 数量够不够？
• 耐久值在不在接受范围？

但ItemStackHandler这个类被魔改后，有些模组会偷偷加戏。比如某个农业模组会检查作物是不是在月圆之夜收割的，而另一个魔法模组要读取物品的附魔历史记录。这些隐藏条件就像超市条形码背面用铅笔写的备注，普通玩家根本看不见。

三、实战排查指南

咖啡喝到第四杯时，我总结出这套排查流程：

1. 先用原版物品测试（比如普通金锭）
2. 关掉所有资源包
3. 单独加载该模组测试
4. 查日志里有没有ItemStack报错

特别要注意那些带CustomModelData的物品，去年Create模组的机械臂就因为这个和等价交换模组打过架。当时两个模组的开发者半夜在GitHub上互扔技术文档的样子，活像两个用代码吵架的幼儿园小朋友。

3.1 开发者工具包

这几个命令能救命：

• /ct hand（查看物品NBT）
• /gametest（创建纯净测试环境）
• /debug start（启动事件追踪）

要是看到日志里出现"Attempted to merge incompatible items"这种提示，基本可以确定是某个模组把物品注册表搞乱了。这时候就得像整理缠住的数据线那样，一个个模组排除。

四、那些年我们踩过的坑

还记得Tinker's Construct的1.12.2版本有个著名bug——用钴镐头做的工具会被某些NPC当成空气。后来发现是材料注册时漏了个isBeaconPayment标签，导致部分模组的交易系统直接无视这个物品。这种问题就像超市收银台突然不认某种纸币，顾客和店员都一脸懵。

更绝的是某些RPG模组的设定——比如Millénaire里村民会拒绝来历不明的物品。有次我测试时发现商人死活不收钻石，折腾两小时才反应过来是没完成前置任务。这种机制写在文档第47页的小字里，比宜家说明书还难找。

窗外天都快亮了，文档里还有十几个待测模组在排队。这种物品识别问题就像MC世界的未解之谜，每次以为找到规律就会冒出新的例外。不过话说回来，或许正是这些乱七八糟的兼容性问题，让模组开发变得像侦探破案一样有意思？