使用 Party Game Kit 创建多人游戏
本教程适用于 Party Game Kit 用户。
Yahaha 是一个低代码、用户生成内容（UGC，User Generated Content）平台，帮助创作者构 建、编辑和分享 3D 互动体验。本教程将带你使用 Party Game Kit 创建 3D 多人探索项目，并学习编辑器的基础操作，包括如何添加资源、创建对话、调整天空盒并分享你的项目。完成后，你可以与朋友一起游玩冒险游戏并探索世界。
想了解 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）元素。
场景导航控制
在 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 模型。
创建 NPC 并为其添加对话
制作 NPC
以角色模型为例，将其变为 NPC：
- 在资源库添加角色模型到场景。角色分为 人形（Humanoids）、动物（Animals）、生物（Creatures）、机械（Mechanical） 等类型。
大部分角色模型都已绑定骨骼（rigged）。常见骨骼类型：
- 人形骨骼（Humanoid rigs）：模拟人类骨架和动作。
- 通用骨骼（Generic rigs）：用于非人形对象，如宝箱、载具、机械等。 动画片段需与骨骼类型兼容。
本教程以人形模型 Cutyty 为例。
- 选中模型，点击 + 功能（+ Feature） > NPC 添加 NPC 组件。
-
输入 NPC 名称（游戏内显示）。系统会自动分配 ID，脚本时可用。
-
（可选）如
Cutyty为人形骨骼模型，可添加动画： -
点击 + 功能（+ Feature） > NPC 动画（NPC Animation） 添加动画组件。
-
从资源库添加人形动画片段，至少指定 待机（Idle） 动作。
创建对话
-
在 设置资源浏览器（Settings Explorer），点击 对话（Dialog），选择 + 新建对话（+ New Dialogue），即可在对话窗口新建对话。
-
填写 对话内容：
-
名称（Name）：对话名称，玩家触发时首先看到。
-
句子（Sentence）：对话内容，可添加多句。
-
NPC/玩家（NPC/Player）：指定说话者。
-
文本（Text）：句子内容。
-
-
（可选）如需更多对话，点击
新增。
将对话关联到 NPC
-
选中模型，点击 + 功能（+ Feature） > 对话（Dialogue） 添加对话组件。
-
配置对话触发与内容：
-
对话触发（Dialogue Trigger） 默认 自身启动（Self On start），即游戏开始自动触发。
-
对话选项（Dialogue option） 选择对话池中的对话，可命名并设置为一次性。
使用环境系统控制环境光与特效
环境系统（Environment） 可快速控制场景的天空盒（skybox）、阳光和后期处理（post-processing）等。
- 在 设置资源浏览器（Settings Explorer），点击 环境（Environment），右侧出现环境属性窗口。
- 可快速切换环境预设（Environment preset），如设为 夜晚（Night），体验天空盒、阳光和后期效果的变化。
更多环境设置详见 环境（Environment）。
试玩项目
-
在 设置资源浏览器（Settings Explorer），进入 游戏模式（Game mode），将类型（Type）设为 冒险（Adventure）。
-
进入Play模式试玩，体验对话在新环境下是否正常触发。
保存项目
点击 
菜单（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 Kit 包含丰富互动机制，适合新手做 3D 平台/跳跃类。
- Horror Kit 包含过场、惊吓、解谜等，适合叙事驱动 3D 解谜。
故障排查
安装与启动问题
- 确保已安装最新版（Desktop v1.3.34 及以上）。
- 下载时网络需稳定。
- 若仍有问题，联系客服。
NPC 与对话问题
- 检查 NPC 是否添加了 NPC 和对话组件。
- 检查对话内容是否完整并已正确关联。
- 检查触发类型（如“On start”）是否符合设计，若需触发盒（trigger box）请确保已添加。
发布与分享问题
- 检查项目信息（名称、标签、截图、加载图）格式与分辨率。
- 确认已登录且网络正常。
- 导入资源需云端构建完成后再发布。
- 如有异常，重启 Desktop 后重试。