Kzeroko KTM2

怪物战斗与动画呈现

由服务端驱动怪物动作与巡逻战术,并同步 GeckoLib 音效及武器轨迹。

更新于 2026/11/16 7 分钟阅读

IsekaiCombatMob 承载共享的怪物配置与各实体独立的战斗状态。哥布林以此实现混合巡逻队、完整攻击段落、防御反应和客户端呈现。

它做什么

服务端选择动作、结算伤害并移动碰撞体。GeckoLib 根据同步状态播放动画,触发音效与轨迹提示。api.client 下的 MobAnimationAPI 是渲染器门面;internal.mob 与 internal.client.mob 下的类型属于项目内部实现,不是外部 API。

运行时模型

配置共享动作定义;每个实体分别持有当前动作、群组、战术和防御状态。同步的动作索引、序号、开始时间和锁定速率,让新开始追踪的客户端定位到当前进度,而不是重播整个动作。

攻击速率取 generic.attack_speed / 4,限制在 0.5–2,并在动作开始时锁定。动画、事件触发、收招与跳跃飞行均使用该速率;中途修改属性会在下一段动作生效。服务端越过事件的编排 tick 时,仅结算一次伤害。

群组设定 40–46 ticks(2–2.3 秒)的刷新期限,由错开的感知任务检查,每次考虑至多 16 个已加载盟友。受袭援助可立即刷新,但有 12 ticks(0.6 秒)的防抖间隔。哥布林群组允许 2 名成员同时进攻;更换领队时保留存活成员的进攻名额。角色职责决定接近位置,孤立且重伤的哥布林会撤退。盾牌依赖朝向和防御容量;闪避实际移动碰撞体,不提供无敌。跳跃落点与闪避路线必须有支撑且无阻挡,不会加载区块。

GoblinEntity 实现 Monster,注册到 SpawnGroup.MONSTER,使用 SoundCategory.HOSTILE,并在和平难度消失。所有装备变体共享哥布林社群标识。无主群组成员复用现有队伍保护解析器,涵盖带来源的投射物和范围法术;施法哥布林的火焰与冰霜不会伤害盟友。玩家归属优先于野生群组关系。

群组中确认发生的死亡也会影响士气。已记录的巡逻队至少损失一半、且剩余成员不超过 2 名时,即使幸存者满血,也会溃逃 400 ticks(20 秒)。离开范围或卸载的成员不算伤亡。已进入出手阶段的攻击会完成,但不会继续连招。再次受到敌人攻击会中止逃跑,并在 100 ticks(5 秒)内禁止低血量撤退,让幸存者能够反击。溃逃时间与近期伤亡记录随存档保留,正在逃跑的领队也不会成为集结目的地。

持盾者会对近期受伤、近战挥击、瞄准自己的拉弓动作及飞来的实体投射物作出反应。投射物检查每 2–3 ticks(0.1–0.15 秒)执行一次,在 24 格内考虑至多 16 个候选,预测与碰撞体的交点,并排除友方、穿透、远离自身或被障碍挡住的箭矢。举盾耗时 4 ticks(0.2 秒)。防御容量为 48,每次格挡消耗 4 + damage × 1.5;成功格挡后会通过正常动作与群组名额检查尝试反击。未受击的格挡在 38 ticks(1.9 秒)后开始收盾,收盾耗时 8 ticks(0.4 秒),之后冷却 22 ticks(1.1 秒)。斧击或容量耗尽会破防 140 ticks(7 秒)。自定义魔法投射物不会被当作可格挡的箭矢。

哥布林近战基础伤害为 6–11,动作速率为 1.15–1.2;咒术师为 1.1。gaitRate 同时将跑步导航与动画加速至 1.15,冲刺加速至 1.2,步行保持 1。咒术师的火焰动作以 0.7 输出使用 Fireball 的 summon 形态;hex_frost 以 0.65 输出召唤 Icicle Lance,hex_rime 则保留 0.45 输出的 Ice Burst。已释放的法阵沿用法术原有的蓄力与发射生命周期。

