漏斗锁可视化器

漏斗锁可视化器

客户端调试工具,用红色线框高亮显示被红石锁定的漏斗。一眼看出哪些漏斗被禁用——不用再猜为什么你的物品分类器不工作了。

工具

Hopper Lock Visualizer

搭建了物品分拣器却发现哪里不对劲?你的漏斗中很可能有一个正在接收意外的红石信号。 这个客户端模组会用鲜红色轮廓包裹你附近每一个被锁定的漏斗,让你一眼就能找到罪魁祸首。

“锁定”的含义

漏斗有一个由 enabled 方块属性控制的两种状态:

  • 启用(默认): 从上方吸入物品,从嘴部推出物品。正常行为。
  • 禁用(锁定): 冻结。完全停止物品传输。由任何到达漏斗的红石信号触发——火把、压力板、比较器、来自相邻电路的杂散导线……

当大型装置停止工作时,十有八九的原因是漏斗意外接收到了附近某物的红石信号。这个模组让这个看不见的问题变得可见。

特性

  • 一键切换 —— 默认 H(可在 选项 > 控制 中重新绑定)
  • 玩家周围 32 格半径扫描,每秒刷新两次
  • 智能剔除 —— 基于距离 + 视锥的可见性检查,只绘制视野内的漏斗
  • 红色线框渲染,使用 Minecraft 1.21.11 的新 Gizmo API
  • 仅客户端 —— 适用于任何服务器,无需服务端安装
  • 零配置 —— 安装后按 H 即可

使用方法

  1. 安装本模组和 Fabric API
  2. 将两者放入你的 .minecraft/mods/ 文件夹
  3. 启动 Minecraft,加入任意世界或服务器
  4. 按 H → 附近的已锁定漏斗会被红色轮廓包裹
  5. 再次按 H 关闭

兼容性

特性 支持情况
Minecraft 1.21.11
模组加载器 Fabric(Loader 0.18.0+)
Fabric API 必需
Java 21+
端 仅客户端

未测试

  • Quilt: 未测试,但由于 Quilt 支持 Fabric 模组,应该可以工作
  • Forge/NeoForge: 不支持

性能

扫描每秒运行 2 次,而非每帧。每次扫描只读取方块状态(不涉及方块实体、不涉及物品栏),因此即使在拥有数百个漏斗的大型基地中,开销也微乎其微。渲染阶段在调用 Minecraft 的 Gizmo API 之前会进行距离 + 视锥剔除——没有手动矩阵运算,没有状态泄漏