LetsGal Studio 是用于制作 Galgame（视觉小说）的可视化编辑器。除剧本编辑外，它还提供素材管理、角色与场景配置、分支设计、实时预览、调试和多平台打包功能。
LetsGal Studio 主界面

​
主要功能

功能说明
素材管理导入图片、音频和视频，查看引用位置与未使用素材
角色与场景配置角色立绘、表情差分、场景背景和多层场景
剧本编辑使用 Block 编写对白、演出和流程控制
分支设计使用选项、条件和变量控制剧情走向，并通过叙事地图检查结构
预览与调试预览当前编辑位置，检查变量、调用栈和运行日志
界面与扩展使用可视化界面编辑器制作 UI，或使用 TypeScript 和 React 开发扩展
打包发布导出 macOS 和 Windows 桌面应用

​
基本工作流程

1

创建项目

选择模板，设置项目名称和画布尺寸。
2

导入素材

添加立绘、背景、BGM、音效、语音和视频。
3

配置角色与场景

将素材绑定到角色、表情、场景和场景图层。
4

编写剧本

使用 Block 添加对白、分支、场景切换和演出指令。
5

预览与调试

在预览窗口检查画面和流程，并使用变量、时间轴与日志定位问题。
6

打包游戏

设置名称、版本号和图标，生成桌面端应用。

​
核心概念

  • 项目：一部游戏的全部剧本、素材、设置和扩展。
  • 素材：导入项目的图片、音频、视频和字体文件。
  • 角色与场景：对素材的可复用配置。替换角色立绘或场景背景后，相关剧本引用会同步更新。
  • Block：剧本中的一条指令，例如对白、切换场景、播放音频或条件判断。
  • 章节与 Fragment：章节组织主线内容；Fragment 存放由分支、条件或调用指令执行的片段。
  • 预览：显示当前剧本位置对应的游戏画面，并提供调试工具。

​
素材引用

项目中的素材会记录引用位置。资源总览可用于：
  • 查找素材被哪些角色、场景或剧本使用
  • 检查缺失引用
  • 筛选未使用素材
  • 预估打包体积
打包时默认只包含被引用的素材。需要保留未直接引用的文件时，可将其设置为强制打包。
LetsGal Studio 素材管理界面

​
预览与调试

编辑器与预览窗口会同步当前剧本位置。选中 Block 后，预览会显示该位置的画面状态。 调试界面提供以下工具：
  • OP 时间轴：查看当前执行位置并跳转
  • 属性检查器：查看和修改所选 Block 的参数
  • 变量观察：查看或修改运行时变量
  • 调用栈：检查 Fragment 调用与跳转关系
  • Console：查看引擎和扩展的运行日志
LetsGal Studio 调试界面

​
界面与扩展

标题页、菜单、HUD 等界面可以通过可视化界面编辑器制作。需要自定义逻辑时，可以使用 @avg-studio/sdk、TypeScript 和 React 开发扩展。 扩展按项目启用，可提供自定义界面、剧本方法、设置项和存档数据。已完成的扩展可以从扩展工坊安装，也可以从文件夹或压缩包导入。
LetsGal Studio 扩展管理界面

​
打包平台

平台状态
macOS支持
Windows支持
Web规划中
Android / iOS规划中
LetsGal Studio 打包界面

​
Studio 与 AVGPlus Engine

  • LetsGal Studio：用于编辑项目、管理素材、预览和打包。
  • AVGPlus Engine：运行剧本和游戏界面的运行时。
可视化功能无法满足需求时，可通过扩展 SDK 调用引擎能力。

​
适用范围

LetsGal Studio 主要用于制作以对白、分支和 2D 演出为核心的视觉小说。它不提供以下能力：
  • 通用 3D、动作或 RPG 游戏编辑
  • 云端项目协作
  • 自动生成剧本内容
项目文件保存在本地。团队项目可使用 Git 或其他版本管理工具协作。

​
下一步