游戏引擎 / 系统课时

使用范围检测计算近战命中

使用范围检测计算近战命中

本课将一次挥刀拆成范围查询、目标筛选和伤害结算。完成后,角色能在攻击动画的有效命中阶段检测前方敌人;即使敌人有多个碰撞体,或连续多帧进入查询结果,同一次攻击也只会造成一次伤害。

学习目标

  • 使用 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 负责实际扣血。

csharp
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 应挂在同一游戏对象上。

csharp
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 只出现一条扣血日志:

text
Enemy HP=75

配置场景并验收

  1. 打开 Edit > Project Settings > Tags and Layers,在用户层中新增 Damageable。玩家和敌人的受击碰撞体均放在该层;墙体保持其他层。
  2. Player 根对象添加 Health,设 Faction=Player。其带 Animator 的子对象添加 MeleeRangeAttack,并创建 HitOrigin 子对象,设置上述位置。在 Inspector 中设置 Attacker=Player 的 Health、Hit Origin=HitOrigin、Radius=0.8、Damage=25、Target Layers=Damageable。
  3. 将名为 Enemy 的对象放在玩家正前方约 1.25 米处。给它添加 Health(Faction=Enemy、Max Health=100)及躯干 CapsuleCollider;再给其子对象添加一个位于躯干内的 SphereCollider 并勾选 Is Trigger。两个碰撞体的 Layer 都设为 Damageable。
  4. 进入 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,要按可能截断处理并扩大容量或分批查询,不能默认为已覆盖全部敌人。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用范围检测计算近战命中

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

登录哪都通