哥布林尸体移除与 particlize 启动共同读取 EntityDeathFxRegistry 策略。goblin_death 延迟 36 ticks(1.8 秒)后开始分解,分解耗时 32 ticks(1.6 秒),随后继续隐藏模型 32 ticks(1.6 秒)。这一时序覆盖所有变体 76–88 ticks(3.8–4.4 秒)的尸体存留时间,避免特效结束后死亡末帧重新出现。

约定

音效提示

GeckoLib 的 sound_effects 关键帧通过 effect 字符串查询实体的 MobSoundPalette,未知提示会被忽略。哥布林动画使用 step、land、attack 和 swing;服务端状态提供 hurt、death、block、guard_break、alert 和 retreat。

音效配置持有不可变采样列表。每个采样声明声音事件 ID 与 tick 时长,每个提示指定通道、优先级、冷却、音量、概率及听觉范围。混音器为每个发声实体分别保留语音、脚步和装备槽位,避免连续重复采样,并限制附近同时播放的声音。较高优先级可替换较弱声音;死亡会停止该实体的其他通道。脚步要求实体正在地面移动。环境叫声错开调度,战斗期间不播放。

武器采集提示

将以下指令放在 GeckoLib 自定义时间轴的编排 tick 11。时间使用编排 tick,攻击速率缩放前每秒为 20 ticks:

ise:slash weapon 0 3.5 0 -0.5 10 0 11 17
参数类型要求含义
bone字符串必填;字母、数字或下划线要采集的动画骨骼;本例为 weapon。
rootX rootY rootZ有限数值必填;绝对值不超过 1200相对骨骼枢轴的内侧端点,单位为模型像素。
tipX tipY tipZ有限数值必填;绝对值不超过 1200同一坐标空间内的外侧端点。
startTick endTick有限数值必填;0 ≤ start < end ≤ 1200;跨度不超过 80 ticks(4 秒)锁定动作时钟上的采集区间。

桥接层将像素换算为方块单位并镜像模型 X 轴。格式错误的指令和已经结束的区间会被忽略。ise:slash_stop 结束采集;死亡、移除或动作序号变化也会停止采集,已有采样通过共享渲染器自然淡出。

骨骼路径直接选择 isekaiexpansion:default_hybrid,遵守生物特效开关和共享轨迹渲染器的限制。它无需物品堆栈或 Better Combat 攻击元数据,也不触发 ATTACK_ANIMATION_START。

扩展方式

定义共享的 MobProfile,为实体配置战术与音效,并随动画编排提示。服务端效果由 MobAction 回调负责,时间轴指令只负责呈现;不要在客户端关键帧处理器中结算伤害。

模组初始化时调用一次 MobAnimationAPI.initClient()。GeckoLib 渲染器先查询 MobAnimationAPI.tracksWeapon(mob, boneName),仅在需要时执行额外采集。返回 true 时,将动画骨骼枢轴处的当前视图空间矩阵传给 MobAnimationAPI.captureWeapon(mob, boneName, bonePivotMatrix);调用位置必须在从枢轴移回之前。项目示例为 GoblinRenderer.renderRecursively。

验证

在仓库根目录编译并运行隔离的服务端回归测试:

./gradlew.bat compileJava
./gradlew.bat -I tools/mobs/mob-test.gradle runMobTest

测试覆盖动作时序、取消、群组进攻名额、盾牌朝向、实体闪避,以及慢速和快速下朝目标跃击的行为。呈现验证使用 -I tools/mobs/client-review.gradle runGoblinReview 启动隔离客户端,创建允许命令的测试世界,再执行 /goblinreview setup、/goblinreview showcase 和 /goblinreview duel club。/goblinreview report 记录动作、声音派发和有效采集区间;除了报告,还应检查实际渲染的轨迹与姿态。

相关页面

武器斩击特效 说明轨迹配置档、材质与渲染限制。