Hitbox API

Adding more common collision boxes for Minecraft

• Oriented Bounding Box (OBB)
• Sphere
• Capsule
• Ray
• Compound
  • Multiple collision boxes can be combined into one.
  • Composite collision boxes can be nested.

How to Use

In any place where collision detection is needed, create a collider object and use the methods in ColliderUtil to determine if a collider has occurred.

For entities (Entity), you can achieve collider caching by attaching HitboxDataAttachments#COLLISION. The cached collider can be rendered by pressing F3 + B. Note that this Data does not have a persistence implementation.

Performance

Testing Method

• JMH Benchmark

Testing Environment

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

Testing Settings

• Warm-up Rounds: 5
• Test Rounds: 5

Testing Items

• Collision detection of the same type of collider

Note: Higher scores indicate better performance. Rotated means the collider is rotated and the relevant vectors are recalculated.