游戏引擎 / 系统课时
用距离判定敌人攻击时机
用距离判定敌人攻击时机
敌人追到玩家身边后,不能只凭距离就连续挥击。本课用攻击距离、水平面向、冷却时间和存活状态决定何时出招,并在动画命中帧再次检查目标。完成后,玩家快速靠近、撤离或死亡都不会触发持续的无效伤害。
学习目标
- 根据距离、面向、冷却和角色状态判断能否开始攻击。
- 用
NavMeshAgent、Animator和 C# 完成追击到攻击的切换。 - 在命中帧复核条件,验证撤离、死亡与攻击打断不会重复扣血。
区分出招条件与实际命中
以 Unity 6(6000.x)、已烘焙 NavMesh、角色根节点位于地面附近的场景为例,先统一下面一组测试参数:
| 参数 | 测试值 | 作用 |
|---|---|---|
水平攻击半径 attackRange |
2.2 m | 玩家进入可出招范围 |
正面半角 halfAngle |
60° | 玩家处于敌人朝向左右各 60° 以内 |
高差容差 heightLimit |
1.0 m | 避免攻击不同楼层目标 |
出招冷却 cooldown |
1.5 s | 从本次出招时刻开始计时 |
攻击锁定 attackLock |
0.9 s | 出招期间不重复追击和触发动画 |
单次伤害 damage |
20 HP | 一个命中事件最多结算一次 |
出招时要求玩家和敌人均存活、敌人没有眩晕、当前不在攻击锁定期,且距离、朝向、冷却全部通过。面向用水平单位向量点积计算:半角 60° 对应阈值约为 0.5。例如玩家位于敌人前方 (1, 0, 1.5) 米处,水平距离约为 1.80 m,点积约为 0.83,满足两个阈值。
出招成功不等于打中。 玩家可能在挥击期间跑出范围,因此动画到达接触帧时必须重新检查距离、朝向和生命状态。NavMeshAgent.remainingDistance 是沿导航路径的剩余距离,不适合作为武器实际命中距离。
实现生命值与敌人攻击组件
先新建 SimpleHealth.cs,将它添加到玩家 Player 和敌人根节点。示例把玩家初始生命值设为 100,后续扣血只经 TakeDamage 进入。
using UnityEngine;
public sealed class SimpleHealth : MonoBehaviour
{
[SerializeField, Min(1)] private int maxHp = 100;
public int CurrentHp { get; private set; }
public bool IsDead => CurrentHp <= 0;
private void Awake() => CurrentHp = maxHp;
public void TakeDamage(int amount)
{
// 死亡后不再扣血,生命值也不能跌破零。
if (amount <= 0 || IsDead) return;
CurrentHp = Mathf.Max(0, CurrentHp - amount);
Debug.Log($"{name} HP={CurrentHp}", this);
}
}预期结果:开始运行时两个角色的 CurrentHp 均为 100;调用一次 TakeDamage(20) 后,对应角色的生命值变为 80。生命值到 0 后 IsDead 为 true,后续伤害不会继续降低生命值。
再新建 EnemyRangeAttack.cs 并挂到敌人根节点;该节点同时需要 Animator、NavMeshAgent 和 SimpleHealth。把 Player 上的 SimpleHealth 拖入脚本的 Player 字段。此例只保留一种普通近战攻击,已有血量系统的项目可以将 SimpleHealth 替换为自己的生命值接口。
using UnityEngine;
using UnityEngine.AI;
[RequireComponent(typeof(NavMeshAgent), typeof(Animator), typeof(SimpleHealth))]
public sealed class EnemyRangeAttack : MonoBehaviour
{
[SerializeField] private SimpleHealth player;
[SerializeField, Min(0.1f)] private float attackRange = 2.2f;
[SerializeField, Range(0f, 180f)] private float halfAngle = 60f;
[SerializeField, Min(0f)] private float heightLimit = 1f;
[SerializeField, Min(0.1f)] private float cooldown = 1.5f;
[SerializeField, Min(0.1f)] private float attackLock = 0.9f;
[SerializeField, Min(1)] private int damage = 20;
[SerializeField] private bool stunned;
private NavMeshAgent agent;
private Animator animator;
private SimpleHealth self;
private bool attacking;
private bool hitResolved;
private float nextAttackTime;
private float unlockTime;
private float nextPathTime;
private static readonly int AttackId = Animator.StringToHash("Attack");
private void Awake()
{
agent = GetComponent<NavMeshAgent>();
animator = GetComponent<Animator>();
self = GetComponent<SimpleHealth>();
agent.stoppingDistance = 1.8f;
agent.updateRotation = false; // 由脚本控制近距离转向
}
private void Update()
{
if (!agent.isOnNavMesh) return;
// 死亡、眩晕、失去目标时不再追击或继续攻击
if (self.IsDead || stunned || player == null || player.IsDead)
{
agent.isStopped = true;
if (attacking)
{
attacking = false;
hitResolved = true;
animator.ResetTrigger(AttackId);
if (!self.IsDead)
animator.CrossFade("Base Layer.Locomotion", 0.08f, 0);
}
return;
}
if (attacking)
{
if (Time.time < unlockTime) return;
attacking = false;
}
if (Time.time >= nextAttackTime && CanHit())
{
attacking = true;
hitResolved = false;
unlockTime = Time.time + attackLock;
nextAttackTime = Time.time + cooldown;
agent.isStopped = true;
animator.SetTrigger(AttackId);
return;
}
agent.isStopped = false;
if (Time.time >= nextPathTime)
{
agent.SetDestination(player.transform.position);
nextPathTime = Time.time + 0.2f;
}
Vector3 flat = player.transform.position - transform.position;
flat.y = 0f;
Vector3 heading = flat.sqrMagnitude <= attackRange * attackRange
? flat : agent.desiredVelocity;
heading.y = 0f;
if (heading.sqrMagnitude > 0.001f)
{
transform.rotation = Quaternion.RotateTowards(
transform.rotation, Quaternion.LookRotation(heading),
360f * Time.deltaTime);
}
}
private bool CanHit()
{
Vector3 delta = player.transform.position - transform.position;
if (Mathf.Abs(delta.y) > heightLimit) return false;
delta.y = 0f;
if (delta.sqrMagnitude < 0.0001f ||
delta.sqrMagnitude > attackRange * attackRange) return false;
// 点积阈值约为 0.5,对应前方左右各 60 度
return Vector3.Dot(transform.forward, delta.normalized) >=
Mathf.Cos(halfAngle * Mathf.Deg2Rad);
}
// 在 Attack 动画的命中帧由 Animation Event 调用
public void AnimationHit()
{
if (!attacking || hitResolved) return;
hitResolved = true; // 挥空也算完成一次命中判定
if (self.IsDead || stunned || player == null || player.IsDead) return;
if (CanHit()) player.TakeDamage(damage);
}
public void SetStunned(bool value) => stunned = value;
}预期结果:敌人从远处追击玩家,进入 2.2 m 且转向正确时触发一次 Attack;触发后 0.9 s 内不重复出招,至少要到 1.5 s 冷却期结束才能开始下一次。若动画在接触帧调用 AnimationHit 且玩家仍在有效范围内,假设场景对象名为 Player,首次成功命中时 Console 输出:
Player HP=80代码每隔 0.2 s 更新一次 SetDestination,而不是每帧重新请求路径;近距离由脚本旋转敌人根节点,避免已经停在玩家旁边却始终背对玩家。SetStunned(true) 可由受击硬直系统调用,恢复时传入 false。相关 API 可参阅 Unity 6 官方 NavMeshAgent.SetDestination 和 Animator.SetTrigger。
配置攻击动画与结算时刻
- 在敌人根节点的 Animator Controller 中创建
Trigger参数Attack,建立Locomotion和Attack状态。Locomotion → Attack过渡条件选Attack,取消Has Exit Time;反向过渡启用Has Exit Time,Exit Time可先设为0.95。确保Attack动画未勾选Loop Time。 - 使用约 0.8 s 的攻击剪辑、播放速度
1。打开Window > Animation > Animation,选中敌人和Attack剪辑,在约0.35 s的武器接触位置添加 Animation Event,函数填AnimationHit。若原始 FBX 剪辑不可编辑,选择 FBX 资源,在 Inspector 的Animation导入设置中编辑事件,或使用可编辑剪辑。 - 确保
Animator和EnemyRangeAttack在同一 GameObject 上,让事件能找到无参数的公开方法AnimationHit。关闭 Animator 的Apply Root Motion,让NavMeshAgent控制位移;若剪辑时长变化,需同步调整attackLock,使其覆盖攻击及退出过渡。

