游戏引擎 / 系统课时

配置关卡检查点与玩家复活

配置关卡检查点与玩家复活

让角色死亡后返回最近激活的检查点,而不是重新加载整关。本例在 Unity 6 中保存初始出生点和当前检查点;死亡时禁止输入并等待动画结束,随后恢复位置、生命值、移动和攻击状态,同时消除镜头残留的跟随延迟。

学习目标

  • 在场景中配置可触发的检查点,并确定安全复活姿态。
  • 使用死亡状态锁防止重复执行复活流程。
  • 验证连续死亡后输入、动画、攻击状态和跟随镜头均恢复正常。

放置出生点与检查点

本例适用于 Unity 6(6000.x)、Input System 1.x 和 Cinemachine 3.1.x;角色根物体上已有 CharacterController、PlayerInput,角色模型上已有 Animator,相机由 Cinemachine Camera 跟随角色子物体 CameraTarget。

  1. 在 Hierarchy 中创建空物体 Spawn_00,放在关卡地面上,Transform 的位置代表胶囊体脚底的出生位置,旋转决定复活朝向。玩家初始位置也应与它一致。
  2. 创建 CP_01、CP_02 两个空物体,分别放在安全平台;每个添加 Box Collider,勾选 Is Trigger,设置 Center=(0, 1, 0)、Size=(2, 2, 2)。检查点物体的原点仍位于地面,避免复活时把角色传到触发盒中心。
  3. 给检查点添加 Rigidbody,设置 Is Kinematic=true、Use Gravity=false;通过 Inspector > Tag > Add Tag... 新建 Checkpoint,再把该 Tag 分配给两个检查点。检查 Edit > Project Settings > Physics 的层碰撞矩阵,确保玩家和检查点所在层能够产生触发事件。
  4. CameraTarget 保持为角色根节点的子物体,并在 Cinemachine Camera 的 Tracking Target 中引用同一个对象。检查点前方预留至少一个胶囊体直径的净空,不要与墙或敌人重叠。

本例只在当前关卡运行期间保存最近触发的检查点 Transform。跨场景存档应保存稳定的检查点 ID,并在加载关卡后重新查找场景物体,不能直接持久化 Transform 引用。

规定死亡和复活的执行顺序

当生命值从正数减至 0,先设置 dead=true 并禁用 PlayerInput,随后暂停移动和攻击脚本,触发 Die 动画。等待 Death 状态播放完毕后,临时禁用 CharacterController 完成传送,再清除速度、跳跃缓冲、连击队列和攻击冷却,最后恢复生命值与输入。重复伤害因为 dead 锁不会开启第二条协程。

检查点激活与死亡复活状态流转

在 Animator Controller 的 Base Layer 中创建 Locomotion(默认状态)与 Death。添加 Die(Trigger)参数,设置 Any State → Death 的条件为 Die、关闭 Has Exit Time,Transition Duration 设为 0.05;死亡片段取消 Loop Time,Death 不配置自动返回过渡。这样脚本才能通过 normalizedTime >= 1 判断一次完整播放;角色使用脚本移动时关闭 Apply Root Motion。

编写复活脚本

在 Assets/Scripts 下创建 PlayerRespawn.cs,把以下完整脚本挂到玩家根物体。本例由脚本管理血量以便独立测试;已有生命值组件的项目,应把死亡协程入口整合进现有生命组件,避免维护两份互相矛盾的 hp。

csharp
using System.Collections;
using Unity.Cinemachine;
using UnityEngine;
using UnityEngine.Events;
using UnityEngine.InputSystem;

[RequireComponent(typeof(CharacterController), typeof(PlayerInput))]
public sealed class PlayerRespawn : MonoBehaviour
{
    [SerializeField] private Transform spawnPoint;
    [SerializeField] private Transform trackingTarget;
    [SerializeField] private Animator animator;
    [SerializeField] private MonoBehaviour[] pauseOnDeath = new MonoBehaviour[0];
    [SerializeField] private UnityEvent resetGameplay = new UnityEvent();
    [SerializeField, Min(1)] private int maxHealth = 100;

    private CharacterController controller;
    private PlayerInput input;
    private Transform currentPoint;
    private int hp;
    private bool dead;

    private void Awake()
    {
        controller = GetComponent<CharacterController>();
        input = GetComponent<PlayerInput>();
        if (!spawnPoint || !trackingTarget || !animator)
        {
            Debug.LogError("请配置出生点、镜头跟随目标和 Animator", this);
            enabled = false;
            return;
        }
        currentPoint = spawnPoint;
        hp = maxHealth;
    }

    private void OnTriggerEnter(Collider other)
    {
        if (dead || !other.CompareTag("Checkpoint")) return;
        currentPoint = other.transform;
        Debug.Log($"检查点:{currentPoint.name}");
    }

    public void ApplyDamage(int amount)
    {
        if (dead || amount <= 0) return;
        hp = Mathf.Max(0, hp - amount);
        Debug.Log($"HP={hp}");
        if (hp == 0) StartCoroutine(DieAndRespawn());
    }

    [ContextMenu("测试/致命伤害")]
    private void TestLethalDamage() => ApplyDamage(maxHealth);

