游戏引擎 / 系统课时

把角色做成可复用 Prefab

把角色做成可复用 Prefab

当场景需要生成多个角色时,逐个复制节点容易造成组件遗漏、参数不一致和维护困难。本课将一个配置好的 3D 角色节点保存为 Prefab,再通过编辑器和 TypeScript 实例化多个角色,理解模板、实例与个别修改之间的关系。

学习目标

  • 将角色的节点层级、组件与属性保存为可复用 Prefab 资源。
  • 使用编辑器和 instantiate() 创建相互独立的角色实例。
  • 区分修改 Prefab 模板与修改单个实例,正确处理实例位置和生命周期。

先组织角色的节点结构

Prefab 是一种可复用资源,可以保存节点、子节点、组件及其可序列化的属性。实例化时,引擎根据这份模板构造新的节点对象,而不是直接把同一个场景节点重复挂载到多个位置。

先使用简单立方体充当角色外观,把重点放在结构复用上。后续可以将外观替换为正式角色模型,而不用重新规划整个场景的对象组织方式。

在 Cocos Creator 3.8 中创建以下对象:

  1. 新建空节点,命名为 CharacterRoot,作为角色整体的根节点。
  2. 在根节点下创建一个 3D Cube 子节点,命名为 Body,作为临时可见外观。
  3. 将 Body 的局部位置设为 (0, 0.5, 0),保持单位立方体的默认尺寸,让根节点原点位于角色底部附近。
  4. 在 CharacterRoot 上添加 BoxCollider,将碰撞盒 Center 设为 (0, 0.5, 0),Size 设为 (1, 1, 1),使碰撞形状与当前外观基本重合。
  5. 检查 Body 的 MeshRenderer 和材质是否正常,再将 CharacterRoot 的位置保持在原点,作为方便复用的默认姿态。

这样,根节点承担角色整体定位和碰撞配置,Body 子节点承担模型显示。以后可以在根节点添加角色控制脚本,也可以替换子节点外观。当前示例只验证复用与实例化,不涉及动态物理运动,因此无需额外配置 RigidBody。

将节点保存为 Prefab 资源

完成角色结构后,需要把场景里的节点配置转成项目资源,而不仅仅是在当前场景中复制对象。

  1. 在资源管理器(Assets)中新建 prefabs 文件夹。
  2. 在层级管理器(Hierarchy)中选中 CharacterRoot,将整个根节点拖入 prefabs 文件夹。
  3. 确认资源管理器中生成 CharacterRoot.prefab。此时它是可在不同场景中使用的 Prefab 资源。
  4. 将 CharacterRoot.prefab 从 Assets 拖回当前场景的 Hierarchy,创建一个 Prefab 实例。
  5. 再拖入第二个实例,分别设置不同的位置,确认二者都保留相同的子节点和组件。

Cocos Creator 编辑器中将角色节点保存为 Prefab 并拖回场景的操作位置

Prefab 资产是模板,拖入场景后得到的是实例。同一个模板可以生成多个实例,每个实例都有自己的节点对象、变换状态和运行时生命周期。

Prefab 模板与多个角色实例的生成及独立修改关系

用脚本一次生成两个角色

手动拖入适合布置固定数量的角色,而敌人生成、关卡重复物体或运行时刷怪通常需要动态实例化。

Cocos Creator 提供 instantiate(),可以根据 Prefab 资源创建新的 Node。创建后需要给新节点指定父节点,并设置其局部位置。

先在 Assets 中创建 TypeScript 组件脚本 CharacterSpawner.ts,写入以下完整代码:

ts
import { _decorator, Component, Prefab, instantiate } from 'cc';

const { ccclass, property } = _decorator;

@ccclass('CharacterSpawner')
export class CharacterSpawner extends Component {
    @property({ type: Prefab })
    characterPrefab: Prefab | null = null;