图中 0 s 是每次开始攻击的相对时间,0.35 s 只复核一次命中;攻击锁于 0.9 s 结束,冷却于 1.5 s 结束。hitResolved 会阻止同一轮动画中重复事件造成二次伤害。玩家在挥击后撤退,即使动画继续到命中帧,也应判定为挥空。
验收快速接近、远离与死亡
在 Play 模式下把敌人放在烘焙过的 NavMesh 上,玩家对象名设为 Player,用以下步骤检查:
| 操作 | 应看到的结果 |
|---|---|
| 从约 3.5 m 快速走到敌人前方 2.0 m | 敌人转向后触发一次攻击,不会连发 |
在触发 Attack 后、0.35 s 前跑到 3.0 m 外 |
这一击挥空,生命值不变 |
| 从敌人背后贴近 | 敌人先转身,面向未达标时不直接伤害 |
| 停留在正面 2.0 m 内超过 1.5 s | 每一轮有效接触帧最多扣 20 HP |
| 将玩家 HP 扣到 0,或使敌人眩晕 | 停止导航与后续攻击,不再出现扣血日志 |
若只播放动作却没有伤害,先检查动画事件函数名、组件是否与 Animator 同节点,以及玩家是否在命中帧依然满足判定。若频繁触发攻击,检查 attackLock 是否短于攻击剪辑及其退出过渡总时长,并确认同一敌人没有两个攻击控制脚本。