ItemModule（物流模块）
物流管道上安装的功能模块，提供物品提取、存储、排序、合成等各种物流功能。
基本信息
| 属性 |
值 |
| 类别 |
Item |
| 父类 |
LogisticsItem |
| 配置文件 |
NBT（模块独立存储，绑定到物品实例） |
| GUI 触发 |
手中或管道方块上右键 |
模块类型总表
共有 28 种模块类型，ID 编号如下：
| ID |
名称 |
类 |
过滤/配置 |
重置方法 |
| 0 |
BLANK |
- |
无 |
- |
| 1 |
ITEMSINK |
ModuleItemSink |
9格物品过滤 + DefaultRoute 开关 |
无清空，仅 Import 覆盖 |
| 2 |
PASSIVE_SUPPLIER |
ModulePassiveSupplier |
9格物品过滤 |
无 |
| 3 |
EXTRACTOR |
ModuleExtractor |
9格物品过滤 + 抽取方向 |
无 |
| 4 |
POLYMORPHIC_ITEMSINK |
ModulePolymorphicItemSink |
9格物品过滤 |
无 |
| 5 |
QUICKSORT |
ModuleQuickSort |
无 |
- |
| 6 |
TERMINUS |
ModuleTerminus |
9格物品过滤 |
无 |
| 7 |
ADVANCED_EXTRACTOR |
ModuleAdvancedExtractor |
9格物品过滤 + 抽取方向 |
无 |
| 8 |
BEEANALYZER |
ModuleApiaristAnalyser |
分析模式（CC 控制） |
无 |
| 9 |
BEESINK |
ModuleApiaristSink |
FilterType + 分组 + 蜜蜂ID |
右键重置各槽位 |
| 10 |
APIARISTREFILLER |
ModuleApiaristRefiller |
无 |
- |
| 11 |
APIARISTTERMINUS |
ModuleApiaristTerminus |
无 |
- |
| 12 |
MODBASEDITEMSINK |
ModuleModBasedItemSink |
Mod ID 过滤 |
无 |
| 13 |
OREDICTITEMSINK |
ModuleOreDictItemSink |
矿物字典过滤 |
无 |
| 14 |
CC_BASED_QUICKSORT |
ModuleCCBasedQuickSort |
无 |
- |
| 15 |
CC_BASED_ITEMSINK |
ModuleCCBasedItemSink |
9格物品过滤 |
无 |
| 16 |
CREATIVETABBASEDITEMSINK |
ModuleCreativeTabBasedItemSink |
创意模式标签过滤 |
无 |
| 17 |
GT_TYPEFILTER_ITEMSINK |
ModuleTypeFilterItemSink |
类型过滤（GTNH） |
无 |
| 30 |
THAUMICASPECTSINK |
ModuleThaumicAspectSink |
神秘要素过滤 |
无 |
| 31 |
ENCHANTMENTSINK |
ModuleEnchantmentSink |
附魔等级过滤 |
无 |
| 100 |
EXTRACTOR_MK2 |
ModuleExtractorMk2 |
同 EXTRACTOR |
无 |
| 101 |
ADVANCED_EXTRACTOR_MK2 |
ModuleAdvancedExtractorMK2 |
同 ADVANCED_EXTRACTOR |
无 |
| 131 |
ENCHANTMENTSINK_MK2 |
ModuleEnchantmentSinkMK2 |
同 ENCHANTMENTSINK |
无 |
| 200 |
EXTRACTOR_MK3 |
ModuleExtractorMk3 |
同 EXTRACTOR（更快） |
无 |
| 201 |
ADVANCED_EXTRACTOR_MK3 |
ModuleAdvancedExtractorMK3 |
同 ADVANCED_EXTRACTOR（更快） |
无 |
| 300 |
ELECTRICMANAGER |
ModuleElectricManager |
电力阈值 |
无 |
| 301 |
ELECTRICBUFFER |
ModuleElectricBuffer |
电力缓冲 |
无 |
| 500 |
PROVIDER |
ModuleProvider |
物品黑名单 |
无 |
| 501 |
PROVIDER_MK2 |
ModuleProviderMk2 |
同 PROVIDER |
无 |
| 502 |
ACTIVE_SUPPLIER |
ModuleActiveSupplier |
主动供应 |
无 |
| 600 |
CRAFTER |
ModuleCrafter |
合成配方（9输入+2输出） |
无（手动删除） |
| 601 |
CRAFTER_MK2 |
ModuleCrafterMK2 |
同 CRAFTER |
无 |
| 602 |
CRAFTER_MK3 |
ModuleCrafterMK3 |
同 CRAFTER（液体合成） |
无 |
配置重置机制
有重置方法的模块
ModuleApiaristSink（蜜蜂汇聚）
唯一提供逐槽位右键重置的模块。
| 操作 |
触发方式 |
| 重置 FilterType |
右键点击 Type 槽位 |
| 重置 FilterGroup |
右键点击 Group 槽位 |
| 重置 FirstBee |
右键点击第一个蜜蜂槽位 |
| 重置 SecondBee |
右键点击第二个蜜蜂槽位 |
ModuleItemSink（物品槽）
| 操作 |
方法 |
说明 |
| 导入过滤 |
GUI 按钮"import" |
从当前指向的容器自动填充 9 格过滤 |
| 重置/清空 |
无 |
只能手动拖出或用 Import 覆盖 |
无重置方法的模块
大多数有过滤配置的模块（ITEMSINK、EXTRACTOR、OREDICTITEMSINK、CRAFTER 等）：
- 没有"Clear"按钮
- 没有"Reset"按钮
- 只能手动从 GUI 槽位拖出物品
- 或者用 Import 覆盖（如果有指向的容器）
通用操作
| 操作 |
方式 |
| 添加过滤物品 |
拖入物品到 GUI 槽位 |
| 删除过滤物品 |
从 GUI 槽位拖出 |
| 修改过滤选项 |
槽位旁的按钮（如 Fuzzy 开关） |
| 邻块变化时 |
自动调用 clearCache() 清除缓存 |
第三方集成
| 集成 Mod |
模块 |
功能 |
| Forestry |
BEEANALYZER、BEESINK、APIARISTREFILLER、APIARISTTERMINUS |
蜜蜂相关物流 |
| Thaumcraft |
THAUMICASPECTSINK |
TC 要素过滤 |
| ComputerCraft |
CC_BASED_QUICKSORT、CC_BASED_ITEMSINK |
计算机控制 |
| IndustrialCraft2 |
ELECTRICMANAGER、ELECTRICBUFFER |
电力管理 |
底层实现
- 模块通过
ItemModule.getModuleForItem() 反射构造
- 配置存储在物品的 NBT 中（
readFromNBT/writeToNBT）
- GUI 通过
LogisticsGuiModule.getInHandGuiProviderForModule() 打开
- 模块实现了
ISaveState 接口（持久化）