游戏调试

调试模式用于检查剧本执行位置、画面状态、变量、Fragment 调用和运行日志。

​

选择运行方式

运行按钮右侧的下拉菜单提供三种方式： 把鼠标移到运行方式上，点击行尾图钉，可以把它设为运行主按钮的默认动作。设置会保存在 Studio 中；以后单击主按钮就直接使用该方式。 「从当前章节调试」只对线性流程中已启用、包含可执行内容的普通章节有效。当前没有可用章节或正在编辑运行章节时，该选项会禁用；定位目标失效时 Studio 会提示并从项目开头运行。

​

OP 时间轴

对话、立绘切换、场景转换和播放音频等操作在运行时均对应一个 OP（操作指令）。预览窗口下方的时间轴显示当前 OP 和总数，例如 op 8 / 107。 拖动时间轴可跳转到目标 OP，并显示该位置的画面状态。

​

编辑器联动

• 编辑器 → 预览：选中 Block 后，预览跳转到对应画面状态
• 预览 → 编辑器：拖动 OP 时间轴后，编辑器选中对应 Block

​

属性检查器

属性检查器显示所选 Block 的参数。例如：

• 对白块：角色和语音
• 场景块：过渡方式和时长
• 镜头特效 Block：镜头参数

检查器可以停靠在预览下方、编辑器下方或显示为浮动面板。修改参数后，预览会同步更新。

​

变量观察

变量观察面板用于：

• 查看运行时变量的当前值
• 修改变量以模拟特定剧情状态

测试条件分支时，可以直接设置目标变量值，再检查分支结果。

​

运行存档数据

实时预览区域上方的工具栏提供 查看运行存档数据。打开后可以搜索和检查当前预览引擎中的运行变量，以及扩展等功能写入的跨存档数据。

• 清除本次运行：重置当前这次预览会话中的运行变量；
• 清除全部运行存档数据：同时清除本次运行变量和当前作品的跨存档变量，但不会删除已经创建的存档槽位。

这项工具只处理预览运行时数据，不会修改剧本、项目配置或玩家已经安装的正式游戏。清除后依赖这些变量的当前预览状态无法恢复，需要重新运行流程。

​

本机预览性能

点击预览工具栏中的 预览性能，可以调整 Studio 当前电脑上的内嵌预览负担，例如预览像素上限和资源模式。这里的设置只影响 Studio 的预览 backbuffer 与本机资源使用，不会改写作品最终导出的画质规则。 面板中的 作品分辨率 是项目设置的逻辑画布大小，当前预览像素 是 Studio 此刻实际分配的 backbuffer。选择 720p 等上限后，如果作品分辨率更高，面板会显示降低后的预览像素、实际倍率和正在生效的上限；例如 1920 × 1080 的作品在 720p 上限下显示为 1280 × 720、0.67×。这不会改变作品分辨率或构建画质。 当编辑器在高分辨率屏幕、集成显卡或大型素材项目中出现卡顿时，可以先降低预览像素上限；发布前仍要使用项目本身的画面设置构建，并在目标设备上完整测试。

​

调用栈与 Console

• 调用栈：显示当前 OP 的执行上下文、Fragment 调用和跳转路径
• Console：显示引擎日志、脚本错误和扩展错误

​

跨章节状态

​

调试中的游戏内设置

调试运行里打开游戏内设置界面时，显示的内容与打包后玩家看到的一致：项目允许全屏时，「显示」区和「全屏」开关正常出现。由于调试画布位于 Studio 窗口内，点击全屏开关只会提示构建后生效，不会真的把编辑器切入全屏。