预制件
在 YAHAHA Studio(Studio)中,预制件(Prefabs)作为模板使用。
概述
预制件帮助创作者创建、配置和存储 Yahaha 对象(包括所有组件、属性值和子对象),作为可复用资源。它们可快速构建、管理和复用项目中的模块化组件,避免重复劳动并保持一致性。
本指南涵盖预制件核心流程:
创建预制件
预制件是游戏对象或组件(如角色、道具、环境元素)的预设模板,保存对象结构、外观、所有组件、属性和子对象。修改原始预制件后,所有实例会自动更新,确保一致性并节省开发时间。
应用场景
预制件在游戏开发中的常见用途包括:
- 快速生成多个类似对象,如敌人、收集品或道具
- 通过组装建筑、地形、UI 元素等预制件构建模块化场景
- 团队协作时共享标准化资源
- 游戏运行时动态生成对象
- 通过嵌套预制件构建复杂对象
创建预制件资源
创建预制件方法:
- 在场景中选中对象,右键选择“创建新预制件”
- 选中对象,点击“更多”打开 属性窗口,点击
,选择“创建新预制件”
创建后可在 我的资源 > 预制件 下找到。

为便于管理,可通过 ,选择“分组管理”,将预制件分配到预制件分组。
创建预制件实例
拖拽资源创建实例
在场景中放置预制件实例时,可在 我的资源 > 预制件 下找到预制件,拖拽到场景中。
实例会继承预制件资源的所有组件和属性值,便于高效复用(如放置多个士兵模型)。
运行时实例化预制件(仅 Party Game Kit)
在 Party 游戏中运行时实例化预制件:
-
在预制件资源上启用 Spawn used。

-
使用合适的 YaEntity Spawn 方法,在游戏过程中动态生成预制件,控制位置、旋转和缩放。
编辑预制件
可在场景编辑器或预制件模式(仅 Horror)中编辑预制件。编辑预制件资源会修改其根 Yahaha 对象,自动同步所有实例。
在场景编辑 器中编辑
选中预制件资源或实例,在 属性窗口调整属性。对预制件资源的修改会即时同步到所有实例。
编辑预制件实例不会影响其他实例或根资源。可使用“还原所有更改”重置实例为预制件状态,或“应用更改到预制件资源”将修改同步到所有实例。

对立方体预制件的材质更改会自动同步到所有实例
在预制件模式下编辑(仅 Horror Game Kit)
右键预制件或点击 ,选择“编辑预制件资源”进入 预制件模式,这是类似场景编辑 器的专用编辑界面,便于专注编辑预制件。


嵌套预制件
预制件可包含其他预制件作为嵌套实例。嵌套预制件既保持自身与资源的链接,又作为父预制件的一部分,便于通过组合小型预制件构建复杂模块化对象。
拆解预制件实例
拆解会将预制件实例转换为普通 Yahaha 对象,断开与原预制件资源的链接。
在场景资源浏览器右键实例,或在实例 属性窗口点击 ,选择“拆解”。
如需彻底移除所有预制件链接,选择“完全拆解预制件”。