    private IEnumerator DieAndRespawn()
    {
        dead = true; // 锁定死亡入口,避免多次伤害启动多个复活流程
        input.DeactivateInput();
        bool[] oldEnabled = new bool[pauseOnDeath.Length];
        for (int i = 0; i < pauseOnDeath.Length; i++)
        {
            MonoBehaviour script = pauseOnDeath[i];
            if (!script || script == this) continue;
            oldEnabled[i] = script.enabled;
            script.enabled = false;
        }

        animator.SetTrigger("Die");
        float timeout = 1f;
        while (!animator.GetCurrentAnimatorStateInfo(0).IsName("Base Layer.Death")
               && timeout > 0f)
        {
            timeout -= Time.deltaTime;
            yield return null;
        }
        if (animator.GetCurrentAnimatorStateInfo(0).IsName("Base Layer.Death"))
        {
            while (animator.GetCurrentAnimatorStateInfo(0).normalizedTime < 1f)
                yield return null;
        }
        else
        {
            Debug.LogWarning("未进入 Death 状态;检查 Die 过渡", this);
        }

        Vector3 oldTargetPosition = trackingTarget.position;
        controller.enabled = false; // 传送期间暂停胶囊碰撞
        transform.SetPositionAndRotation(currentPoint.position, currentPoint.rotation);
        controller.enabled = true;

        resetGameplay.Invoke(); // 在恢复脚本之前清空运动和战斗运行态
        animator.Rebind();
        animator.Play("Base Layer.Locomotion", 0, 0f);
        animator.Update(0f);
        CinemachineCore.OnTargetObjectWarped(
            trackingTarget, trackingTarget.position - oldTargetPosition);
        CinemachineCore.ResetCameraState();

        hp = maxHealth;
        for (int i = 0; i < pauseOnDeath.Length; i++)
        {
            MonoBehaviour script = pauseOnDeath[i];
            if (script && script != this) script.enabled = oldEnabled[i];
        }
        dead = false;
        input.ActivateInput();
        Debug.Log($"已复活:{currentPoint.name} HP={hp}");
    }
}

预期结果:在 Inspector 连接好引用和 Animator 后,执行组件菜单中的致命伤害测试,Console 应依次记录 HP=0 与 已复活:Spawn_00 HP=100;进入检查点后再次测试,则恢复到新位置。

在 PlayerRespawn 的 Inspector 中,把 Spawn Point 指向 Spawn_00,Tracking Target 指向 CameraTarget,Animator 指向角色模型;Pause On Death 放入现有角色移动与近战攻击脚本,不要放入 PlayerRespawn 本身。Max Health 设为 100。镜头 API 使用的是 Cinemachine 3.1.x 的 Unity.Cinemachine 命名空间;Cinemachine 2.x 不能直接使用这份导入语句。

清除运动与近战运行状态

CharacterController.enabled 恢复后不会自动清零你自己保存的竖直速度、跳跃请求、连击索引或冷却时间。给已有的移动脚本增加公开重置方法,并把它绑定到 Reset Gameplay 事件。下面是片段示例:字段属于项目现有的移动脚本,并非独立可运行类。

csharp
public void ResetMovementForRespawn()
{
    verticalVelocity = 0f;       // 防止上一条生命的下落速度继续生效
    jumpBufferedUntil = 0f;
    jumpRequested = false;
}

在已有的战斗脚本中也增加复活重置方法,复位连击、输入缓存、命中去重集合及攻击冷却。以下同样是片段示例,要求该脚本已有对应运行时字段。

csharp
public void ResetCombatForRespawn()
{
    comboIndex = 0;
    queuedAttack = false;
    nextAttackTime = 0f;
    hitTargets.Clear();           // 不能把上一次攻击的已命中目标带到下一条生命
}

将角色移动脚本的 ResetMovementForRespawn() 和战斗脚本的 ResetCombatForRespawn() 都添加到 Reset Gameplay 的两个 UnityEvent 监听项中。若系统还保存受击无敌截止时间、残留移动输入或攻击协程,也在相应重置方法中清空或停止;只重新勾选脚本 Enabled 并不等于状态复位。

连续死亡验收与故障定位

  1. 在场景未触发检查点时,进入 Play Mode,在 PlayerRespawn 组件右上角菜单执行 测试/致命伤害;角色播放死亡动画后应出现在 Spawn_00,HP=100。
  2. 走入 CP_01 的触发盒,确认 Console 出现检查点日志;先进行一次攻击,在攻击中或冷却期间再次执行致命伤害,确认复活到 CP_01 且可立即执行新的正常攻击。
  3. 移动到 CP_02 激活后重复测试,并在墙边死亡,检查相机没有从上一死亡位置缓慢拖回、角色没有继续下坠或残留跳跃。连续执行三次,场景中仍应只有一个玩家对象。

首次死亡、激活 CP_01 后再次死亡的预期 Console 关键日志如下,Unity Console 自带的时间和调用栈显示因环境而异:

text
HP=0
已复活:Spawn_00 HP=100
检查点:CP_01
HP=0
已复活:CP_01 HP=100

若检查点不生效,先检查 Tag、触发 Collider、运动学 Rigidbody 与 Physics 层矩阵;若死亡后一直不复活,检查 Death 片段是否关闭循环、Animator 是否持续更新,以及流程期间 Time.timeScale 是否被设为 0;若复活后不能攻击,检查 Reset Gameplay 的监听项和实际冷却字段。传送点若位于墙内或悬空,先移动 CP_01 物体原点并重新测试,不能靠提高 CharacterController 穿透恢复参数掩盖关卡布点错误。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置关卡检查点与玩家复活

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

登录哪都通