    start() {
        const prefab = this.characterPrefab;
        if (!prefab) {
            console.warn('请绑定角色 Prefab');
            return;
        }

        const positions = [-2, 2];

        for (let i = 0; i < positions.length; i++) {
            // 每次实例化都会获得一套新的节点对象
            const character = instantiate(prefab);
            character.name = `Character${i + 1}`;

            // 加入场景后再设置相对父节点的位置
            this.node.addChild(character);
            character.setPosition(positions[i], 0, 0);

            console.log(`${character.name} 已创建`);
        }
    }
}

这段脚本不需要在代码中写死 Prefab 资源路径。@property({ type: Prefab }) 会在 Inspector 中暴露资源引用字段,由编辑器保存引用关系。

配置运行环境:

  1. 创建空节点 Spawner,将其位置和缩放保持为默认值。
  2. 把 CharacterSpawner 脚本挂载到 Spawner。
  3. 将 Assets 中的 CharacterRoot.prefab 拖入组件的 Character Prefab 属性。
  4. 如果场景中还保留手动创建的角色实例,先删除这些场景实例,避免与运行时生成的角色重复。不要删除 Assets 中的 Prefab 资源。
  5. 调整场景摄像机,使原点附近的左右两个角色都位于可见范围,然后运行预览。

预期输出:

text
Character1 已创建
Character2 已创建

同时,场景运行时会在 Spawner 下生成两个角色实例。若 Spawner 位于世界原点且没有额外变换,它们的局部位置分别为 (-2, 0, 0) 和 (2, 0, 0),画面中应看到左右分开的两个立方体角色。

预期输出中的名称来自代码主动赋值,不依赖 Prefab 的默认节点名称。若控制台提示未绑定资源,首先检查 Inspector 中的 Character Prefab 字段,而不是修改 instantiate() 的调用方式。

区分模板修改与实例修改

Prefab 复用不仅是减少复制操作,更重要的是确定哪些配置应该统一维护,哪些状态应该由每个角色独立管理。

操作 影响范围 典型用途
编辑并保存 Prefab 资源 更新模板,关联实例中未覆盖的属性可随之同步 调整角色通用结构、碰撞盒或默认组件参数
修改单个场景实例的属性 通常形成该实例的局部覆盖,不改变模板 设置某个角色的位置或特殊参数
运行时修改实例 Node 修改当前实例的运行时状态 移动、隐藏或临时改变角色状态
对实例调用 destroy() 销毁指定实例,不删除 Prefab 资源 角色消失、敌人死亡或清理临时对象

双击 Assets 中的 Prefab 资源,可以进入 Prefab 编辑模式。对模板完成修改并保存后,引用它的实例可以继承相应变化,但已经覆盖的实例属性未必会被新的默认值替换。

例如,角色默认缩放设置在模板中,而某个实例被单独调整了缩放,这个实例就可能保留自己的覆盖值。需要恢复时,应在 Inspector 中检查相应的 Prefab 实例属性及还原操作。

还要区分节点实例与它们引用的资源:两个角色的 Node 对象互相独立,但可能引用同一份 Mesh 或 Material 资产。因此,修改角色节点的位置不会移动另一个角色,直接修改共享材质资源却可能影响多个使用它的对象。

验证复用是否真正生效

完成本课后,可以在编辑器和预览运行中检查以下项目:

  • CharacterRoot.prefab 保存在 Assets 中,且包含预期的节点层级与组件。
  • 同一个 Prefab 能通过拖入操作或 instantiate() 创建多个实例。
  • 运行时两个实例的名称、位置和节点对象彼此独立。
  • 修改某个场景实例的位置,不会把其他实例移动到相同位置。
  • 修改并保存模板中的未覆盖默认属性后,相关实例能够按照 Prefab 同步规则更新。

可以进一步把 positions 改成三个不同的 X 坐标,观察生成数量和排列是否随之变化。这是验证动态实例化最直接的练习。

当角色需要统一修改外观、碰撞结构和默认脚本配置,又必须允许每个角色独立运动与管理状态时,Prefab 是合适的组织方式。它负责复用对象结构与初始配置,而不是让多个角色共享同一个运行时节点。

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

目录与阅读设置

阅读设置

17

记录一个想法

把角色做成可复用 Prefab

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

登录哪都通