编辑器

Naninovel 拥有独立的网页版编辑器，你可以通过可视化界面编写场景脚本，并使用节点图管理剧情结构 —— 或者仅在浏览器中为游戏编写剧本草稿并使用程序化生成的资源进行预览，无需打开 Unity 编辑器，就能在浏览器中直接工作。

安装

前往 naninovel.com/editor ↗，即可直接在浏览器中使用该应用。

可选地，你也可以接受浏览器提示，将其安装为独立的 PWA 应用 ↗，这样它会在任务栏上拥有专属图标，并在原生系统窗口中运行，就像普通桌面应用一样。

安装为 PWA 后，你可以折叠窗口标题栏以增加编辑器的垂直空间。

首次设置

首次启动应用时，会提示你选择一个目录来存储用户数据，例如自定义布局和设置。这一步是必须的，用于在浏览器卸载或切换时保留偏好设置；同时也方便你在不同设备之间备份或迁移用户数据。你可以选择任意目录，例如 <USER>/.nani，其中 <USER> 是用户主目录 ↗。

文件系统访问

选择目录时，浏览器会请求权限，允许应用读取和写入该目录下的文件。这是浏览器安全模型的一部分，用于确保应用无法访问授权目录以外的内容。

NOTE

浏览器的安全机制不允许你直接选择系统目录（如桌面或主目录）的根路径。请在这些位置下创建一个子目录，例如在主目录下创建 .nani 文件夹。

下次访问时，浏览器会提示是否允许应用永久访问所选目录。确认后，你将无需每次重新授权，同时编辑器可以在启动时自动打开上次使用的项目。

编辑器模式

设置完成后，你可以选择一个空目录以创建新的项目（沙盒模式），或选择一个现有的 Unity 项目以进入 Unity 附加模式。

沙盒模式

沙盒模式完全独立于 Unity 编辑器。它提供工具用于在浏览器中编写场景脚本并预览游戏，支持最新的引擎规范、指令和运行时功能。底层生成标准的 .nani 文本文件，可直接在 Unity 中复用，或用 IDE 扩展进行编辑。

沙盒模式的主要用途包括：

在购买前体验 Naninovel 的脚本系统与运行特性；
在正式进入 Unity 开发前，使用自动生成的资源编写剧本草稿。

在项目设置界面选择 “Create Project” 即可进入沙盒模式。

项目创建后，编辑器会自动生成一个模板，包含若干预制的场景脚本与资源，帮助你快速上手。如有需要，你可以通过文件浏览器删除它们并从零开始。

游戏窗口

网页编辑器中的游戏预览功能仅在沙盒模式下的 “Game” 选项卡中可用。

你可以通过控制面板上的播放按钮控制预览。每个按钮既是控制器，也是播放状态的指示器：

Play/Stop – 控制游戏实例是否初始化与运行，可用于快速重置游戏实例；
Pause/Resume – 控制脚本播放器是否等待输入，可在不激活继续输入的情况下暂停或恢复播放；
Fast-Forward – 是否启用跳过（快进）模式，可快速浏览游戏内容。

生成资源

在撰写剧情时，可能需要使用占位媒体资源（如音频、背景、角色贴图）。同时，在预览剧本时，能清楚地看到当前激活的资源也很有帮助。

沙盒模式允许创建资源元数据（Asset Meta），在其中描述资源特征，编辑器会生成可区分的预览图以显示被引用的资源。

要创建资源元数据，请在文件浏览器中右键点击 Backgrounds、Characters 或 Audio 目录下的空白处，然后选择添加对应的资源类型。

创建完成后，可选中该资源以查看和编辑其属性。

创建的资源会自动出现在场景编辑器的下拉菜单中。

选中资源时，它们会即时显示在游戏预览中。

Unity 附加模式

Naninovel 编辑器可以附加到安装了 Naninovel 包的 Unity 项目，提供额外功能，如可视化场景编辑器和剧情节点图。

在设置界面选择 “Open Project”，然后选取现有 Unity 项目的 Assets 目录，编辑器将以附加模式启动。

需要注意的是，虽然播放控制按钮仍然可用，但在附加模式下游戏预览选项卡是禁用的，因为播放控制由 Unity 管理。在这种模式下可以隐藏游戏预览选项卡。

除此之外，编辑器在附加模式下的工作方式与沙盒模式相似：场景编辑器、剧情图、全局搜索等功能均可使用。它还会自动从 Unity 编辑器中读取自定义指令、资源与元数据，类似于 IDE 扩展。你也可以同时使用这两者 —— 例如，在 VS Code 中编写脚本的同时，在可视化编辑器中微调或在剧情图中跟踪结构。