游戏叙事与剧情 / 系统课时
改稿后怎样稳定重新编译
改稿后怎样稳定重新编译
剧情联调最常见的混乱不是“编译器坏了”,而是源文件、Unity 导入结果和正在运行的 Story 处于不同版本。本节建立一套固定的改稿循环,让每次修改都能明确知道何时已重新编译、何时需要重新创建运行时状态。
学习目标
- 区分
.ink源文件、Unity 导入后的InkFile与运行中的Story - 建立保存、编译、验证、重载的稳定联调顺序
- 在自动刷新异常时安全地强制 Reimport,而不是反复删除资源
为什么文件改了,画面却没变
Ink for Unity 2.x 使用 Unity 的导入流程处理 .ink:文件保存后,Unity 会重新导入并更新对应的 InkFile。但游戏里已经通过 new Story(inkFile.storyJson) 创建出来的 Story 是一个独立的运行时实例,它不会自动替换成新的剧情状态。
因此要分别确认两件事:资源是否已经重新编译,以及当前运行实例是否已经重新创建。只做前者,Play 模式里仍可能继续跑旧 Story;只做后者,如果导入阶段有编译错误,新实例也拿不到有效的新内容。

固定一套改稿循环
每次剧情修改都按同一顺序处理,能显著减少“到底是哪一层没刷新”的猜测。
- 保存正在编辑的
.ink文件,先确保编辑器确实写入磁盘。 - 回到 Unity,等资源导入完成;如果 Console 或该 Ink 资源的 Inspector 有编译错误,先修复错误。
- 确认目标
InkFile已重新导入,再决定是否继续当前 Play 会话。 - 对最稳妥的联调方式,停止 Play 后重新进入,让业务脚本重新执行
new Story(inkFile.storyJson)。 - 用本次故意修改的一句对白、一个选项或一个变量结果做验收,不要只凭“没有报错”判断刷新成功。
自动刷新异常时强制 Reimport
正常情况下不需要手动编译。只有在 Unity 没有感知到文件变化、外部同步工具改写文件或你怀疑导入缓存状态异常时,再做一次明确的 Reimport。下面的 Editor 工具只重导入当前选中的 InkFile,范围比“全部重编译”更小。
把文件保存为 Assets/Editor/InkReimportSelected.cs:
#if UNITY_EDITOR
using Ink.UnityIntegration;
using UnityEditor;
using UnityEngine;
public static class InkReimportSelected
{
[MenuItem("Tools/Ink/Reimport Selected Ink File")]
private static void ReimportSelected()
{
InkFile inkFile = Selection.activeObject as InkFile;
if (inkFile == null)
{
Debug.LogWarning("请先在 Project 窗口选中一个 InkFile。");
return;
}
// ForceUpdate 重新执行该 .ink 资源的导入流程。
string assetPath = AssetDatabase.GetAssetPath(inkFile);
AssetDatabase.ImportAsset(assetPath, ImportAssetOptions.ForceUpdate);
Debug.Log($"Ink reimported: {assetPath}");
}
[MenuItem("Tools/Ink/Reimport Selected Ink File", true)]
private static bool ValidateReimportSelected()
{
return Selection.activeObject is InkFile;
}
}
#endif预期输出
Ink reimported: <PATH>.ink<PATH> 会替换为项目中的实际资源路径。随后仍要检查 Console 或 Ink 资源 Inspector:Reimport 只是重新触发导入,不代表有语法错误的 Ink 会被“强制编译成功”。
用定位顺序避免状态混乱
发现改稿没有生效时,按“源文件 → 导入结果 → 运行实例”排查,不要反过来乱试。
- 源文件没保存:Unity 根本没有新内容可导入。
- Unity 有 Ink 编译错误:先修源文件,暂时不要排查游戏逻辑。
InkFile已更新但画面仍旧:停止并重新进入 Play,或让业务代码显式重新创建Story。- 修改的是被
INCLUDE的文件:确认作为入口的主剧情也完成重新导入,并从主剧情验证结果。 - 只有加载旧存档后异常:先用全新
Story验证新版剧情,再单独处理存档兼容。
稳定联调的关键不是“多点几次刷新”,而是一次只验证一层状态。先确认 .ink 能成功导入,再确认 InkFile 是新版本,最后确认运行中的 Story 已重建,这样任何一次改稿都能快速定位到真正没有更新的环节。