使用 Party Game Kit 创建收集物品游戏
本教程适用于 Party Game Kit 用户。
Yahaha 是一个低代码、用户生成内容（UGC，User Generated Content）平台，帮助 创作者构建、编辑和分享 3D 互动体验。本教程将带你使用 Party Game Kit 创建收集物品项目，并学习编辑器的基础操作，包括如何添加资源、添加可收集物品、调整天空盒并分享你的项目。完成后，你可以与朋友一起游玩冒险游戏并探索世界。
想了解 Party Game Kit 及其与 Horror Game Kit 的区别，请参见 常见问题（FAQ）。
完成时间
20-30 分钟
你将学到
开始前准备
创建 Yahaha 账号
- 访问我们的 注册页面（Sign up page） 创建 YAHAHA 账号。
你必须年满 16 岁才能注册 YAHAHA 账号。
- 检查邮箱获取验证 码。
- 在 注册页面（Sign up page） 输入验证码完成账号验证。
下载并安装 Yahaha 安装包
- 前往 下载页面（Download page），点击 下载 MacOS 版（Download for MacOS） 或 下载 Windows 版（Download for Windows） 获取安装包。
- 下载完成后，打开
YahahaInstaller.msi文件进行安装。 - 在桌面点击 Yahaha 图标启动。
创建新项目
-
使用 Yahaha 账号登录，进入 YAHAHA Desktop（Desktop），这是管理项目和游玩所有 Yahaha 游戏的中心。
-
在 创建（Create） 标签页，选择 + 创建游戏（+ Create Game） > Party Game 开始下载 Party Game Kit。
-
下载完成后，有四种方式可开始新的派对项目：
- 基础模板（Base template）：包含最简环境，适合从零搭建。
- 美术模板（Art templates）：自带美术资源和场景。
- 玩法框架（Gameplay frameworks）：包含完整场景和玩法功能。
- 生成式 AI（Generative AI）：根据用户提示生成场景或故事，详见 AI助手。
 |  |
