排序块模组

排序块模组

根据区域内带有标签的物品,物品会被自动收集并分类到带有显示标志的盒子中。

📦 用户手册

简介

物品收集与分类装置。它不仅能自动拾取上方掉落的物品,还能通过扫描周围的容器,智能地将物品分发到对应的箱子中。

其最显著的特性是支持“可视化分类”:你只需用物品展示框或告示牌标记箱子,机器便会自动理解你的分类意图。


🛠️ 快速开始

版本说明(Java 版)

基于 Minecraft 1.21.11 版本设计,使用 Fabric API。

  1. 放置机器:将智能归档单元放置在地面上。
  2. 布置存储区:在机器周围放置箱子容器(支持范围由边框线效果指示)。
  3. 标记箱子:使用附着在箱子上的物品展示框或告示牌来定义其用途(参见“分类规则”)。
  4. 输入物品:将物品直接丢在机器上方。机器会生成粒子束将物品传输至目标箱子。

📋 分类规则与优先级

机器会按照优先级从高到低尝试存储物品。

🥇 优先级 1:标签过滤(过滤箱)

  • 设置方法:在箱子上附着物品展示框,并在展示框中放入特定物品(例如苹果)。
  • 逻辑:机器检查掉落的物品是否与展示框中的物品匹配。
    • ✅ 是:物品存入此箱子。
    • ❌ 否:跳过,寻找下一个箱子。
  • 用途:用于存储大量特定资源(例如矿石、作物)。

🥈 优先级 2:自动学习单元(自动学习箱)

  • 设置方法:在箱子上附着空物品展示框。
  • 逻辑:
    1. 机器检测到物品展示框为空。
    2. 机器将当前处理的物品(例如橡木原木)存入箱子。
    3. ✨ 自动标记:机器自动从箱子中取出一个橡木原木放入物品展示框。
    4. 结果:此箱子升级为优先级 1(专用过滤箱),此后将专门接收橡木原木。
  • 用途:无需手动设置过滤器;让系统根据传入的物品自动建立分类。

🥉 优先级 3:杂物/溢出箱(倾倒箱)

  • 设置方法:在箱子上附着告示牌,并在告示牌的任意一行写上 Sundries(不区分大小写)。
  • 逻辑:忽略物品类型;只要箱子未满,即可接收任何物品。
  • 用途:
    • 存储不属于其他类别的杂项物品。

📏 参数

  • 有效工作范围:
    • 以机器为中心。
    • X 轴(东西向):30 格
    • Y 轴(垂直向):5 格
    • Z 轴(南北向):8 格
    • 可配置

物品分类系统文档

将 Minecraft 中的物品划分为多个逻辑类别。每个类别由一个代表性物品标识,并通过标签、硬编码集合以及自定义匹配逻辑来定义哪些物品属于该类别。类别用于物品过滤、整理或其他功能。


类别概览

类别 代表性物品 描述
农业与植物 小麦 作物、种子、树苗、花、树叶等
食物 苹果 所有可食用物品(含特定排除项)
矿物与资源 铁锭 矿石、锭、粗矿、矿石块、粒等
装备与盔甲 铁胸甲 盔甲及可饰纹装备
工具 铁斧 工具、武器、箭、桶等
建筑材料 圆石 各种建筑方块(石头、木头、玻璃等)
交通运输 矿车 矿车、铁轨、船及相关物品
红石 红石 红石元件及红石矿石
怪物掉落物 腐肉 怪物掉落物(包括皮革、羽毛等)
木工/家具 橡木原木 木质装饰、工作站、家具等
魔法 玻璃瓶 魔法相关物品(药水、附魔、酿造等)

类别详细说明

1. 农业与植物

代表性物品:Wheat(小麦) 关联标签:

  • c:crops
  • c:seeds
  • villager_plantable_seeds
  • saplings
  • flowers
  • leaves
  • wart_blocks
  • c:dyes

额外匹配物品(硬编码集合 FARMING_MISC):

  • 骨粉
  • 睡莲
  • 苔藓块
  • 苔藓地毯
  • 蜜脾
  • 蜜脾块
  • 蜂箱
  • 蜂巢

