游戏引擎 / 系统课时
配置关卡检查点与玩家复活
配置关卡检查点与玩家复活
让角色死亡后返回最近激活的检查点,而不是重新加载整关。本例在 Unity 6 中保存初始出生点和当前检查点;死亡时禁止输入并等待动画结束,随后恢复位置、生命值、移动和攻击状态,同时消除镜头残留的跟随延迟。
学习目标
- 在场景中配置可触发的检查点,并确定安全复活姿态。
- 使用死亡状态锁防止重复执行复活流程。
- 验证连续死亡后输入、动画、攻击状态和跟随镜头均恢复正常。
放置出生点与检查点
本例适用于 Unity 6(6000.x)、Input System 1.x 和 Cinemachine 3.1.x;角色根物体上已有 CharacterController、PlayerInput,角色模型上已有 Animator,相机由 Cinemachine Camera 跟随角色子物体 CameraTarget。
- 在
Hierarchy中创建空物体Spawn_00,放在关卡地面上,Transform的位置代表胶囊体脚底的出生位置,旋转决定复活朝向。玩家初始位置也应与它一致。 - 创建
CP_01、CP_02两个空物体,分别放在安全平台;每个添加Box Collider,勾选Is Trigger,设置Center=(0, 1, 0)、Size=(2, 2, 2)。检查点物体的原点仍位于地面,避免复活时把角色传到触发盒中心。 - 给检查点添加
Rigidbody,设置Is Kinematic=true、Use Gravity=false;通过Inspector > Tag > Add Tag...新建Checkpoint,再把该 Tag 分配给两个检查点。检查Edit > Project Settings > Physics的层碰撞矩阵,确保玩家和检查点所在层能够产生触发事件。 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。
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 事件。下面是片段示例:字段属于项目现有的移动脚本,并非独立可运行类。
public void ResetMovementForRespawn()
{
verticalVelocity = 0f; // 防止上一条生命的下落速度继续生效
jumpBufferedUntil = 0f;
jumpRequested = false;
}在已有的战斗脚本中也增加复活重置方法,复位连击、输入缓存、命中去重集合及攻击冷却。以下同样是片段示例,要求该脚本已有对应运行时字段。
public void ResetCombatForRespawn()
{
comboIndex = 0;
queuedAttack = false;
nextAttackTime = 0f;
hitTargets.Clear(); // 不能把上一次攻击的已命中目标带到下一条生命
}将角色移动脚本的 ResetMovementForRespawn() 和战斗脚本的 ResetCombatForRespawn() 都添加到 Reset Gameplay 的两个 UnityEvent 监听项中。若系统还保存受击无敌截止时间、残留移动输入或攻击协程,也在相应重置方法中清空或停止;只重新勾选脚本 Enabled 并不等于状态复位。
连续死亡验收与故障定位
- 在场景未触发检查点时,进入 Play Mode,在
PlayerRespawn组件右上角菜单执行测试/致命伤害;角色播放死亡动画后应出现在Spawn_00,HP=100。 - 走入
CP_01的触发盒,确认 Console 出现检查点日志;先进行一次攻击,在攻击中或冷却期间再次执行致命伤害,确认复活到CP_01且可立即执行新的正常攻击。 - 移动到
CP_02激活后重复测试,并在墙边死亡,检查相机没有从上一死亡位置缓慢拖回、角色没有继续下坠或残留跳跃。连续执行三次,场景中仍应只有一个玩家对象。
首次死亡、激活 CP_01 后再次死亡的预期 Console 关键日志如下,Unity Console 自带的时间和调用栈显示因环境而异:
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 穿透恢复参数掩盖关卡布点错误。