| 通过 + 创建游戏（+ Create Game） > Party game 创建 | 通过 AI 生成游戏（Build Game with AI） > Party game 创建 |
项目创建后，将在 YAHAHA Studio（Studio，编辑器）中打开，这是设计游戏世界的编辑器。
Studio界面关键区域
Studio 布局围绕最重要的窗口组织。我们从基础编辑器界面的五个关键区域开始介绍。
Studio界面
场景、地形、故事与界面编辑器
Studio 布局中心有四个主编辑器——你构建世界的交互窗口：
- 场景编辑器（Scene Editor）：用于操作对象并从多个角度查看场景。默认至少有一个名为 Respawn points 的 YahahaObject，作为玩家出生点。
- 地形编辑器（Terrain Editor）：雕刻和修改地形，塑造世界地貌。
- 故事编辑器（Story Editor）：使用生成式 AI 构建任务和分支剧情。
- 界面编辑器（Interface Editor）：设计和自定义项目的用户界面（UI，User Interface）元素。
场景导航控制（Scene navigation controls）
在 Studio 中工作时，调整视角和导航场景很重要。可使用以下操作：
- 用 左键（left mouse button） 选择 YahahaObject 并按 F 聚焦。
- 按住 右键（right mouse button） 旋转视角。
- 用 滚轮（scroll wheel） 拉近或拉远视角。
- 按住 中键（middle mouse button） 平移视角。
- 用 WASD 移动视角左右前后。
- 用 Q/E 上下移动。
- 按 Shift 加速移动。
资源管理窗口（Explorer windows）
对象资源管理器（Object Explorer） 用于组织项目中的所有内容。窗口中出现的所有内容都称为 YahahaObject。利用资源管理器选择、分组和管理场景内对象，实现高效编辑和导航。
设置资源浏览器（Settings Explorer） 是设计和编辑关键游戏元素的中心。从这里可以创建和配置物品、任务和对话，还能调整环境设置、摄像机控制、游戏模式、角色属性等。
属性窗口（Properties window）
属性窗口（Properties window） 用于查看和配置 YahahaObject 的详细信息。选择对象并点击右上角 
更多（More） 图标，即可在此窗口看到其组件（component）。组件描述了对象的属性和行为。
资源浏览器（Asset browsers）
资产箱（Asset Box） 包含所有可用于项目的资源，包括从资源库（Asset Library）添加的和自动包含的资源。
我的资源（My Resources） 用于查找你导入的所有资源，包括 Unity、本地路径和你自己的创作。还包含用于创建和管理物品、装备、载具等玩法元素的游戏库（gameplay library）。
使用 
搜索（Search） 按钮，通过输入关键字或资源名，可在**资产箱（Asset Box）和我的资源（My Resources）**中快速定位资源。
工具栏（Toolbar）
使用工具栏按钮可操作所有 YahahaObject，例如抓取、移动、旋转、缩放选中对象，或沿某一轴对齐。详见 操作 YahahaObject。
试玩（Playtest）
右上角点击 
试玩（Play） 图标进入试玩模式（Play Mode），可实时操控角色体验游戏。
如需测试多人玩法，点击 
下拉箭头切换为 测试模式（Test Mode），再点击 
齿轮图标进行测试。此时会为每个玩家打开独立窗口，便于观察多玩家交互。
建议经常试玩并及时保存进度，确保一切如预期运行。
向现有项目添加资源
从资产库添加资源
Yahaha 资产库（Asset Library）提供了丰富的免费和商业资源，由官方和社区成员创作。你可以按 模型（Models）、音频（Audio）、特效（Effects）、天空（Sky）、逻辑（Logic）、动画片段（Animation Clips）、材质（Materials）、贴花（Decals） 等分类浏览，或直接搜索关键字。
添加资源到场景：
- 点击
进入资源库。
- 找到资源后悬停，点击 在场景中查看（View in Scene） 即可添加。
或点击 
先保存，再在资产箱中找到并双击添加。
资源添加后，可在属性窗口调整其尺寸（X、Y、Z 轴）、位置坐标，或用 编辑工具（如缩放、抓取）操作。
从零创建资源
在 对象资源管理器（Object Explorer） 中点击 +，选择 3D 对象（如立方体）即可新建。
例如将 X、Z 设为 3，Y 设为 0.5，可做成 3x3 平面。更换材质为岩石后即为崎岖地面。
将其 Z 轴旋转 90°，即可变为墙体。
导入外部资源
如需导入自有资源，进入 我的资源（My Resources） > 已上传（Uploaded），点击 上传（Upload） 按钮。详见 外部资源。
如需用 AI 生成 3D 模型，可在工具栏找到 Yahaha 的生成式 AI助手（AI assistant），选择 生成 3D 对象（Generate 3D objects）。详见 AI 生成 3D 模型。
制作可收集物品
- 在资源库添加模型到你的资源中，作为游戏内可收集物品。
- 进入 我的资源（My Resources） > 游戏库（Gameplay library） > 物品（Items），点击 + 立即创建（+ Create Now） 开始创建可收集物品，弹出设置窗口。
- 在 创建物品（Create item） 窗口填写物品信息：
-
选择模型并命名。
-
填写简短描述，玩家可在背包中看到。
-
选择物品分类，如普通物品、消耗品（Consumables）、材料（Materials），或自定义分类。
-
设置玩家拾取方式：自动、手动，或跟随 设置（Settings） > 通用（General） > 背包（Inventory） 的全局设置。
-
设置玩家可收集数量及单格可叠加数量。
-
可设置物品是否影响玩家属性（如生命、攻击、防御、速度等）。 详细说明见 创建物品。
- 在 我的资源（My Resources） 找到可收集物品，点击放置到合适位置。
游戏内收集物品
玩家靠近可收集物品时，旁边会出现物品提示。如果拾取模式为 自动（Auto），物品会自动收集；如为 手动（Manual），需按住 Alt（Windows）或 Option（macOS）并点击提示收集。
收集后，左侧会弹出确认消息，物品加入玩家背包。点击右上角 背包（INVENTORY） 图标可打开背包。
在背包中可查看所有已收集物品，点击可查看详情并选择使用。
（可选）设置自动掉落机制
你已学会创建物品并放置到场景供玩家收集。许多游戏中，玩家通过与特定对象交互或经过特定位置收集掉落物（如与树互动采集水果）。掉落机制（drop mechanic）可实现免操作收集。在派对项目中，你可设置自动掉落点。 创建掉落点方法：
- 选中场景中目标对象，点击 + 功能（+ Feature） > 掉落（Loot Drop） 添加掉落组件。
- 配置触发与掉落内容：
- 触发对象默认 自身（Self），条件为 启动时（On Start），即游戏开始自动掉落。更多触发详见 触发器（Trigger）。
- 掉落设置：
- 重复（Repeat） 设为 首次进入房间（1st time in Room），仅首次进入场景时掉落。
- 过期（Expire） 设为 5 分钟（5min），物品仅存在 5 分钟。
- 掉落模式（Drop Mode） 设为 指定（Specific）。
- 指定掉落物：
- 点击 + 新掉落（+ New Loot）。
- 选择已创建物品作为掉落物。
- 设置掉落数量。
- 如需多种掉落，重复添加。
- 触发对象默认 自身（Self），条件为 启动时（On Start），即游戏开始自动掉落。更多触发详见 触发器（Trigger）。
示例：
更多掉落机制详见 设置掉落点。
使用环境系统控制环境光与特效
环境系统（Environment system） 可快速控制场景的天空盒（skybox）、阳光和后期处理（post-processing）等。
- 在 设置资源浏览器（Settings Explorer），点击 环境（Environment），右侧出现环境属性窗口。
- 可快速切换环境预设（Environment preset），如设为 夜晚（Night），体验天空盒、阳光和后期效果的变化。
更多环境设置详见 环境（Environment）。
试玩项目
-
在 设置资源浏览器（Settings Explorer），进入 游戏模式（Game mode），将类型（Type）设为 冒险（Adventure）。
-
进入试玩模式，体验物品在新环境下是否正常生成和可收集。
保存项目
点击 
菜单（Menu） 图标选择 保存（Save），或直接按 Ctrl + S。
发布项目
- 在 Desktop 的 创建（Create） 标签页找到你的项目并重命名。
- 点击项目卡片下方 发布（Publish） 按钮，选择 发布为新空间（Publish as a new space）。
- 填写项目信息后点击 发布（Publish）：
- 空间名称（Space name）：项目名称。
- 最大玩家数（Max Players）：1-30。
- 截图（Screenshots）：1-10 张，分辨率高于 1440x648。
- 加载图片（Loading images）：分辨率高于 1218x563。
- 标签（Tags）：最多 5 个，不含特殊字符。
- 加载提示（Loading tips）：最多 5 条，每条不超 100 字符。
- 描述（Description）：0-500 字。
- 发布后，在 发布（Publish） 标签页找到项目，悬停点击
，选择 分享空间（Share space） 复制链接分享。
常见问题（FAQ）
Q1: Party Game Kit 只能做派对游戏吗？
A: 并非如此，Party Game Kit 可用于多种类型游戏。你可在 YAHAHA Desktop 按不同玩法风格和视角选择工具包。
Q2: 如何选择 Party Game Kit 和 Horror Game Kit？
A: 可参考以下要素：
- Horror Game Kit 适合单人、第一人称、氛围叙事类。
- Party Game Kit 适合多人、第三人称。
Q3: 两种工具包的 AI 3D 场景生成有何不同？
A: 每种工具包有不同的视觉和环境风格：
- Party Game Kit 偏明亮自然风景。
- Horror Game Kit 偏暗、室内、恐怖氛围。 场景内美术风格均可自定义。
Q4: 两种工具包的预设逻辑有何区别？
A: 各自有独特玩法机制：
- Party Game Kit 包含丰富互动机制，适合新手做 3D 平台/跳跃类。
- Horror Game Kit 包含过场、惊吓、解谜等，适合叙事驱动 3D 解谜。
故障排查
安装与启动问题
- 确保已安装最新版（Desktop v1.3.34 及以上）。
- 下载时网络需稳定。
- 若仍有问题，联系客服。
发布与分享问题
- 检查项目信息（名称、标签、截图、加载图）格式与分辨率。
- 确认已登录且网络正常。
- 导入资源需云端构建完成后再发布。
- 如有异常，重启 Desktop 后重试。