2. 食物

代表性物品:Apple(苹果) 关联标签:

  • c:foods
  • fishes

排除物品(黑名单):

  • 腐肉
  • 蜘蛛眼
  • 河豚
  • 毒马铃薯

额外匹配物品(FOOD_MISC + 所有带有 food 组件的物品):

  • 鸡蛋
  • 糖
  • 蛋糕

3. 矿物与资源

代表性物品:Iron Ingot(铁锭) 关联标签:

  • c:ingots
  • c:raw_materials
  • c:ores
  • c:storage_blocks
  • c:nuggets
  • beacon_payment_items
  • coal_ores
  • redstone_ores
  • lapis_ores
  • diamond_ores
  • gold_ores
  • iron_ores
  • copper_ores

额外匹配物品(MINERAL_MISC):

  • 燧石
  • 墨囊
  • 荧光墨囊
  • 紫水晶碎片
  • 石英
  • 下界石英矿石

4. 装备与盔甲

代表性物品:Iron Chestplate(铁胸甲) 关联标签:

  • trimmable_armor
  • head_armor
  • chest_armor
  • leg_armor
  • foot_armor

无额外硬编码物品(已由标签覆盖)。

5. 工具

代表性物品:Iron Axe(铁斧) 关联标签:

  • axes
  • hoes
  • pickaxes
  • shovels
  • swords
  • arrows

额外匹配物品(TOOL_MISC):

  • 剪刀
  • 打火石
  • 钓鱼竿
  • 命名牌
  • 拴绳
  • 收纳袋
  • 盾牌
  • 弓
  • 弩
  • 三叉戟
  • 箭
  • 光灵箭
  • 药箭
  • 重锤
  • 风弹
  • 桶
  • 水桶
  • 熔岩桶
  • 奶桶
  • 细雪桶
  • 美西螈桶
  • 蝌蚪桶

6. 建筑材料

代表性物品:Cobblestone(圆石) 关联标签:

  • stone_bricks
  • wool
  • wool_carpets
  • logs
  • planks
  • stairs
  • slabs
  • walls
  • fences
  • fence_gates
  • terracotta
  • dirt
  • sand
  • candles
  • beds
  • c:glass_blocks
  • c:glass_panes

硬编码集合 STONE_VARIANTS(所有石类变种):

  • 石头
  • 花岗岩
  • 磨制花岗岩
  • 闪长岩
  • 磨制闪长岩
  • 安山岩
  • 磨制安山岩
  • 深板岩
  • 深板岩圆石
  • 磨制深板岩
  • 凝灰岩
  • 方解石
  • 玄武岩
  • 磨制玄武岩
  • 平滑玄武岩
  • 下界岩
  • 黑石
  • 磨制黑石
  • 镶金黑石
  • 滴水石块
  • 滴水石锥
  • 紫水晶块
  • 紫水晶簇
  • 平滑石头
  • 灵魂沙
  • 下界砖块
  • 苔石
  • 冰
  • 浮冰
  • 蓝冰
  • 末地石
  • 菌光体
  • 沙砾
  • 灵魂土
  • 圆石
  • 石砖
  • 苔石砖
  • 裂纹石砖
  • 雕纹石砖
  • 深板岩砖
  • 裂纹深板岩砖
  • 深板岩瓦
  • 裂纹深板岩瓦
  • 雕纹深板岩
  • 磨制黑石砖
  • 裂纹磨制黑石砖
  • 雕纹磨制黑石
  • 红色下界砖块
  • 末地石砖

额外固定物品:

  • 红砖块
  • 红砖楼梯
  • 红砖台阶

7. 交通运输

代表性物品:Minecart(矿车) 关联标签:

  • rails
  • boats
  • chest_boats
  • c:minecarts

额外匹配物品(TRANSPORT_MISC,包括 ANIMAL_EQUIPMENT + 以下内容):

  • 鞍
  • 皮革马铠
  • 铁马铠
  • 金马铠
  • 钻石马铠
  • 狼铠
  • 铜马铠
  • 下界合金马铠
  • 胡萝卜钓竿
  • 诡异菌钓竿
  • 鞘翅
  • 皮革

