游戏引擎 / 系统课时
用动画事件校准伤害生效帧
用动画事件校准伤害生效帧
本课把一次近战攻击的伤害判定放到刀刃实际接触目标的动画时刻,而不是按键瞬间。你将配置 Animation Event,让战斗脚本在事件到达时检查目标,并用一次性结算、状态过滤和取消接口处理过渡与打断。
学习目标
- 在 Unity 6 的攻击剪辑上设置精确的 Animation Event。
- 用动画事件通知战斗组件检测命中,而不是让动画直接修改生命值。
- 验证低帧率、动画混合与提前打断时不会重复造成伤害。
确定事件对应的攻击时刻
假设 Attack1 剪辑时长 0.80 秒、采样率为 60 FPS,挥刀在第 18 帧(约 0.30 秒)接触敌人,就将 AE_ApplyHit 放在 0.30 秒,而不是 0 秒的起手帧。这里的“第 18 帧”指剪辑时间轴的采样位置,不等于游戏运行中的第 18 个渲染帧。
事件仅负责发出“现在检查命中”的信号;实际碰撞查询、目标去重、扣血由 C# 战斗组件负责。一个攻击动作只结算一次;如果需要持续挥砍,应改用开启/关闭命中窗口并在窗口内做连续检测。

在 Unity 6 上添加事件
以下路径适用于 Unity 6 的 Mecanim Animator,不使用旧版 Animation 组件。
- 在 Animator Controller 的 Parameters 中新增 Trigger
Attack;为Locomotion→Attack1过渡添加条件Attack,将Attack1状态的Tag设为Attack,攻击剪辑取消勾选Loop Time。 - 将入场过渡设为约
0.08 s;Attack1→Locomotion勾选Has Exit Time、Exit Time = 0.9,勾选Fixed Duration并设置Transition Duration = 0.08秒,避免在 0.30 秒命中点附近过渡。 - 对可编辑
.anim:选择角色,打开Window > Animation > Animation,切换到Attack1,确认剪辑的Samples(本例为 60),把播放头移到0.30 s,在 Events 行点Add Event,选中标记后在 Inspector 将Function设为AE_ApplyHit。 - 对 FBX 导入剪辑:在 Project 中选中 FBX → Inspector 的
Animation选项卡 → 选中Attack1→ 展开Events→ 将播放头移到 0.30 秒并点Add Event,设置函数后点Apply。不要直接修改只读的导入子剪辑。 - 把接收回调的
MeleeAnimationHit挂在Animator 所在的同一个 GameObject,否则可能出现AnimationEvent has no receiver。官方入口可参见 动画事件 和 导入剪辑事件。

