Wonderbox 是一款专为 macOS 设计的创意工具，它集成了直观的视觉编辑与强大的交互逻辑构建能力，允许用户无需编写代码即可创建丰富的交互式体验、原型、动画及小型游戏。其核心设计哲学是让创作过程像“搭建积木”一样简单而充满乐趣。
一、核心界面与工作区详解
启动 Wonderbox 后，您将看到一个干净、模块化的界面，主要分为以下几个区域：
- 顶部菜单栏与工具栏：包含标准文件操作（文件、编辑）、视图控制、运行测试以及发布选项。工具栏提供常用工具的快捷图标，如选择、移动、旋转、缩放和播放。
- 左侧资源面板：通常以标签页形式存在。
- “场景”面板：以树状结构展示当前项目中的所有对象（如角色、道具、环境元素），是管理项目层级结构的主要位置。
- “资产库”面板：内置的3D模型、材质、声音、粒子效果等资源的仓库，可直接拖拽到场景中使用。
- 中央视图区：这是核心工作区域，默认显示为3D场景视图。您可以通过鼠标（拖拽右键旋转视角，拖拽中键平移，滚轮缩放）和触控板手势自由导航。视图上方有切换按钮，可快速在“场景视图”、“游戏视图”（预览效果）和“动画时间轴”之间切换。
- 右侧属性/逻辑面板：
- “属性”检查器：当在场景中选择任一对象时，此处会显示该对象的所有可调参数，如位置、旋转、缩放、材质颜色、物理属性等。
- “逻辑编辑器”：Wonderbox 的核心功能区。它以节点图的形式呈现，通过连接不同的“行为”节点（如“当点击时”、“移动至”、“播放声音”）来定义对象的交互逻辑和游戏规则。
- 底部状态栏与信息面板：显示操作提示、错误信息，并可能包含动画关键帧编辑或日志输出区域。
二、完整操作流程：从创建到导出
启动软件后，在欢迎屏幕点击 “新建项目”，或通过菜单栏 文件 > 新建（快捷键 Cmd + N）。您需要为项目命名并选择保存位置。若要打开已有项目，使用 文件 > 打开（Cmd + O）。
在中央视图区，您可以从左侧“资产库”面板中，将喜欢的地形、建筑、装饰物等模型直接拖拽到场景中。使用工具栏的移动（V）、旋转（R）、缩放（T）工具（或按对应快捷键）调整其位置、方向和大小。所有对象都会在“场景”面板中列出，您可以在此重命名、创建文件夹进行分组，或调整父子层级关系。
这是赋予场景交互性的关键。在场景中选择一个对象（例如一个宝箱），然后在右侧面板点击“逻辑编辑器”标签。编辑器初始为空。
- 添加行为节点：在编辑器空白处右键点击，从弹出菜单中选择所需的行为，例如“输入”分类下的 “当物体被点击时”。
- 连接逻辑流：从“当物体被点击时”节点右侧的输出端口拖出一根线，连接到另一个行为节点（如“动画”分类下的 “播放动画”）的输入端口。
- 配置节点参数：点击“播放动画”节点，在节点下方或属性检查器中，为其指定具体的动画片段（如“打开”）。
通过这种方式，您可以构建复杂的逻辑链，例如：当角色靠近（触发器） -> 播放音效（动作） -> 显示对话框（动作）。
从资产库添加一个角色模型到场景。通常，您需要为其附加“控制器”逻辑。在逻辑编辑器中，为角色对象添加“输入”节点（如 “当按键按下时”，设置为W/A/S/D或方向键），并将其连接到 “移动角色” 或 “施加力” 等行为节点，即可实现键盘控制移动。
在编辑过程中，随时点击工具栏的“播放”按钮（或按 Cmd + P）进入游戏视图进行测试。再次按 Cmd + P 停止。测试时，可以打开“逻辑编辑器”，观察节点上的信号流动（通常有高亮效果），这有助于调试逻辑错误。
完成创作后，通过菜单栏 文件 > 导出项目…。您可以选择导出为独立的应用程序（.app）、适用于网页的格式，或用于分享给其他 Wonderbox 用户的工程文件。在导出对话框中，设置好应用图标、窗口尺寸等选项后，点击导出即可生成最终产品。
三、常用功能进阶技巧
- 逻辑节点复用：使用“自定义行为”：将一组常用的节点链（如一个完整的开门逻辑）选中，右键选择“创建自定义行为”，为其命名。之后，这个逻辑组会出现在节点菜单中，可以像单个节点一样重复使用，极大提升效率。
- 变量与数据存储：利用“变量”类节点（如“设置变量”、“读取变量”）可以在不同对象和逻辑之间传递信息。例如，用变量记录玩家收集的硬币数量，并在UI上显示。
- 动画状态机：对于角色复杂动画（待机、行走、奔跑），不要简单用“播放动画”节点切换。使用“动画控制器”节点，通过变量（如“移动速度”）来控制动画的平滑过渡，效果更专业。
- 镜头控制技巧：除了跟随角色，可以创建独立的镜头对象并为其编写逻辑。使用“缓动移动至”节点能让镜头切换更加平滑，使用“看向”节点可以让镜头始终聚焦于目标。
四、常见问题与解决方案
- Q1：物体移动或旋转时卡顿、不流畅？
-
- 检查逻辑循环：确保没有在“每帧更新”这类高频触发器中连接了过于复杂或耗时的操作链。
- 简化场景：检查场景中多边形面数过高的模型，必要时使用资产库中优化过的版本。
- 使用物理引擎优化：对于静态环境物体，在属性检查器中将“物理”设置为“静态”，以减少不必要的物理计算。
- Q2：导出的应用在别的电脑上无法运行或显示异常？
-
- 检查依赖：确保导出时包含了所有资源。在导出设置中勾选“嵌入所有资源”。
- 路径与名称：避免在项目中使用中文或特殊字符命名资产和文件夹，使用纯英文小写字母和数字是最安全的选择。
- 目标系统兼容性：导出为Mac应用时，注意选择兼容的 macOS 最低版本。
- Q3：逻辑节点连接正确，但触发后没有反应？
-
- 进入播放模式测试：部分逻辑（尤其是涉及输入和物理的）仅在播放模式下生效。
- 检查对象激活状态：在“场景”面板中，确认目标对象及其父对象没有被临时禁用（图标为灰色）。
- 调试输出：在关键逻辑节点后添加“调试日志”节点，输出一段文本，在播放时查看底部信息面板是否有对应输出，以定位逻辑中断的位置。
五、Wonderbox for Mac 快捷键汇总表
| 功能分类 | 操作描述 | 快捷键 (Mac) |
|---|---|---|
| 文件操作 | 新建项目 | Cmd + N |
| 打开项目 | Cmd + O |
|
| 保存项目 | Cmd + S |
|
| 导出项目 | Cmd + E |
|
| 编辑操作 | 撤销 | Cmd + Z |
| 重做 | Cmd + Shift + Z |
|
| 复制选中对象 | Cmd + C |
|
| 粘贴 | Cmd + V |
|
| 删除选中对象 | Delete |
|
| 视图控制 | 切换选择工具 | Q 或 1 |
| 切换移动工具 | W 或 2 |
|
| 切换旋转工具 | E 或 3 |
|
| 切换缩放工具 | R 或 4 |
|
| 聚焦选中对象（帧物体） | F |
|
| 切换场景/游戏视图 | Tab |
|
| 运行测试 | 开始/停止播放（测试） | Cmd + P |
| 单帧步进（调试用） | Cmd + ' |
|
| 逻辑编辑器 | 创建新节点 | 双击空白处 或 空格键 |
| 框选多个节点 | 拖拽鼠标 | |
| 自动排列选中节点 | Cmd + L |
|
| 折叠/展开选中节点组 | Cmd + . |
提示：本指南基于 Wonderbox 的通用工作流程和界面设计。不同版本间部分细节可能略有差异，建议在实际操作中结合软件的帮助文档或教程面板进行探索。
