CNPC-沉浸式首领

CNPC-沉浸式首领

一个Forge 1.20.1模组，为通过GeckoLib渲染的CustomNPCs NPC添加了动画多碰撞箱OBB碰撞、碰撞箱感知战斗与脚本，以及自定义Boss血条。

CNPC-ImmersiveBoss

为 CustomNPCs 的 GeckoLib NPC 提供随骨骼动画变化的 OBB 多碰撞箱。

攻击、交互、弹射物、实体推挤和伤害检测现在都遵循实际模型形状，并提供自定义 Boss 血条、分部位脚本事件、碰撞伤害窗口和转向限速 API。让大型或异形 NPC 的受击、交互、弹射物、实体推挤和攻击判定贴合实际模型。

Minecraft 1.20.1 · Forge 47.x · Java 17

特性

  • 动画 OBB 碰撞箱 — 碰撞体积跟随 GeckoLib 骨骼平移、旋转和动画，支持多 cube 骨骼
  • 分部位战斗 — 准星、近战、箭/三叉戟等弹射物命中具体部位，脚本中读取 e.hitboxName
  • 物理箱与传感器 — b 箱参与实体互相推挤，s 传感器只检测重叠，互不干扰
  • 大型模型支持 — OBB 超出 NPC 原版 AABB 也能被攻击、交互和弹射物命中
  • 碰撞伤害窗口 — 让剑、尾巴等动画骨骼在指定帧造成伤害，可延迟、重复、限目标数、回调
  • 自定义 Boss 血条 — 上下分层 PNG 素材，常显或战斗时显示，可调颜色/缩放/偏移
  • 调试渲染 — F3+B 直接查看 OBB 类型、名称、局部轴和重叠状态
  • 可选 TaCZ 兼容 — 安装 TaCZ 后枪械射线包含动画 OBB 并传递部位名

快速开始

  1. 在 Blockbench 的 GeckoLib 模型中新增骨骼，命名 h[a][d][b|s]_名称（如 hdb_body、hads_sword）
  2. 骨骼内放入至少一个 cube，导出 .geo.json 并通过 CNPC Gecko Addon 设置给 NPC
  3. 进入世界看到 NPC，按 F3+B 验证 OBB 线框
  4. 在 NPC 脚本中添加 damaged(e) 读取 e.hitboxName 实现分部位逻辑

安装

  1. 安装 Forge 1.20.1，启动器使用 Java 17
  2. 将四个必要依赖和本模组的 JAR 放入 mods/ 文件夹
  3. 多人游戏：客户端和服务端必须安装相同版本的模组及依赖
  4. 将模型、贴图和血条素材放入资源包，确保所有玩家启用同一资源包

依赖

必要

模组 版本
GeckoLib 4.8.4
CustomNPCs (Goodbird 1.20.1 非官方移植版) —
CNPC Gecko Addon 推荐 CE 1.2.2
CNPC-ImmersiveBoss 0.3.9

可选

模组 用途
TaCZ 枪械射线兼容动画 OBB
CNPC MoreRenderSuppot 修复负尺寸 cube UV 与轮廓剔除（开发辅助）

本模组不能只安装在单侧：模型定义由客户端资源管理器读取，动画 OBB 和血条状态通过网络同步。

兼容性

  • Minecraft 1.20.1, Forge 47.x (dev 47.4.20), Java 17
  • GeckoLib 4.8.4, CustomNPCs Goodbird 1.20.1 移植版, CNPC Gecko Addon CE 1.2.2
  • 完整支持原版弹射物（箭、三叉戟等）；TaCZ 1.1.8-hotfix API 可选兼容

文档