Create模组中移动漏斗无法收集包裹实体的技术分析

问题背景

在Create模组6.0.3版本中，玩家发现了一个关于漏斗功能的行为异常：当漏斗安装在移动装置(contraption)上时，无法像静态漏斗那样收集包裹(Package)实体。这是一个功能完整性问题，因为包裹实体在Create模组中被设计为具有物品实体的特性，理应能被各种漏斗收集。

技术原理分析

Create模组中的漏斗系统分为两种工作模式：

1. 静态漏斗：直接放置在方块世界中的漏斗，通过FunnelBlock类实现
2. 移动漏斗：安装在移动装置上的漏斗，通过FunnelMovementBehaviour类实现

静态漏斗的工作机制

静态漏斗通过FunnelBlock类处理物品收集，其关键逻辑是：

• 同时检查物品实体(ItemEntity)和包裹实体(PackageEntity)
• 使用ItemHelper.extract方法处理实体收集
• 支持多种类型的物品输入/输出操作

移动漏斗的问题根源

移动漏斗的实现类FunnelMovementBehaviour中存在功能缺失：

• 仅处理普通物品实体(ItemEntity)
• 完全忽略了包裹实体(PackageEntity)的收集逻辑
• 导致安装在移动装置上的漏斗功能不完整

代码层面差异

通过对比两个实现类的关键代码可以清晰看到差异：

静态漏斗收集逻辑：

// 同时处理ItemEntity和PackageEntity
if (entity instanceof ItemEntity || entity instanceof PackageEntity) {
    ItemHelper.extract(...);
}

移动漏斗收集逻辑：

// 仅处理ItemEntity
if (entity instanceof ItemEntity) {
    // 收集逻辑...
}

影响范围

此问题影响所有安装在移动装置上的漏斗类方块，包括：

• 普通漏斗
• 智能漏斗
• 各种变种漏斗

解决方案

修复此问题需要修改FunnelMovementBehaviour类，使其包含对PackageEntity的处理逻辑，保持与静态漏斗一致的行为。具体修改应包括：

1. 添加PackageEntity的类型检查
2. 复用现有的物品收集逻辑
3. 确保移动状态下的包裹处理与静态情况一致

技术启示

这个问题展示了在模组开发中一个常见的设计挑战：当功能需要在不同环境下(静态/动态)复用时，必须确保行为一致性。开发者在实现移动装置上的方块行为时，需要：

1. 全面考虑原版方块的所有功能特性
2. 建立完善的测试用例覆盖各种使用场景
3. 保持代码逻辑的对称性和一致性

总结

Create模组中移动漏斗无法收集包裹实体的问题，本质上是功能实现不完整导致的。通过分析静态和动态两种漏斗的实现差异，我们可以清晰地看到问题所在。这类问题的解决不仅需要修复具体代码，更需要建立防止类似问题再次出现的开发规范和测试流程。