CustomHitboxLib

CustomHitboxLib

一个适用于Forge 1.20.1和NeoForge 1.21.1的强大库,可为任何实体添加真正的多部件碰撞箱!通过简单的JSON数据包或开发者API,突破原版单一方块的限制,创建具有精确碰撞的复杂Boss。

基础库

🧊 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 即可在游戏中立即看到变化!

数据包 JSON 示例


🛠️ 强大的开发者 API

数据包非常适合配置现有生物,但 CustomHitboxLib 也为模组开发者提供了稳健的 API!

  • 基于 Capability: 使用 Forge Capability 动态地为任何实体附加新的子碰撞箱,无需修改基类或编写侵入式 Mixin。
  • 内置定位器: 利用提供的辅助方法轻松实现部件的动画与定位(例如跟随身后、相对偏移或平滑插值)。
  • 绝对控制: 对于完全自定义的 Boss,只需在你的实体上实现我们的接口,即可直接、细粒度地控制部件生命周期和更新逻辑。

⚙️ 无缝集成

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

  • 高级碰撞覆盖: 完全禁用原版碰撞箱的选取交互、推动、方块碰撞和窒息机制,将所有这些关键检测直接转移到你新的自定义多部件碰撞箱上!
  • 精确伤害转发: 击中任何自定义子碰撞箱都能完美地将伤害和方向性击退记录到主实体上。
  • 非侵入式: 精心构建,在后台静默运行,是复杂 Boss 和战斗模组的完美轻量级依赖。

只需将它放入你的 mods 文件夹,加载支持的模组或自定义数据包,即可体验全新维度的 Minecraft 战斗!