Hitbox Api

Collision detection is the step where a game object tests whether it touches another one. Hitbox Api supplies the colliders for that step: a developer builds a collider object with the methods of ColliderUtil wherever collision detection is needed, then checks whether a collision occurred. Oriented bounding boxes, which can be rotated with the relevant vectors recalculated, cover shapes that plain axis-aligned boxes fit poorly. Several colliders can be merged into one, or nested inside a composite collider.

Entities keep their collider box in a cache attached through HitboxDataAttachments under COLLISION, so the box is not rebuilt on every check. A cached collider is drawn on screen by pressing F3 + B. The author notes that data persistence is implemented, and that collision detection works between colliders of the same type. The mod is licensed under the GNU General Public License v3.0 or later and is open source; its source code and issue tracker are public.

The library is installed on both the server and the client, and the environment is client and server. It targets NeoForge only, with release files for 1.21 – 1.21.3; the latest file, neo-1.21.1-1.0.0, is marked for 1.21.3 and was published on 2024-12-03, the same day the mod was first released.