自定义碰撞箱库

🧊 CustomHitboxLib

挣脱原版的方形束缚。

CustomHitboxLib 是一个轻量级、功能强大的库模组，适用于 Forge 1.20.1 和 NeoForge 1.21.1，彻底革新了实体的碰撞箱。它完全绕过了 Minecraft 硬编码的单一方形碰撞箱（宽度和高度）的限制，为任何实体引入完整的多部件碰撞箱支持——就像原版的末影龙一样！

无论你是在开发大型复杂 Boss，还是仅仅想为现有生物提供精确的碰撞箱，CustomHitboxLib 都能提供一个无缝、稳健的框架来实现这一目标。

❓ 概览

• 这个项目添加了什么？ CustomHitboxLib 是一个库模组，为 Forge 1.20.1 和 NeoForge 1.21.1 带来完整的多部件碰撞箱支持，覆盖了原版单一方形实体碰撞箱的限制。
• 它有哪些功能？ 你可以为单个实体（自定义实体、原版生物或玩家）附加任意数量的独立、尺寸精确的子碰撞箱。它能够处理复杂的位置关系，并自动将伤害转发给主实体。
• 用户为什么要下载它？ 对于玩家来说，如果某个出色的 Boss 或战斗模组需要它才能运行，只需安装即可！对于开发者来说，这个库为你提供了轻松构建大型、动态形状的生物和真实交互的工具，而无需与硬编码的 Minecraft 机制作斗争。

📁 完整数据包支持

使用 CustomHitboxLib 不需要编程知识！整合包作者和服务器管理员可以通过简单的 JSON 文件彻底改造实体的形状。

用 JSON 塑造你的世界

借助 Minecraft 内置的数据包系统，你可以为游戏中任何现有实体（无论是原版僵尸还是其他模组中的巨兽）附加全新的碰撞箱——比如翅膀、尾巴或额外的头颅。

• 无需代码： 通过 JSON 即可定义部件的尺寸、偏移和行为。
• 通用能力： 可直接无缝作用于任何已加载的实体。
• 实时重载： 调整自定义碰撞箱后，使用 /reload 即可在游戏中立即看到更改！

🛠️ 强大的开发者 API

数据包非常适合配置现有生物，而 CustomHitboxLib 也为模组开发者提供了强大的 API！

• 能力驱动： 使用 Forge Capabilities 动态地为任何实体附加新的子碰撞箱，无需修改基类或编写侵入性的 Mixin。
• 内置定位器： 利用提供的辅助方法轻松实现部件的动画和定位（例如跟随、相对偏移或平滑插值）。
• 绝对控制： 对于完全自定义的 Boss，只需在你的实体上实现我们的接口，即可获得对部件生命周期和更新逻辑的精细控制。

⚙️ 无缝集成

CustomHitboxLib 专为高性能和最大兼容性而设计。

• 高级碰撞覆盖： 完全禁用原版碰撞箱的拾取交互、推动、方块碰撞和窒息机制，并将这些关键检查全部转移到你的新自定义多部件碰撞箱上！
• 精确伤害转发： 击打任何自定义子碰撞箱都能完美地将伤害和定向击退注册到主实体上。
• 非侵入性： 经过精心构建，可在后台静默运行，使其成为复杂 Boss 和战斗模组的完美轻量级依赖。

只需将其放入你的 mods 文件夹，加载一个受支持的模组或自定义数据包，即可体验全新维度的 Minecraft 战斗！