BoneHitboxLib

Quick rating

Community listing page, reviews here may not be monitored by the author.

How listings work Are you the author?

BoneHitboxLib

By kltyton

No reviews yet

Model-based hitboxes, body-part interactions, and animated collisions for supported Minecraft mods.

Mod Loaders
Minecraft
26.2
Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

About

Description

BoneHitboxLib

Make hits and collisions follow the model.

BoneHitboxLib gives compatible mods hitboxes that follow individual model parts as they move and rotate. It supports more detailed combat, animated collisions, and block shapes that better match their models.

What can it bring to your game?

  • Hits on individual body parts
    Compatible mods can distinguish between hits to different parts of a creature, allowing separate part health and different reactions depending on where an attack lands.
  • Collisions that follow animations
    Supported creatures can use moving, rotating collision shapes for their body parts and held items.
  • Standing on moving creatures
    Compatible entities can support and carry other entities, making features such as rideable body surfaces possible.
  • Model-shaped blocks
    Supports angled collision surfaces and connected structures spanning multiple block spaces. Model-based collision for supported vanilla slanted blocks is enabled by default.
  • Actions timed to animations
    Optional GeckoLib integration lets compatible mods connect attacks and other actions to specific moments in an animation.

The available creature and combat features depend on the mods using this library. BoneHitboxLib does not add its own mobs, weapons, or automatic weak-point damage to every creature.

Installation

  1. Download the file matching your Minecraft version and mod loader.
  2. Place it in your mods folder. For multiplayer, use matching builds on the client and server.
  3. On Fabric, also install Fabric API and Forge Config API Port.
  4. Install GeckoLib if a mod in your pack requires its animation features.

Available for:

  • 1.20.1: Fabric and Forge
  • 1.21.1, 26.1.2, and 26.2: Fabric and NeoForge

Configuration

Server owners and modpack creators can choose which blocks use model-based collision through allowlists and denylists. A broader collision mode is also available and is disabled by default.

Collision shapes use packaged model geometry. Changing a client resource pack does not automatically change server collision.