ink 交互叙事脚本入门指南从 0 写出你的第一个分支故事【免费下载链接】inkinkles open source scripting language for writing interactive narrative.项目地址: https://gitcode.com/gh_mirrors/ink/ink你刚给玩家摆了个二选一写到第三层分支时却发现每条路都要手动接回去脚本改一处、断三处 ink 是 inkle 出品的开源交互叙事脚本语言专为分支故事而设计你在纯文本上标注选项、跳转和变量编译器把.ink文件变成 JSON再由 C# 或 JavaScript 引擎在你的游戏、网页里逐行播放。这篇指南带你从克隆仓库到跑通第一个三段分支故事全程只依赖命令行。ink 是什么写在纯文本里的交互叙事引擎一句话ink 让你像写小说一样写分支剧情。普通脚本语言先教你语法再讲故事ink 反过来——文件主体就是故事文本本身只有少数带符号的行*、-、VAR、{}在告诉引擎这里要分支、要跳转、要记住。可以把它想象成一份带页码标记的纸质剧本外加一位不知疲倦的场记你负责写好每个段落的名字和跳转箭头场记也就是编译器与运行时引擎负责在玩家做出选择后翻到正确的页码把台词一行行念出来。谁适合用三类人都对得上号纯文字作者不需要会编程写完直接预览分支效果游戏开发者C# 运行时嵌进 Unity 或自研引擎JavaScript 版本让故事跑在浏览器里内容团队同一套语法写 NPC 对话树、培训流程、互动小说互不冲突。ink 核心机制拆解段落、选项与记忆段落 Knot给每段剧情起个名字把 knot 理解成剧本上的章节标记名字必须是一个单词多词用下划线连接引擎靠它翻到这一页。 first_room 你推开门看见一张落灰的木桌。 - END- END表示故事到此结束没有它引擎走到段尾就会报内容耗尽。整个 ink 故事本质上就是一堆命名段落 跳转的组合。✍️命名解决了引擎知道去哪那玩家怎么选呢选项与跳转*和-是一对搭档*生成玩家可点的选项-把流程搬到目标段落。跳转是隐形的甚至可以切在句子中间再用glue 胶合符把断开的两段文字粘回一行。 first_room * [查看木桌] - check_table * [转身离开] - leave方括号里的文字只出现在选项列表里、不会重复印到正文写对话式选项时特别好用。变量与条件故事的小抄光会跳转故事还是金鱼记忆玩家做过什么它一概不记得。VAR在文件顶部声明全局变量{}块让同一段落按变量值显示不同内容。VAR courage 0 { courage 5: 你深吸一口气推开了那扇门。 - else: 你停在了门口迟迟没有动。 }有了它同一处剧情对不同玩家会呈现不同面貌选择才真正产生后果。ink 最短上手路径从克隆仓库到跑通第一个故事前置只有一样安装 .NET SDK 6.0 或更高版本编译器和引擎都是 C# 写的源码分别在 compiler/ 和 ink-engine-runtime/。之后就是四步git clone https://gitcode.com/gh_mirrors/ink/ink cd ink/inklecate dotnet build -c Release # 编译出命令行编译器 inklecate dotnet run -c Release -- -p myStory.ink # -p 播放模式边写边看效果myStory.ink里放一个最小故事 start 这是你的第一个 ink 故事。 * [继续] - next next 世界你好 - END运行后终端会先打印正文再列出选项等你输入序号——一个能玩的 ink 故事就跑起来了。正式导出给引擎用时去掉-p参数inklecate 会输出编译好的.json文件。ink 常见报错一次修完三个高频问题对照表刚上手时你大概率会撞上下面三件事⚠️ 对着表格修就行现象原因修法运行时报ran out of content. Do you need a - DONE or - END?故事流走到某段末尾没有收尾引擎没词了在该段末尾补- END彻底结束或- DONE跳回上一层调用提示找不到跳转目标-后面的名字与节点名不完全一致大小写、多一个空格都算或目标段落根本没声明逐字符核对两个名字先用声明节点再引用它使用变量时报未定义忘了在文件顶部用VAR声明或把临时变量写成了全局名全局变量集中在文件开头声明只在局部用的改用temp 名字 值编译期和运行期的报错其实都在替你数松掉的线头看到 WARNING 别跳过。ink 的延伸应用与下一步ink 的产物是一份中性的 JSON 剧本所以它并不绑定在游戏上 换个播放器就是另一样东西互动电子书读者选择追查哪条线索悬疑线随之分叉客服与培训模拟不同选择打出不同分数适合诊断、谈判类演练NPC 对话树同一套语法驱动视觉小说里店主、卫兵的全部台词。语法层面的完整细节建议直接翻 官方写作教程Weave 序列、隧道、List 都在里面要把故事嵌进自己的程序引擎 API 参考 Running Your Ink。现在就可以动手新建一个.ink文件用、*、-再加一个VAR写出一个三选一、选不同结局的小故事用 inklecate 的-p模式跑一遍。当你的第一次选择真的改变了结局ink 就从看过的教程变成了你手里的工具—— 剩下的就是故事本身的事。【免费下载链接】inkinkles open source scripting language for writing interactive narrative.项目地址: https://gitcode.com/gh_mirrors/ink/ink创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考