由战斗组件执行一次命中
以下是可运行的双脚本示例,依赖 Unity 6、已安装并启用的 Input System,以及上述 Animator 状态和 Trigger。示例用 J 发起攻击、K 提前取消;正式项目可把已有的 Player/Attack 动作接到公开的 RequestAttack(),移除测试按键代码。
把第一份保存为 MeleeAnimationHit.cs,与 Animator 放在同一个角色节点。hitPoint 指向刀刃附近的子物体;enemyLayers 选择敌人所在物理层;示例采用半径 0.7 m、单次伤害 20。
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.InputSystem;
[RequireComponent(typeof(Animator))]
public sealed class MeleeAnimationHit : MonoBehaviour
{
[SerializeField] private Transform hitPoint;
[SerializeField] private LayerMask enemyLayers;
[SerializeField, Min(0.01f)] private float hitRadius = 0.7f;
[SerializeField, Min(1)] private int damage = 20;
private readonly HashSet<TrainingHealth> hitTargets = new();
private Animator animator;
private bool attackPending, enteredAttack, hitDone;
private static readonly int AttackId = Animator.StringToHash("Attack");
private void Awake() => animator = GetComponent<Animator>();
private void Update()
{
// J 发起单次攻击;K 模拟受击或死亡引起的逻辑取消。
if (Keyboard.current != null && Keyboard.current.jKey.wasPressedThisFrame)
RequestAttack();
if (Keyboard.current != null && Keyboard.current.kKey.wasPressedThisFrame)
CancelAttack();
if (!attackPending) return;
bool current = animator.GetCurrentAnimatorStateInfo(0).IsTag("Attack");
bool next = animator.IsInTransition(0) &&
animator.GetNextAnimatorStateInfo(0).IsTag("Attack");
if (current || next) enteredAttack = true;
else if (enteredAttack) CancelAttack(); // 状态退出时兜底清理
}
public void RequestAttack()
{
if (attackPending || animator.IsInTransition(0) ||
animator.GetCurrentAnimatorStateInfo(0).IsTag("Attack")) return;
attackPending = true;
enteredAttack = false;
hitDone = false;
hitTargets.Clear();
animator.SetTrigger(AttackId);
}
// 动画只通知命中时刻,状态核验和扣血由战斗逻辑执行。
public void AE_ApplyHit(AnimationEvent e)
{
if (!attackPending || hitDone || !e.isFiredByAnimator ||
!e.animatorStateInfo.IsTag("Attack") ||
animator.IsInTransition(0)) return;
hitDone = true; // 即便重播事件或重复配置,也只结算一次
if (hitPoint == null) return;
Collider[] colliders = Physics.OverlapSphere(
hitPoint.position, hitRadius, enemyLayers,
QueryTriggerInteraction.Ignore);
foreach (Collider collider in colliders)
{
TrainingHealth target = collider.GetComponentInParent<TrainingHealth>();
if (target == null || target.transform.root == transform.root ||
!hitTargets.Add(target)) continue;
target.ApplyDamage(damage);
}
Debug.Log($"Hit resolved: {hitTargets.Count}");
}
public void CancelAttack()
{
attackPending = false;
enteredAttack = false;
animator.ResetTrigger(AttackId);
}
private void OnDisable()
{
if (animator != null) CancelAttack();
}
}第二份保存为 TrainingHealth.cs 并挂到敌人根节点;其子物体上至少有一个非 Trigger Collider,并设置在 enemyLayers 包含的层中。
using UnityEngine;
public sealed class TrainingHealth : MonoBehaviour
{
[SerializeField, Min(1)] private int maxHp = 100;
private int currentHp;
private void Awake() => currentHp = maxHp;
public void ApplyDamage(int amount)
{
if (amount <= 0 || currentHp <= 0) return;
currentHp = Mathf.Max(0, currentHp - amount);
Debug.Log($"HP={currentHp}");
}
}预期结果:当敌人在命中时位于 hitPoint 半径 0.7 米内、初始 HP 为 100,按一次 J 后 Console 各出现一行:
HP=80
Hit resolved: 1命中事件是“一次查询”,不是“攻击持续期”。HashSet 避免同一个敌人的多个 Collider 重复扣血,hitDone 避免同一次攻击重复结算。CancelAttack() 还必须由实际的受击、死亡或硬直打断逻辑调用;单按测试键 K 只取消伤害资格,不会自动切换 Animator 状态。
验证低帧率、过渡与打断
把敌人摆在挥刀路径上,聚焦 Game 视图后按键,观察 Animator 状态与 Console。逐个验收:
| 场景 | 操作 | 合格结果 |
|---|---|---|
| 正常命中 | 敌人在 0.30 秒的检测球内,按一次 J |
HP 从 100 到 80,日志 Hit resolved: 1 仅一条 |
| 空挥 | 移走敌人,再按 J |
Hit resolved: 0,敌人 HP 不变 |
| 低帧率 | 测试时临时设 QualitySettings.vSyncCount = 0; 和 Application.targetFrameRate = 15; |
攻击跨过事件时间时仍至多结算一次;恢复帧率设置后重测 |
| 混合过渡 | 将攻击状态入场/离场过渡保持为 0.08 秒,连续观察多轮攻击 | 事件只在合法 Attack 状态、非过渡期间结算 |
| 提前取消 | 按 J 后在 0.30 秒前按 K;实际项目同时触发 Hit/Dead 转换 |
即使旧攻击剪辑的事件后来到达,也不再扣血 |
如果挥剑很快、同一次攻击需要多段命中或敌人在单帧间穿过检测范围,单个 OverlapSphere 可能漏检。此时应改成动画事件标记“开启/关闭命中窗口”,在窗口内按游戏逻辑持续做体积扫描,并用每次攻击的目标去重集合防止重复伤害。