SablePickFix

SablePickFix

阻止生命值条在Sable子层级上查询宽度达数百万格的实体框。

SablePickFix —— HealthBars × Sable 修复(NeoForge 1.21.1,仅客户端)

问题

驾驶 Sable 飞船或站在任意 Sable 装置上时,日志会被以下信息刷屏:

Aborting entity get for abnormally large AABB

在子层级(sub-level)上,方块拾取(block pick)可能命中结构自身的存储坐标。HealthBars 21.1.0 会根据该方块拾取的距离推导交互范围,于是范围变成约 1e7,而它为十字准星查询构建的实体搜索盒最终会横跨数千万格:

AABB aABB = entity.getBoundingBox()
        .expandTowards(viewVector.scale(interactionRange))
        .inflate(1.0, 1.0, 1.0);
ProjectileUtil.getEntityHitResult(entity, eyePosition, vec3, aABB, predicate, ...);

这个盒子会直接进入原版实体查询。遍历它大约每格宽度就要消耗一个区块柱,因此每次十字准星 tick 都会浪费数百万次无用的查询,而 Sable 只能硬性拒绝它——这既会刷屏日志,也会破坏子层级上的名牌拾取。

修复

SablePickFix 会混入(mixin)fuzs.healthbars.client.handler.PickEntityHandler#pick,仅替换第 3 个参数——传给 ProjectileUtil.getEntityHitResult 的 AABB——将其替换为该 AABB 与以相机眼位为中心的 64 格窗口的交集。

  • HealthBars 自身的距离检查不受影响。
  • Sable 的子层级 getter 不受影响。
  • 已经符合要求的盒子会原样返回,零内存分配。
  • 安全优先:如果 HealthBars 更新导致注入点位置变化,补丁会记录日志并什么都不做,而不是让你的游戏崩溃。

正常交互范围为 3–5 格,因此 64 格窗口对任何合理配置都足够宽裕,拾取结果保持不变。

要求

  • Minecraft 1.21.1
  • NeoForge 21.1 或更高版本
  • HealthBars 21.1.0 或更高版本(客户端)
  • Sable(任何会显示超大 AABB 错误的版本)

仅客户端——安装在客户端即可。服务器不需要安装。

安装

  1. 为 Minecraft 1.21.1 安装 NeoForge 21.1+。
  2. 将 SablePickFix-26.10.14.jar 和 HealthBars 放入你的 mods/ 文件夹。
  3. 启动游戏。

许可证

MIT