区块边界红石高亮器

区块边界红石高亮器

一个客户端性能调试工具,用于高亮位于区块边界上的红石组件——这是服务器卡顿的首要原因。按一次键(O)即可切换。

技术

区块边界红石高亮器

高性能服务器上导致卡顿的最大原因之一:跨区块边界放置的红石电路。 这款客户端模组会用红色线框盒高亮你周围那些有风险的方块,让你在 TPS 受到影响之前发现区块边界问题。

为什么跨区块边界的红石元件有害?

Minecraft 将世界划分为 16x16 的区块。每个区块独立加载、保存和刻更新。当红石信号跨越区块边界时:

  • 两个区块每个刻都需要更新
  • 侦测器、活塞和漏斗会触发额外的区块加载/保存周期
  • Paper、Purpur 和 Folia 受此影响最大,因为它们的异步区块系统
  • 异步区块实现中,跨边界会持有同步锁

功能

  • 一键开关 —— 默认 O 键(可在 选项 > 控制 中重新绑定)
  • 玩家周围 32 格半径扫描 —— 找出附近所有有风险的方块
  • 智能边界检测 —— 使用 localX == 0 || localX == 15 || localZ == 0 || localZ == 15 的数学判断(在负坐标下也能正确工作)
  • 检测的方块:
    • 红石
    • 中继器
    • 比较器
    • 侦测器
    • 活塞(普通 + 粘性)
    • 漏斗
  • 极小的性能影响 —— 每 10 刻扫描一次,只检查边界列
  • 使用 1.21.11 的新 Gizmo 渲染 API —— 干净、无 bug 的渲染
  • 无需服务端安装 —— 仅客户端,适用于任何服务器

使用方法

  1. 下载此模组和 Fabric API
  2. 将两者放入你的 .minecraft/mods/ 文件夹
  3. 加入世界或服务器
  4. 按 O —— 附近的区块边界红石元件会被红色线框包裹
  5. 再次按 O 关闭

兼容性

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

未测试

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