8. 红石

代表性物品:Redstone(红石) 关联标签:

  • redstone_ores
  • buttons
  • doors
  • trapdoors
  • c:dusts

硬编码集合 REDSTONE_COMPONENTS:

  • 红石中继器
  • 红石比较器
  • 侦测器
  • 投掷器
  • 发射器
  • 漏斗
  • 活塞
  • 黏性活塞
  • 红石块
  • 红石火把
  • 标靶
  • 拉杆
  • 避雷针
  • 阳光探测器
  • 幽匿感测体
  • 校准幽匿感测体
  • 绊线钩
  • 讲台
  • 石质压力板
  • 橡木压力板
  • 云杉压力板
  • 白桦压力板
  • 丛林压力板
  • 金合欢压力板
  • 深色橡木压力板
  • 红树压力板
  • 樱花压力板
  • 竹压力板
  • 绯红压力板
  • 诡异压力板
  • 磨制黑石压力板
  • 重质测重压力板
  • 轻质测重压力板
  • 石质按钮
  • 橡木按钮
  • 云杉按钮
  • 白桦按钮
  • 丛林按钮
  • 金合欢按钮
  • 深色橡木按钮
  • 红树按钮
  • 樱花按钮
  • 竹按钮
  • 绯红按钮
  • 诡异按钮
  • 磨制黑石按钮
  • 红石灯
  • 音符盒
  • 陷阱箱
  • 动力铁轨
  • 探测铁轨
  • 激活铁轨
  • 红石矿石
  • 深层红石矿石

9. 怪物掉落物

代表性物品:Rotten Flesh(腐肉) 关联标签:

  • c:bones
  • c:rotten_flesh
  • c:slimeballs
  • c:strings
  • c:spider_eyes
  • c:gunpowder
  • c:ender_pearls
  • c:blaze_rods
  • c:ghast_tears
  • c:feathers
  • c:leather

额外匹配物品(MOB_DROPS_MISC):

  • 兔子皮
  • 雪球

10. 木工/家具

代表性物品:Oak Log(橡木原木) 关联标签:

  • c:chests
  • signs
  • hanging_signs

硬编码集合 WOOD_MISC_ITEMS:

  • 营火
  • 灵魂营火
  • 梯子
  • 火把
  • 灵魂火把
  • 灯笼
  • 灵魂灯笼
  • 物品展示框
  • 荧光物品展示框
  • 画
  • 盔甲架
  • 碗
  • 木棍
  • 纸
  • 书
  • 书与笔
  • 成书
  • 花盆
  • 堆肥桶
  • 木桶
  • 工作台
  • 箱子
  • 脚手架
  • 织布机
  • 制图台
  • 制箭台
  • 锻造台
  • 砂轮
  • 蜂箱
  • 书架

11. 魔法

代表性物品:Glass Bottle(玻璃瓶) 关联标签:无(由额外匹配器处理)

额外匹配物品(MAGIC_MISC):

  • 附魔书
  • 附魔之瓶
  • 青金石
  • 酿造台
  • 炼药锅
  • 哭泣的黑曜石
  • 末影之眼
  • 药水
  • 喷溅药水
  • 滞留药水

匹配逻辑说明

对于给定的过滤物品(代表性物品)和待检查物品,系统按以下顺序判定是否匹配:

  1. 若物品完全相同 → 匹配。
  2. 若代表性物品没有对应的类别 → 不匹配。
  3. 若待检查物品在代表性类别的排除列表中 → 不匹配。
  4. 若待检查物品具有与该类别关联的任意标签 → 匹配。
  5. 若待检查物品在该类别的硬编码集合中 → 匹配。
  6. 若该类别的额外匹配器返回 true → 匹配。
  7. 否则 → 不匹配。

此设计确保了类别的灵活性与可扩展性,充分利用原版标签系统,同时通过硬编码集合和自定义逻辑补充标签未覆盖的物品。


文档最后更新:2026 年 3 月 11 日