游戏叙事与剧情 / 系统课时

改稿后怎样稳定重新编译

改稿后怎样稳定重新编译

剧情联调最常见的混乱不是“编译器坏了”,而是源文件、Unity 导入结果和正在运行的 Story 处于不同版本。本节建立一套固定的改稿循环,让每次修改都能明确知道何时已重新编译、何时需要重新创建运行时状态。

学习目标

  • 区分 .ink 源文件、Unity 导入后的 InkFile 与运行中的 Story
  • 建立保存、编译、验证、重载的稳定联调顺序
  • 在自动刷新异常时安全地强制 Reimport,而不是反复删除资源

为什么文件改了,画面却没变

Ink for Unity 2.x 使用 Unity 的导入流程处理 .ink:文件保存后,Unity 会重新导入并更新对应的 InkFile。但游戏里已经通过 new Story(inkFile.storyJson) 创建出来的 Story 是一个独立的运行时实例,它不会自动替换成新的剧情状态。

因此要分别确认两件事:资源是否已经重新编译,以及当前运行实例是否已经重新创建。只做前者,Play 模式里仍可能继续跑旧 Story;只做后者,如果导入阶段有编译错误,新实例也拿不到有效的新内容。

Ink 改稿后的编译与运行时刷新链路

固定一套改稿循环

每次剧情修改都按同一顺序处理,能显著减少“到底是哪一层没刷新”的猜测。

  1. 保存正在编辑的 .ink 文件,先确保编辑器确实写入磁盘。
  2. 回到 Unity,等资源导入完成;如果 Console 或该 Ink 资源的 Inspector 有编译错误,先修复错误。
  3. 确认目标 InkFile 已重新导入,再决定是否继续当前 Play 会话。
  4. 对最稳妥的联调方式,停止 Play 后重新进入,让业务脚本重新执行 new Story(inkFile.storyJson)。
  5. 用本次故意修改的一句对白、一个选项或一个变量结果做验收,不要只凭“没有报错”判断刷新成功。

自动刷新异常时强制 Reimport

正常情况下不需要手动编译。只有在 Unity 没有感知到文件变化、外部同步工具改写文件或你怀疑导入缓存状态异常时,再做一次明确的 Reimport。下面的 Editor 工具只重导入当前选中的 InkFile,范围比“全部重编译”更小。

把文件保存为 Assets/Editor/InkReimportSelected.cs:

csharp
#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

预期输出

text
Ink reimported: <PATH>.ink

<PATH> 会替换为项目中的实际资源路径。随后仍要检查 Console 或 Ink 资源 Inspector:Reimport 只是重新触发导入,不代表有语法错误的 Ink 会被“强制编译成功”。

用定位顺序避免状态混乱

发现改稿没有生效时,按“源文件 → 导入结果 → 运行实例”排查,不要反过来乱试。

  • 源文件没保存:Unity 根本没有新内容可导入。
  • Unity 有 Ink 编译错误:先修源文件,暂时不要排查游戏逻辑。
  • InkFile 已更新但画面仍旧:停止并重新进入 Play,或让业务代码显式重新创建 Story。
  • 修改的是被 INCLUDE 的文件:确认作为入口的主剧情也完成重新导入,并从主剧情验证结果。
  • 只有加载旧存档后异常:先用全新 Story 验证新版剧情,再单独处理存档兼容。

稳定联调的关键不是“多点几次刷新”,而是一次只验证一层状态。先确认 .ink 能成功导入,再确认 InkFile 是新版本,最后确认运行中的 Story 已重建,这样任何一次改稿都能快速定位到真正没有更新的环节。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

改稿后怎样稳定重新编译

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通