游戏引擎 / 系统课时

用节点层级组织角色结构

用节点层级组织角色结构

角色的模型、碰撞形状、武器挂点和相机焦点若都堆在同一个节点上,调整模型朝向时就容易连带影响移动与碰撞。本课建立一套职责清晰的 3D 角色层级,并验证父子关系,让后续替换模型、接入动画和实现移动时不必反复改整体结构。

学习目标

  • 设计角色根节点、模型容器、碰撞节点和功能挂点的父子关系。
  • 理解局部变换如何继承父节点的位移、旋转和缩放。
  • 用组件脚本检查层级引用,并区分普通挂点与骨骼动画挂点。

让每个节点承担明确职责

推荐以 PlayerRoot 为唯一的角色整体控制入口。移动、转向及角色身份相关脚本属于这一层;美术模型放在 ModelRoot 下,可以独立调整导入模型的朝向、缩放和离地偏移。ColliderNode 承担普通碰撞形状的组织,CameraTarget 提供稳定的相机观察目标。

HandSocket 是模型侧的附件挂点,因此先放在 ModelRoot 下。它会继承模型容器的变换,但不会因为放在模型下就自动跟随手骨骼动画;需要骨骼跟随时,还要绑定 SkeletalAnimation 的 Sockets。

角色根节点与模型、碰撞和挂点的层级关系

在场景中搭建角色层级

  1. 在场景下创建空节点 PlayerRoot,将局部位置设为 (0, 0, 0)、缩放设为 (1, 1, 1),作为整名角色的变换根。
  2. 在它下面创建 ModelRoot、ColliderNode、CameraTarget 三个子节点。将已有角色模型放入 ModelRoot,只在这个容器上校正模型的朝向或美术比例。
  3. 在 ModelRoot 下创建 HandSocket;示范阶段可设置一个临时局部偏移。CameraTarget 可以设在角色头部附近,例如局部位置 (0, 1.6, 0),具体高度应按模型调整。
  4. 若只演示普通碰撞组件,可在 ColliderNode 添加 CapsuleCollider 并调整半径、高度和中心,使形状覆盖角色躯干。场景中的碰撞形状不是运行时自动可见的模型,应使用物理调试显示或编辑器辅助线检查它。

这里所有子节点的位置都是相对于直接父节点的局部位置。移动 PlayerRoot 会带动整棵子树,而修正 ModelRoot 的局部旋转不会改变根节点自己的朝向。不要为了对齐模型直接给角色根节点设置非均匀缩放,这可能让碰撞尺寸和运动计算变复杂。

用脚本验证层级是否正确

创建 PlayerHierarchyCheck.ts 并挂在 PlayerRoot。在属性检查器中把四个对应节点拖入脚本属性槽位。此代码只检查结构,不生成角色节点,也不要求场景具有运动逻辑。

ts
import { _decorator, Component, Node, log } from 'cc';
const { ccclass, property } = _decorator;

@ccclass('PlayerHierarchyCheck')
export class PlayerHierarchyCheck extends Component {
  @property(Node) modelRoot: Node | null = null;
  @property(Node) colliderNode: Node | null = null;
  @property(Node) handSocket: Node | null = null;
  @property(Node) cameraTarget: Node | null = null;

  start(): void {
    const model = this.modelRoot;
    const collider = this.colliderNode;
    const socket = this.handSocket;
    const target = this.cameraTarget;
    if (!model || !collider || !socket || !target) {
      log('[Hierarchy] FAIL: missing reference');
      return;
    }
    // 整体移动的相关分支应直接归属角色根节点。
    const rootsOk = [model, collider, target]
      .every((node) => node.parent === this.node);
    // 普通挂点先归于模型容器;骨骼绑定需另行配置。
    const socketOk = socket.parent === model;
    log(rootsOk && socketOk ? '[Hierarchy] PASS' : '[Hierarchy] FAIL');
  }
}

层级和属性引用都正确时,预期输出:

text
[Hierarchy] PASS

若有属性未绑定,会输出 FAIL: missing reference;若拖错父子节点,则输出 FAIL。它检查的是结构,不代表碰撞行为或动画挂点已经实现。

物理组件与骨骼挂点的边界

普通 CapsuleCollider 只定义碰撞形状;没有合适的刚体或控制器配置,不能自动实现角色走路、滑墙和上台阶。若计划使用 Cocos Creator 3.8 的 CapsuleCharacterController,应把负责运动的控制器放在 PlayerRoot,并按该方案处理主体碰撞形状,避免再叠一套重复的普通角色胶囊碰撞器。

若角色使用骨骼动画,武器应跟随手部关节。可以通过 SkeletalAnimation 的 Sockets 将挂点节点关联到相应骨骼路径,而不是仅依赖 HandSocket 当前的固定偏移。之后更换模型时,只需重新检查骨骼路径与挂点偏移,移动根节点的职责不变。

用变换实验验收设计

先移动 PlayerRoot,确认模型、碰撞节点和相机焦点整体跟随;再仅旋转 ModelRoot,确认角色根的世界位置和相机目标没有被直接改写。最后替换一次模型资源,检查 HandSocket 是否仍位于期望位置、胶囊是否与体型匹配。能够在不修改移动根节点的前提下完成这些操作,说明角色层级的职责划分已经足够清晰。

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

目录与阅读设置

阅读设置

17

记录一个想法

用节点层级组织角色结构

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

登录哪都通