v2.5.0 新增
左侧剧本树章节右键菜单中的「导出剧本…」用于交付阅读稿、配音表和结构化剧本。它输出文档或脚本;要生成可运行的游戏,使用发布游戏。
S03:LetsGal Studio 2.5.0 六格式剧本导出与 Word 预览
S03 · 六格式剧本导出与 Word 预览

选择范围并导出

  1. 打开工程,在左侧剧本树中右键章节,选择「导出剧本…」。
  2. 选择格式,在「导出范围」勾选一个或多个章节。目录可整组勾选,章节下面会展示所包含的片段;选择一章会包含它的全部片段。
  3. 在「文件组织」选择「合并为一个文件」或「每章单独一个文件」。顺序沿用剧本树的章节排列。
  4. 在「指令类型」选择「仅文本」或所需类型,按需纳入禁用指令。筛选影响实际导出内容。
  5. 查看右侧预览。按章输出时先切换预览章节;Markdown 与 Word 可以查看排版,Ren’Py 可检查脚本与转换提醒。
  6. 点击导出,选择工程目录之外的文件或文件夹。看到完成提示后打开输出文件,检查文字、章节层级和范围。

选择格式

格式文件用途与边界
纯文本.txt通读、配音或自定义排版;不携带原项目素材
表格.csv用电子表格处理结构化台词;不是 .xlsx 工作簿
JSON.json保留所选指令的结构与属性;导出 Schema 是 letsgal-script-export,不能直接当章节文件导入
Ren’Py.rpy将可转换指令导出为标准 Ren’Py 脚本;不能完整还原 Studio 的所有演出
Markdown.md带章节与片段层级的阅读稿
Word 文档.docx带章节层级、角色与对白排版的文档
Ren’Py 默认使用独立的兼容类型筛选,保留分支、调用和变量等衔接指令。检查「转换提醒」中的遗漏或不可转换内容,再在目标 Ren’Py 工程补上素材与不支持的逻辑。编辑器里的Ren’Py 风格代码视图与 .rpy 导出分别处理,不应把 Studio 的 studio ... 语法直接交给 Ren’Py 运行。

自定义纯文本导出

纯文本格式提供自定义脚本入口,可以载入或编辑 JavaScript,然后运行脚本生成输出,检查预览后再保存。范围或脚本发生变化后需要重新运行。 脚本应返回字符串,或包含 text 与 extension 的对象。单次运行上限为 2 秒,输出上限为 5 MiB,载入脚本文件上限为 256 KiB。扩展名使用 1~12 位字母或数字。按章输出时脚本会分别处理每个有导出内容的章节。

保存与失败处理

  • 导出不会替代工程保存、Git 同步或素材备份;先确认编辑器保存状态。
  • 输出位置必须在工程目录之外,避免覆盖工程文件。
  • 按章输出如果部分文件保存失败,提示会列出已保留的文件;先检查输出目录,再重试。
  • 选择为空或筛选后没有内容时,先调整章节与指令类型。