游戏引擎 / 系统课时
把角色做成可复用 Prefab
把角色做成可复用 Prefab
当场景需要生成多个角色时,逐个复制节点容易造成组件遗漏、参数不一致和维护困难。本课将一个配置好的 3D 角色节点保存为 Prefab,再通过编辑器和 TypeScript 实例化多个角色,理解模板、实例与个别修改之间的关系。
学习目标
- 将角色的节点层级、组件与属性保存为可复用 Prefab 资源。
- 使用编辑器和
instantiate()创建相互独立的角色实例。 - 区分修改 Prefab 模板与修改单个实例,正确处理实例位置和生命周期。
先组织角色的节点结构
Prefab 是一种可复用资源,可以保存节点、子节点、组件及其可序列化的属性。实例化时,引擎根据这份模板构造新的节点对象,而不是直接把同一个场景节点重复挂载到多个位置。
先使用简单立方体充当角色外观,把重点放在结构复用上。后续可以将外观替换为正式角色模型,而不用重新规划整个场景的对象组织方式。
在 Cocos Creator 3.8 中创建以下对象:
- 新建空节点,命名为
CharacterRoot,作为角色整体的根节点。 - 在根节点下创建一个 3D Cube 子节点,命名为
Body,作为临时可见外观。 - 将
Body的局部位置设为(0, 0.5, 0),保持单位立方体的默认尺寸,让根节点原点位于角色底部附近。 - 在
CharacterRoot上添加 BoxCollider,将碰撞盒 Center 设为(0, 0.5, 0),Size 设为(1, 1, 1),使碰撞形状与当前外观基本重合。 - 检查
Body的 MeshRenderer 和材质是否正常,再将CharacterRoot的位置保持在原点,作为方便复用的默认姿态。
这样,根节点承担角色整体定位和碰撞配置,Body 子节点承担模型显示。以后可以在根节点添加角色控制脚本,也可以替换子节点外观。当前示例只验证复用与实例化,不涉及动态物理运动,因此无需额外配置 RigidBody。
将节点保存为 Prefab 资源
完成角色结构后,需要把场景里的节点配置转成项目资源,而不仅仅是在当前场景中复制对象。
- 在资源管理器(Assets)中新建
prefabs文件夹。 - 在层级管理器(Hierarchy)中选中
CharacterRoot,将整个根节点拖入prefabs文件夹。 - 确认资源管理器中生成
CharacterRoot.prefab。此时它是可在不同场景中使用的 Prefab 资源。 - 将
CharacterRoot.prefab从 Assets 拖回当前场景的 Hierarchy,创建一个 Prefab 实例。 - 再拖入第二个实例,分别设置不同的位置,确认二者都保留相同的子节点和组件。

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

用脚本一次生成两个角色
手动拖入适合布置固定数量的角色,而敌人生成、关卡重复物体或运行时刷怪通常需要动态实例化。
Cocos Creator 提供 instantiate(),可以根据 Prefab 资源创建新的 Node。创建后需要给新节点指定父节点,并设置其局部位置。
先在 Assets 中创建 TypeScript 组件脚本 CharacterSpawner.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 中暴露资源引用字段,由编辑器保存引用关系。
配置运行环境:
- 创建空节点
Spawner,将其位置和缩放保持为默认值。 - 把
CharacterSpawner脚本挂载到Spawner。 - 将 Assets 中的
CharacterRoot.prefab拖入组件的Character Prefab属性。 - 如果场景中还保留手动创建的角色实例,先删除这些场景实例,避免与运行时生成的角色重复。不要删除 Assets 中的 Prefab 资源。
- 调整场景摄像机,使原点附近的左右两个角色都位于可见范围,然后运行预览。
预期输出:
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 是合适的组织方式。它负责复用对象结构与初始配置,而不是让多个角色共享同一个运行时节点。