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

选择运行方式

运行按钮右侧的下拉菜单提供三种方式:
方式结果
调试运行从项目入口运行,并打开变量观察、快照、时间轴和日志等调试工具
从当前章节调试跳过前面的章节,直接定位到当前正在编辑章节的第一个可执行操作
模拟游玩完整构建后在独立窗口按玩家视角运行,不显示调试界面
LetsGal Studio 运行方式菜单与从当前章节调试选项
v1.9.0 新增:「从当前章节调试」和默认运行方式固定。
把鼠标移到运行方式上,点击行尾图钉,可以把它设为运行主按钮的默认动作。设置会保存在 Studio 中;以后单击主按钮就直接使用该方式。 「从当前章节调试」只对线性流程中已启用、包含可执行内容的普通章节有效。当前没有可用章节或正在编辑运行章节时,该选项会禁用;定位目标失效时 Studio 会提示并从项目开头运行。
检查依赖前置变量、跨章节粒子或扩展状态时使用「调试运行」;只调整当前章节的对白、镜头和演出时使用「从当前章节调试」。

OP 时间轴

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

编辑器联动

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

属性检查器

属性检查器显示所选 Block 的参数。例如:
  • 对白块:角色和语音
  • 场景块:过渡方式和时长
  • 摄像机块:镜头参数
检查器可以停靠在预览下方、编辑器下方或显示为浮动面板。修改参数后,预览会同步更新。

变量观察

变量观察面板用于:
  • 查看运行时变量的当前值
  • 修改变量以模拟特定剧情状态
测试条件分支时,可以直接设置目标变量值,再检查分支结果。

调用栈与 Console

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

跨章节状态

编辑器预览只渲染当前章节。依赖前一章节的状态不会自动带入,例如前一章创建的粒子效果。检查此类效果时,请运行完整流程,或在当前章节中设置所需状态。详见剧本编辑器

调试中的游戏内设置

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