游戏引擎 / 系统课时

用动画事件校准伤害生效帧

用动画事件校准伤害生效帧

本课把一次近战攻击的伤害判定放到刀刃实际接触目标的动画时刻,而不是按键瞬间。你将配置 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 组件。

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

Animation 窗口的事件编辑位置

由战斗组件执行一次命中

以下是可运行的双脚本示例,依赖 Unity 6、已安装并启用的 Input System,以及上述 Animator 状态和 Trigger。示例用 J 发起攻击、K 提前取消;正式项目可把已有的 Player/Attack 动作接到公开的 RequestAttack(),移除测试按键代码。

把第一份保存为 MeleeAnimationHit.cs,与 Animator 放在同一个角色节点。hitPoint 指向刀刃附近的子物体;enemyLayers 选择敌人所在物理层;示例采用半径 0.7 m、单次伤害 20。

csharp
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 包含的层中。

csharp
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 各出现一行:

text
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 可能漏检。此时应改成动画事件标记“开启/关闭命中窗口”,在窗口内按游戏逻辑持续做体积扫描,并用每次攻击的目标去重集合防止重复伤害。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用动画事件校准伤害生效帧

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通