剧本编辑器

剧本编辑器用于编写对白、配置演出和控制剧情流程。

​

顶部导航栏

顶部导航栏分为两行。 第一行从左到右三段：

• 左段：后退、前进和项目菜单。项目菜单包含打开、重命名、另存为、项目历史、关闭和退出等操作
• 中段：全局搜索。点击搜索框或按 ⌘/Ctrl + K，搜索项目中的台词、指令和资源
• 右段：创作者账号入口

第二行包含剧本、资产、叙事地图、个性化、扩展工坊、发布游戏和设置。「资产」的子菜单包含资源总览、角色、场景、BGM、SE 和语音。进入调试运行时，「剧本」会临时显示为「调试」。

​

界面布局

编辑器分为三个区域：

​

左侧 · 章节列表

左侧显示 章节 → Fragment（片段） 的剧本结构。 章节是剧本的最大组织单位。「开始」章节固定为游戏入口，不能删除。建议按可独立调试的剧情段落拆分章节。 右键章节并选择「禁用此章」后，该章节会在调试和打包时跳过，但内容仍会保留。再次右键可启用。「开始」章节不能禁用。 Fragment（片段） 是章节内的子单元，作用域限于所属章节。Fragment 不按主线顺序自动执行，只在被分支、条件或调用块引用时执行。 点击章节或 Fragment 后，它会在编辑区顶部的标签栏中打开。标签可以排序和关闭。Studio 会保存标签顺序以及各 Fragment 的列表和光标位置。 按 ⌘/Ctrl + W 时，Studio 会优先关闭当前剧本标签，不会直接关闭应用窗口。左侧剧本树可以收起，为编辑区和预览留出更多空间。 章节列表顶部的「剧本运行设置」用于选择基础或高级章节调度，也可以配置每章开始前执行的公共前处理章节。

​

中间 · Block 编辑区

中间区域按顺序显示 Block（指令块）。每个 Block 表示一项操作，例如对白、场景切换、播放音频或镜头运动。

​

右侧 · 实时预览

右侧显示当前剧本位置的游戏画面。编辑内容或选中 Block 后，预览会更新到对应状态。 预览窗口下方还有 OP 进度条，也可以直接拖拽跳转到剧本的任意位置。 预览工具栏提供分辨率、定位到光标、重载引擎、独立窗口和预览设置。运行按钮下拉菜单可以选择调试运行、从当前章节调试或不显示调试界面的模拟游玩，并用图钉固定主按钮的默认方式。详见游戏调试 · 选择运行方式。 选中 Block 后，属性检查器显示该 Block 的参数。例如，旁白块提供语音配置，场景块提供过渡方式和时长。 检查器可以停靠在预览下方、编辑器下方或显示为浮动面板。使用标题栏右侧的按钮切换位置。

​

基本操作

​

插入 Block

在空白旁白块上按 Tab，然后从多列菜单中选择要插入的 Block。菜单按对白、演出、逻辑等类别分列；项目启用扩展后还会出现「扩展 · 方法与界面」列。 在扩展列中直接选择方法，会插入并预选对应的「调用扩展方法」块；直接选择界面，会插入并预选对应的「显示界面」块，不需要再经过第二次选择。

​

输入旁白

在空白旁白块中直接输入文字可创建旁白。

​

进入角色对话模式

在空白旁白块上按 Tab 并选择角色，进入该角色的连续对话模式：

• 编辑器会自动显示角色对应的立绘
• 每一句对话左侧都可以选择不同的差分表情
• 换行后继续使用当前角色

在空对话行上按 Enter，退出连续对话模式。 连续对话模式还支持扩展菜单、隐藏立绘、差分表情切换等功能，详见 对白 Dialogue 。

​

多选 Block

需要整理一段连续演出或批量搬运内容时，可以同时选中多个 Block：

• 按住 ⌘/Ctrl 点击，逐个加入或取消选择
• 按住 Shift 点击，从上一次选中的 Block 连续选择到当前位置

多选后，右键菜单会显示选中的 Block 数量，并支持批量复制、剪切、创建副本和删除。复制或剪切后的内容仍按原来的剧本顺序排列，可以粘贴到当前项目或其他项目中。

​

剧本编辑视图

编辑区工具栏提供四种剧本视图，它们操作同一份 Block 数据： Studio 会保存最后使用的视图。

​

纯文本模式

纯文本模式将每个 Block 显示为一行，并使用颜色和字重区分类型：

• 使用名称：场景、角色和片段显示名称，不显示内部编号
• 省略默认值：仅显示非默认参数
• 资源只显示文件名：去掉路径和后缀

同一角色的连续对白会归为一组。左栏显示角色名，右栏显示台词；后续台词省略重复的角色名。表情以灰色文字显示。更换角色或插入其他 Block 后会开始新组。 分支会展开成多行：首行是「分支 + N 个选项」，下面每个选项各占一行，前面带树形符号，后面用箭头指向跳转的目标片段。

​

纯文本模式下能改什么

纯文本模式的编辑范围如下：

• 带正文的 Block（对话、旁白、段落、注释、浮字）：可以直接修改文字
• 指令类 Block（场景、镜头、音乐、分支、条件、变量等）：在纯文本行里只是只读的文字摘要，不能直接在这行改参数。要改它们的参数，切回卡片视图，或选中该行用属性检查器调整

纯文本模式支持选择、增删、移动和复制粘贴 Block。禁用的 Block 显示为半透明删除线。

​

Ren’Py 代码模式

Ren’Py 代码模式支持对白、场景、角色、音频、变量、分支、Fragment 调用和常用镜头指令，并提供项目角色、场景、资源、变量和 Fragment 的智能补全。 合法代码会自动同步到 Block；存在语法错误时会保留草稿，并暂停同步，直到错误修复。完整语法、同步规则和限制见Ren’Py 风格代码编辑。

​

导入外部剧本

卡片视图工具栏提供「导入剧本」。Excel 可以通过工作表和列映射直接转换；Word、PDF、图片和常见文本可以在配置 AI 后识别角色、表情、对白和旁白。 导入结果会追加到当前 Fragment，确认前会先显示预览和匹配状态。完整流程见导入剧本。

​

演出设计视图

点击工具栏右侧的「演出」，可以在统一时间线上查看当前章节中的镜头动画段。双击「镜头动画」Block 会直接进入对应片段，编辑镜头、场景、角色、粒子和关键帧。详见镜头动画。

​

片段的引用来源

Fragment 可由条件分支、选项分支或片段调用引用。 编辑被引用的 Fragment 时，顶部横幅会按条件、选项和调用分类显示引用位置。 点击引用来源旁的「前往」，可跳转并选中对应 Block。修改公共 Fragment 前，可用此功能检查影响范围。

​

复制粘贴章节与片段

章节和 Fragment 支持在当前项目、不同窗口和不同项目之间复制粘贴。

• 快捷键：⌘/Ctrl + C 复制、⌘/Ctrl + X 剪切、⌘/Ctrl + V 粘贴。
• 右键菜单：在左侧章节列表上右键，也有复制 / 剪切 / 粘贴 / 创建副本等选项。

粘贴规则：

• 粘贴进来的章节/片段会自动分配新的标识，不会和原件冲突；重名时自动加后缀（如「第一章」→「第一章_1」）。
• 素材不会自动跟着复制。如果目标项目里缺少被引用的素材，粘贴本身不受影响，但运行时会提示缺失——到资源总览里补齐素材即可。