游戏引擎 / 系统课时
使用范围检测计算近战命中
使用范围检测计算近战命中
本课将一次挥刀拆成范围查询、目标筛选和伤害结算。完成后,角色能在攻击动画的有效命中阶段检测前方敌人;即使敌人有多个碰撞体,或连续多帧进入查询结果,同一次攻击也只会造成一次伤害。
学习目标
- 使用
Physics.OverlapSphere、LayerMask与阵营字段筛选有效目标。 - 使用
HashSet<Health>按角色而非碰撞体去重。 - 将检测绑定到动画命中窗口,并验证重复扫描只扣一次血。
确定命中区域与筛选顺序
在 Unity 6 的三维物理场景中,Physics.OverlapSphere 返回接触或处于球形区域内的所有 Collider,而非按敌人数量返回结果。一名敌人若有躯干和头部两个碰撞体,就可能在同次查询中出现两次。
在玩家面向本地 +Z 的前提下,于角色模型下创建空对象 HitOrigin,设置局部坐标为 (0, 1.0, 0.9),查询半径设为 0.8 米。选中攻击组件时可在 Scene 视图看到线框球;球体的位置应覆盖挥刀前方,而不是以角色脚底为圆心。
| 筛选项 | 本例设置 | 作用 |
|---|---|---|
targetLayers |
Damageable 层 |
排除地面、墙壁等无关碰撞体 |
QueryTriggerInteraction |
Collide |
同时识别普通碰撞体与 Trigger 受击盒 |
Faction |
玩家为 Player,敌人为 Enemy |
跳过自己及同阵营角色 |
HashSet<Health> |
每次挥刀开始时清空 | 多碰撞体、多帧仅结算一次 |

编写生命值与命中检测脚本
先创建 Assets/Scripts/Health.cs。生命值组件放在角色根对象,子对象上的多个受击碰撞体共用同一份生命值。下面的 Faction 枚举用于区分玩家和敌人,TakeDamage 负责实际扣血。
using UnityEngine;
public enum Faction { Player, Enemy }
public sealed class Health : MonoBehaviour
{
[SerializeField] private Faction faction = Faction.Enemy;
[SerializeField, Min(1)] private int maxHealth = 100;
private int hp;
public Faction Team => faction;
public bool IsAlive => hp > 0;
private void Awake() => hp = maxHealth;
public void TakeDamage(int amount)
{
// 无效伤害或已死亡时,不重复结算。
if (amount <= 0 || !IsAlive) return;
hp = Mathf.Max(0, hp - amount);
Debug.Log($"{name} HP={hp}");
}
}再创建 Assets/Scripts/MeleeRangeAttack.cs。脚本在命中窗口开启期间逐帧查询,但 HashSet 仅在新一轮攻击开始时清空;判重键是 Health 实例,不是 Collider。脚本与触发动画事件的 Animator 应挂在同一游戏对象上。
using System.Collections.Generic;
using UnityEngine;
public sealed class MeleeRangeAttack : MonoBehaviour
{
[SerializeField] private Health attacker;
[SerializeField] private Transform hitOrigin;
[SerializeField, Min(0.1f)] private float radius = 0.8f;
[SerializeField, Min(1)] private int damage = 25;
[SerializeField] private LayerMask targetLayers;
private readonly HashSet<Health> hitThisSwing = new();
private bool hitWindowOpen;
private void Awake()
{
if (attacker == null)
attacker = GetComponentInParent<Health>();
}
private void Update()
{
if (hitWindowOpen) Scan();
}
// 一次挥刀只清空一次集合,不能在每帧 Scan 时清空。
public void OpenHitWindow()
{
if (hitWindowOpen) return;
hitThisSwing.Clear();
hitWindowOpen = true;
}
public void CloseHitWindow() => hitWindowOpen = false;
private void Scan()
{
if (attacker == null || hitOrigin == null) return;
Collider[] hits = Physics.OverlapSphere(
hitOrigin.position, radius, targetLayers,
QueryTriggerInteraction.Collide);
foreach (Collider collider in hits)
{
// 让多个子碰撞体共享根对象上的 Health。
Health target = collider.GetComponentInParent<Health>();
if (target == null || target == attacker ||
target.Team == attacker.Team || !target.IsAlive)
continue;
if (!hitThisSwing.Add(target)) continue;
target.TakeDamage(damage);
}
}
// 模拟一次攻击中的两次查询,方便不接动画先验收。
[ContextMenu("Test One Swing")]
private void TestOneSwing()
{
OpenHitWindow();
Scan();
Scan();
CloseHitWindow();
}
private void OnDisable()
{
hitWindowOpen = false;
hitThisSwing.Clear();
}
private void OnDrawGizmosSelected()
{
if (hitOrigin == null) return;
Gizmos.color = Color.cyan;
Gizmos.DrawWireSphere(hitOrigin.position, radius);
}
}预期结果:按下节配置场景,进入 Play 模式后首次执行一次 Test One Swing,尽管敌人有两个碰撞体且代码连续查询两次,Console 只出现一条扣血日志:
Enemy HP=75配置场景并验收
- 打开
Edit > Project Settings > Tags and Layers,在用户层中新增Damageable。玩家和敌人的受击碰撞体均放在该层;墙体保持其他层。 Player根对象添加Health,设Faction=Player。其带Animator的子对象添加MeleeRangeAttack,并创建HitOrigin子对象,设置上述位置。在 Inspector 中设置Attacker=Player的Health、Hit Origin=HitOrigin、Radius=0.8、Damage=25、Target Layers=Damageable。- 将名为
Enemy的对象放在玩家正前方约1.25米处。给它添加Health(Faction=Enemy、Max Health=100)及躯干CapsuleCollider;再给其子对象添加一个位于躯干内的SphereCollider并勾选Is Trigger。两个碰撞体的 Layer 都设为Damageable。 - 进入 Play 模式,使用
MeleeRangeAttack组件右上角菜单中的Test One Swing。首次测试应只输出Enemy HP=75;再次执行代表另一轮挥刀,应只新增Enemy HP=50。
还要做三项反例检查:把敌人的 Faction 改为 Player 后不应扣血;移出球形范围后不应扣血;把敌人所有受击碰撞体移出 Damageable 层后不应扣血。若一直未命中,优先核查子碰撞体的 Layer、HitOrigin 位置、Inspector 引用和 Trigger 查询参数。
绑定动画有效帧并处理边界
在 Window > Animation > Animation 中打开长度为 0.6 秒的攻击片段,在事件轨道的 0.18 秒与 0.36 秒分别添加 Animation Event,函数依次选 OpenHitWindow 和 CloseHitWindow。这是示例命中窗口,最终应按刀锋实际经过敌人的动作帧调整。窗口内每帧都可能查询到敌人,但同一轮攻击的 HashSet 不会重复放行。
如果攻击被受击、闪避或死亡状态提前打断,状态切换逻辑必须调用 CloseHitWindow();不要只依赖片段末尾的事件,否则旧窗口可能保持开启。OverlapSphere 不检查墙体遮挡,也不限制严格扇形角度,若设计要求“隔墙不能砍中”或“只打正前方”,须在去重前增加遮挡检测或角度过滤。
Physics.OverlapSphere 每次调用都会分配数组;敌人密集且每帧查询时,可换用复用 Collider[] 的 Physics.OverlapSphereNonAlloc。注意它在缓冲区满时不会自动扩容:例如容量为 32 且返回数也是 32,要按可能截断处理并扩大容量或分批查询,不能默认为已覆盖全部敌人。