Hitbox Api

Hitbox Api

为Minecraft添加更多碰撞体

基础库

Hitbox API

为 Minecraft 添加更多常用碰撞体

  • 有向包围盒(OBB)
  • 球体
  • 胶囊体
  • 射线
  • 复合体
    • 多个碰撞体可以合并为一个。
    • 复合碰撞体可以嵌套。

如何使用

在任何需要进行碰撞检测的地方,创建一个碰撞体对象,并使用 ColliderUtil 中的方法判断是否发生碰撞。

对于实体(Entity),你可以通过附加 HitboxDataAttachments#COLLISION 来实现碰撞箱缓存。按下 F3 + B 即可渲染缓存的碰撞体。请注意,该 Data 没有持久化实现。

性能

测试方法

  • JMH 基准测试

测试环境

  • CPU:AMD R5 5600G
  • 内存:32GB
  • JDK:Microsoft OpenJDK 21.0

测试设置

  • 预热轮次:5
  • 测试轮次:5

测试项

  • 同类型碰撞体的碰撞检测
碰撞体 得分 误差 单位
轴对齐包围盒 3561837865.930 157982649.213 ops/s
胶囊体 22350681.198 238993.658 ops/s
旋转胶囊体 16842309.523 103959.918 ops/s
有向包围盒 5528493.224 64548.996 ops/s
旋转有向包围盒 4648963.750 111369.535 ops/s
球体 119556589.705 1711146.560 ops/s

注意:得分越高表示性能越好。旋转表示碰撞体被旋转,并且相关向量被重新计算。

为实体添加碰撞体