故事编辑器
Naninovel 拥有自己的独立应用程序,在 Unity 编辑器中开发游戏时,您可以使用它通过可视化编辑器创作剧本脚本,并通过节点图管理故事结构。您还可以使用它来创建剧本草稿,并使用程序化生成的资产在 Web 浏览器中预览,甚至无需打开 Unity。
沙盒模式
沙盒模式完全独立于 Unity 编辑器。它提供了在浏览器中直接创作剧本和预览(播放)游戏的工具,使用最新的引擎规格、可用命令和运行时功能。在底层,它生成标准的 .nani 文本文件,您可以在 Unity 中无缝重用或使用 VS Code 直接编辑。
沙盒模式的主要用例:
- 在购买前试用 Naninovel 的脚本系统和运行时功能。
- 在开始 Unity 开发之前,使用生成的资产起草剧本。
访问 naninovel.com/editor 即可直接在 Web 浏览器中开始使用该应用程序。您还可以选择接受浏览器提示,将该应用程序安装为 PWA,这样它在任务栏上会有自己的专用图标,并在原生操作系统窗口中运行,就像常规桌面应用程序一样。
占位符资产
在起草故事时,使用媒体资产的临时版本(例如音频剪辑、背景和角色纹理)可能会很有用。同时,在预览剧本时跟踪当前处于活动状态的资产也很有帮助。
沙盒模式允许创建占位符资产:您只需描述资产的特征,编辑器就会生成易于区分的预览,在使用该资产时显示。
要创建占位符资产,请在 文件浏览器 中的“Backgrounds”、“Characters”或“Audio”目录下右键单击,然后选择添加相应资产的选项。
然后,您可以选中创建的资产来查看和编辑可用特征。
创建的资产会自动添加到 剧本编辑器 的下拉列表中。
选中后,资产会立即显示在游戏预览中。
嵌入模式
故事编辑器与 Unity 编辑器完全集成,可以通过在检查器中查看剧本脚本资产,或通过 Naninovel -> Story Editor Unity 编辑器菜单启动。
嵌入模式使用操作系统的原生 WebView,首次启动时需要互联网连接来下载编辑器二进制文件。二进制文件会被缓存,因此同一项目中的后续运行不再需要网络连接。
提示
WebView 组件由操作系统维护,但在少数情况下,它可能被禁用或更新失败,导致故事编辑器无法正常工作。要在 Windows 上验证 WebView 版本,请在 PowerShell 中运行以下命令:
(Get-ItemProperty 'HKLM:\SOFTWARE\WOW6432Node\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}','HKCU:\SOFTWARE\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}' -ErrorAction Ignore).pv如果没有任何输出,或版本低于 150,请安装最新的 WebView2 Runtime 并重启 Unity。
工作区
编辑器工作区具有灵活且可自定义的布局。您可以拖动选项卡之间的分隔线来调整选项卡的大小,也可以拖放选项卡组或选项卡本身来调整其位置。您还可以通过单击相应选项卡组末尾的按钮来最大化任何选项卡。
有默认布局模板可供选择,您可以通过控制面板上的下拉菜单添加自定义布局。
文件浏览器
文件浏览器选项卡允许您与当前项目根目录下的文件和目录进行交互。您可以创建新的剧本脚本或占位符资产(在 沙盒模式 下),以及管理和组织文件。
当您通过文件浏览器重命名或移动剧本脚本文件时,编辑器会自动更新导航命令(例如 @goto 和 @gosub)以确保路径保持有效。
检查器
故事编辑器的交互模型类似于 Unity 编辑器:您选择一个资产,例如文件浏览器中的文件或故事图中的节点,相应的编辑器将显示在检查器选项卡中。这使得结构编辑上下文和直接编辑上下文之间能够清晰分离,从而带来更高效的用户体验。
检查器采用焦点陷阱——您可以使用 Tab 和 Shift+Tab 在输入字段和控件之间高效切换,而无需使用鼠标。
剧本编辑器
剧本编辑器是应用程序的主要创作工具。除了在 VS Code 等文本或代码编辑器中编写 .nani 文件,您也可以使用它来创作剧本。
每个剧本编辑器选项卡代表一个 .nani 脚本,脚本中的每个文本行显示为一行。您可以使用选项卡底部的 + 按钮、上下文菜单(右键单击现有内容)或 Enter 热键(可在 设置 中配置)添加行。
您可以通过拖放对行重新排序,并通过上下文菜单或使用 Backspace 和 Ctrl+D 键删除或复制行。
更改会立即应用,如果编辑的脚本当前正在播放,则会反映在游戏视图中。要保留更改,您需要 保存 修改后的文件。
在游戏运行时,当前播放的行会根据是否正在等待输入而以绿色或黄色轮廓突出显示。要自动打开当前播放的脚本并选择活动行,请单击控制面板上的专用按钮或按 Ctrl+X。
故事图
故事图有助于可视化、跟踪和组织剧本结构,还允许编辑脚本本身。
默认情况下,每个节点代表一个剧本脚本或目录。边代表脚本之间的导航。条件导航(例如 @choice 或 @if 下的 @goto)显示为虚线边,条件列在相应的端口上。
您可以通过右键单击故事图窗格来创建脚本和目录,并通过节点上下文菜单移动或重命名它们。要进入目录节点,请双击该节点或从上下文菜单中选择“Enter Folder”。
您还可以进入脚本节点,在这种情况下,故事图将用作可视化剧本编辑器。此时显示的不再是脚本和目录节点,而是标签节点,其中包含的剧本行可以像在 剧本编辑器 中一样进行编辑。
脏保存(Dirty-Save)
当您修改资产(例如剧本脚本或故事图)时,它会变“脏”(dirty)——这意味着更改已在内存中但尚未保存到磁盘。要保留更改,您需要保存资产。
只要有资产处于脏状态,保存按钮就会启用。单击按钮可查看已修改的资产,并选择全部保存或单独保存。也可以按 Ctrl+S 保存所有脏资产。
撤销/重做
编辑器中的大多数修改都会被跟踪,并可以使用撤销/重做系统进行还原。进行更改后,撤销按钮将变为可用状态——单击它以查看更改列表并单独撤销/重做它们。
您也可以分别使用 Ctrl+Z 和 Ctrl+Y 进行撤销和重做。
全局搜索
随着项目的增长,在所有剧本脚本中进行搜索可能会很有用。连按两次 Shift 键或单击控制面板上的“Search”按钮以打开全局搜索。
结果会随着输入实时更新,同时包括剧本脚本的名称和内容。选择某个结果会将其打开,并在 剧本编辑器 中突出显示相应的行。
设置
您可以通过设置选项卡自定义编辑器和项目,该选项卡有两个主要类别:用户和项目。通过控制面板上的菜单或按 Ctrl+Alt+S 打开该选项卡。
用户设置
在沙盒模式下,用户设置存储在您首次设置时选择的目录中;在嵌入模式下,则存储在 Unity 的持久目录下。它们不与项目共享,并适用于设备上的所有项目。这包括编辑器配色方案、键位映射和 UI 元素可见性等首选项。
项目设置
项目设置与用户无关,存储在项目目录下,并与从事该项目的所有用户共享。其中包括项目标题等项目特定属性。
键位映射
键位映射是用户设置的一部分,允许您为各种编辑器功能配置按键绑定,例如追加行、复制节点、进入播放模式等。
要绑定按键,请找到所需的操作并输入键代码。可以使用 + 在前面添加修饰键。有关有效的键代码和修饰键,请参阅 MDN 参考。
在 macOS 上,修饰键的映射如下:
| 代码 | macOS |
|---|---|
Ctrl | ⌘ |
Alt | ⌥ |
Shift | ⇧ |