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

安装 Ink 与 Unity 集成工具

安装 Ink 与 Unity 集成工具

本课把写作端和 Unity 运行端一次搭好:先准备 Inky 与 Git,再通过 Unity Package Manager 安装 Ink Unity Integration,最后用菜单、包目录和资源导入行为确认环境可用,为后续编译 .ink 剧本做好准备。

学习目标

  • 安装并区分 Inky、Ink 与 Ink Unity Integration 的职责
  • 通过 Unity Package Manager 正确接入官方集成包
  • 确认项目中的包目录、剧情资源目录与基础验证入口

前置检查

本课按 Ink Unity Integration 2.x 的工作流组织。该版本要求 Unity 2022.3 LTS 或更高版本;通过 Git URL 安装 UPM 包时,本机还需要可用的 Git。Inky 是独立的 Ink 编辑器,用来编写和预览剧情,不需要放进 Unity 项目。

先在终端确认 Git 可用:

bash
git --version

预期输出:

text
git version <VERSION>

<VERSION> 会随本机安装版本变化。若命令不存在,先安装 Git 并重新启动 Unity Hub 或 Unity Editor,避免 Package Manager 仍读取不到新的环境变量。

安装 Inky

从 Inky 官方发布页 下载与你的操作系统对应的版本并启动。首次打开后,新建一个空白故事即可;此时不需要配置 Unity 路径,也不需要手工安装 Ink 编译器,因为 Inky 已经面向 Ink 写作和预览场景提供所需能力。

这里最重要的是把职责分开:Inky 负责写和试剧情,Unity 负责把剧情接入游戏;两者可以打开同一份 .ink 文件,但不应该把 Inky 程序复制进 Unity 的 Assets 目录。

接入 Unity 集成包

在 Unity 中打开 Window > Package Manager,点击左上角 +,选择 Install package from git URL...,输入下面的官方地址:

text
https://github.com/inkle/ink-unity-integration.git#upm

这段内容是 Package Manager 的 Git URL,不是在终端中执行的 Shell 命令。安装完成后,Package Manager 中应出现 Ink Unity Integration,项目的 Packages 视图下也能看到对应包。

Unity Package Manager 通过 Git URL 安装 Ink Unity Integration 的位置

整理剧情资源目录

UPM 包本身位于 Packages,业务剧情则建议放在自己的 Assets 目录中,避免后续升级包时与第三方代码混在一起。一个足够简单的起点是:

text
Assets/
  Narrative/
    Ink/
Packages/
  Ink Unity Integration/

这里的目录只是项目组织建议,不是插件强制要求。后续所有主剧情 .ink 文件都可以放在 Assets/Narrative/Ink;Unity 会把这些文件作为项目资源导入,而插件代码继续由 Package Manager 管理。

验证安装结果

验证时不要只看“安装成功”的提示。先确认 Package Manager 中能找到 Ink Unity Integration,再检查 Unity 顶部菜单是否出现 Ink 相关帮助入口。随后在 Assets/Narrative/Ink 中放入任意合法 .ink 文件,选中它时 Inspector 应按 Ink 资源处理,而不是普通未知文本文件。

如果 Git URL 安装失败,优先按“Unity 版本是否满足要求 → git --version 是否可用 → 网络是否能访问 GitHub → Package Manager 是否留下失败依赖”的顺序排查。不要同时尝试 UPM、Asset Store 和手工复制三种安装方式,否则重复程序集或旧版残留会让后续问题更难定位。

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

目录与阅读设置

阅读设置

17

记录一个想法

安装 Ink 与 Unity 集成工具

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

登录哪都通