不少开发者在 Steam 上看到《恶校游戏》这类互动影游时第一反应是“剧情真敢写”第二反应往往是“这种分支剧情到底怎么做出来的”。其实抛开题材互动影游的技术核心并不神秘视频片段 分支叙事 状态管理。本文从开发者视角出发拆解一套不依赖重型中间件的 Unity 互动剧情原型方案从剧情数据结构到选择分支再到 Steam 上架准备一步步落地。文章内容适合有基础 Unity 使用经验、想尝试影游品类的开发者阅读零基础也能跟上整体思路。1. 互动影游的玩法本质与技术模型互动影游也就是常说的互动影视游戏是一种把“看视频”和“做选择”结合的玩法形态。玩家在关键剧情节点按下选项游戏根据选择跳转到不同的视频片段或文本剧情最终导向不同的结局。B 站上大家熟悉的互动视频、Steam 上常见的真人扮演类剧情游戏底层都是同一套逻辑。相比传统 RPG 或动作游戏互动影游开发门槛看起来低因为它没有复杂的战斗系统、物理引擎和 AI。但它真正的难点在内容管理和流程编排上几十个分支节点、几百段台词、多结局状态如果没有合理的数据结构代码会迅速失控。从技术模型来看一个最小可运行的互动影游需要以下三件事剧情数据描述有哪些节点、每句话谁说的、每个选项跳转到哪里。状态记录记录玩家做过哪些选择后续剧情根据这些选择产生差异。展示层显示文本、选项按钮以及后续可扩展的视频播放器、立绘、音效。换句话说先打通“剧情脚本驱动流程”的架构再往里填视频和演出资源影游的主要玩法就成立了一大半。2. 环境准备与项目结构本文的技术方案基于 Unity 引擎使用 C# 脚本和 JSON 配置完成一套可运行的分支剧情原型。先说环境。操作系统Windows 10 / 11macOS 也可以但本文以 Windows 演示。引擎Unity 2021.3 LTS 或更新版本。LTS 版本稳定性更好建议新项目直接创建 3DURP或 2D 项目均可本文不依赖渲染管线。语言C#。剧情配置JSON 文件导入 Unity作为 TextAsset 使用。UI 方案使用 Unity 自带 UGUI 完成文本和选项按钮绑定。为什么不用现成的对话插件因为很多团队直接使用 Yarn Spinner、Ink 这类叙事引擎效果确实好。但先手写一个迷你版能帮助理解分支叙事底层逻辑。主线跑通后再替换成成熟插件成本反而更低。先规划项目结构按下面的目录创建。Assets/ ├── Scripts/ │ ├── GameData.cs │ └── GameManager.cs ├── Data/ │ └── story.json ├── Scenes/ │ └── Main.unity └── Prefabs/ └── ChoiceButton.prefab3. 核心机制拆解剧情节点、选择分支与状态变量互动影游常见的剧情冲突本质上都可以抽象成三个要素节点、选择、状态。场景一主角遇到了关键事件玩家需要决定“帮”还是“不帮”。这是一个典型的分支选择。{ id: conflict, speaker: 旁白, text: 你必须做出决定。, choices: [ { text: 选择相信同伴, nextNode: trust, setFlags: [trustPath] }, { text: 选择独自行动, nextNode: alone, setFlags: [alonePath] } ] }这种结构可读性很强每个剧情节点有唯一 id文本内容若干选项。每个选项记录跳转目标以及进入该分支时应该记录的状态变量。之后其他节点可以通过检查状态变量让剧情产生“回响”。例如{ id: ending, speaker: 旁白, text: 结局因你之前的选择而改变。, choices: [], nextNode: end }这里的难点往往不复杂关键在于要在代码里维护一个“当前状态集合”。状态可以是一组字符串标记比如玩家走过哪条路线、是否拥有某个关键线索等。状态集合用 HashSet 即可实现。误区提示不要把所有剧情逻辑写死在 if-else 里。每加一个分支就往代码里加 if到了五十个节点时代码会变成一团乱麻。正确做法是把剧情规则全部放 JSON代码只负责“读取节点 - 展示内容 - 根据选项跳转”这是分层设计的基本思路。4. 完整实战从零搭建一个可运行的互动剧情原型下面我们逐步搭建一个 Unity 场景最终实现点击选项文本和选项动态刷新的效果。4.1 创建 UnityEngine 项目并准备 UI 场景打开 Unity Hub创建一个新的 2D 项目项目名可以叫 InteractiveStoryDemo。创建后在 Hierarchy 窗口中新建 Canvas之后在 Canvas 下创建三个对象SpeakerTextText 组件用于显示当前说话人。ContentTextText 组件用于显示剧情文本。ChoicePanel空物体作为选项按钮的父节点。因为我们要动态生成选项按钮所以还需要一个按钮预制体。在 Project 窗口创建一个 Button放在一个合适位置调整好大小然后拖入 Prefabs 文件夹命名 ChoiceButton。从 Hierarchy 中删除场景里的 Button保留预制体即可。4.2 创建剧情 JSON 数据文件右键 Project 窗口 - Create - Text File命名为 story.json。把下面的示例内容粘贴进去。{ startNode: start, nodes: [ { id: start, speaker: 旁白, text: 新学期的铃声响起你站在校门口。, choices: [ { text: 直接去教室, nextNode: classroom, setFlags: [wentClassroom] }, { text: 先去操场, nextNode: playground, setFlags: [wentPlayground] } ] }, { id: classroom, speaker: 同学, text: 你居然准时出现了今天的氛围有些奇怪。, choices: [ { text: 询问发生了什么, nextNode: askEvent, setFlags: [askEvent] }, { text: 安静坐下, nextNode: sitDown } ] }, { id: playground, speaker: 老师, text: 操场那边不许过去你最好回教室。, choices: [], nextNode: classroom }, { id: askEvent, speaker: 同学, text: 听说昨晚发生了一件大事大家都很紧张。, choices: [ { text: 继续追问, nextNode: detail, setFlags: [gotDetail] }, { text: 先去上课, nextNode: classStart } ] }, { id: sitDown, speaker: 同学, text: 你安静坐下但所有人都看向你。, choices: [ { text: 解释一下, nextNode: explain }, { text: 保持沉默, nextNode: silent } ] }, { id: detail, speaker: 旁白, text: 你了解到了事件的全貌接下来必须做出选择。, choices: [ { text: 站出来说清真相, nextNode: truth, setFlags: [truthPath] }, { text: 选择旁观, nextNode: watch, setFlags: [watchPath] } ] }, { id: classStart, speaker: 老师, text: 各位同学今天开始按新的座位表就坐。, choices: [], nextNode: detail }, { id: explain, speaker: 同学, text: 大家听完你的解释表情稍微放松了一些。, choices: [], nextNode: detail }, { id: silent, speaker: 旁白, text: 你的沉默让教室里的氛围更加压抑。, choices: [], nextNode: detail }, { id: truth, speaker: 旁白, text: 你选择了正面面对。即便很难你也没想过回避。, choices: [], nextNode: ending }, { id: watch, speaker: 旁白, text: 你选择了观望有些事错过就不再回来。, choices: [], nextNode: ending }, { id: ending, speaker: 旁白, text: 这一天结束了。你的选择定义了你在这个故事里的样子。, choices: [] } ] }这个 JSON 结构并不复杂但包含了几种常见场景带多个选项的节点、无条件跳转节点、没有后置节点时直接停住。读者可以按自己的剧情设计扩展节点但字段结构保持一致即可。4.3 编写 GameData.cs 数据类因为 Unity 的 JsonUtility 不支持直接把 JSON 转成 Dictionary所以先用数组承载节点数据再在运行时构建索引。新建脚本 GameData.cs。using System; using UnityEngine; [Serializable] public class GameChoice { public string text; public string nextNode; public string requiredFlag; public string[] setFlags; } [Serializable] public class GameNode { public string id; public string speaker; public string text; public GameChoice[] choices; public string nextNode; } [Serializable] public class GameData { public string startNode; public GameNode[] nodes; }这段代码定义了三个数据结构GameChoice 表示一个选项text 是按钮显示文本nextNode 是跳转目标requiredFlag 表示“只有满足某个状态才会显示该选项”setFlags 表示“选择该项后要记录的状态标记”。GameNode 表示一个剧情节点里面可以包含多个选项如果节点没有选项则使用 nextNode 直接跳转。GameData 是 JSON 最外层结构。这种设计相当于把剧情脚本和游戏逻辑解耦后续策划改剧情只改 JSON 即可。4.4 编写 GameManager.cs 核心逻辑新建脚本 GameManager.cs把它挂到场景中的一个空物体上比如 GameRoot。在 GameManager 中我们负责读取 JSON、构建节点索引、展示节点内容、生成选项按钮。using System.Collections.Generic; using UnityEngine; using UnityEngine.UI; public class GameManager : MonoBehaviour { [Header(剧情配置)] public TextAsset storyFile; [Header(UI 绑定)] public Text speakerText; public Text contentText; public Transform choicePanel; public GameObject choiceButtonPrefab; private GameData data; private Dictionarystring, GameNode nodeMap new Dictionarystring, GameNode(); private HashSetstring flags new HashSetstring(); void Start() { data JsonUtility.FromJsonGameData(storyFile.text); foreach (var node in data.nodes) { nodeMap[node.id] node; } RunNode(data.startNode); } void RunNode(string nodeId) { if (!nodeMap.ContainsKey(nodeId)) { Debug.LogError(节点不存在: nodeId); return; } var node nodeMap[nodeId]; speakerText.text node.speaker; contentText.text node.text; ClearChoices(); // 如果没有选项则直接跳转到 nextNode如果 nextNode 为空说明剧情结束 if (node.choices null || node.choices.Length 0) { if (!string.IsNullOrEmpty(node.nextNode)) { RunNode(node.nextNode); } return; } foreach (var choice in node.choices) { if (!string.IsNullOrEmpty(choice.requiredFlag) !flags.Contains(choice.requiredFlag)) { continue; } var button Instantiate(choiceButtonPrefab, choicePanel); button.GetComponentInChildrenText().text choice.text; var capturedChoice choice; button.GetComponentButton().onClick.AddListener(() OnChoiceSelected(capturedChoice)); } } void OnChoiceSelected(GameChoice choice) { if (choice.setFlags ! null) { foreach (var flag in choice.setFlags) { flags.Add(flag); } } RunNode(choice.nextNode); } void ClearChoices() { foreach (Transform child in choicePanel) { Destroy(child.gameObject); } } }这段代码的关键点说明如下nodeMap 使用 Dictionary 存储节点节点 id 是查询键避免每次遍历数组查找。flags 是 HashSet用来记录玩家走过的分支状态。某些选项可以设置 requiredFlag 作为前置条件比如“只有之前选择过‘询问发生了什么’才会出现‘继续追问’选项”。ClearChoices 每次进入新节点时清空旧的选项按钮避免 UI 重复。如果节点没有 choices同时没有 nextNode说明已经到达终点剧情结束。4.5 绑定 UI 与 运行验证在 Unity 编辑器中完成以下绑定把 story.json 拖到 GameManager 的 Story File 字段。把场景中的 SpeakerText 拖到 Speaker Text。把 ContentText 拖到 Content Text。把 ChoicePanel 拖到 Choice Panel。把 ChoiceButton 预制体拖到 Choice Button Prefab。点击 Play 按钮可以看到旁白的开场文字以及下方两个选项。点击不同选项文本会跳到对应的节点。如果当前节点只有一个直接跳转且没有选择会立刻继续跳转。整个流程跑通后再考虑接入视频、立绘和音效。4.6 结果说明以上原型已经具备了一个影游最核心的玩法循环展示剧情、阅读文本、做出关键选择、状态被记录、后续分支受影响。可以把它看作一个最小可用版本。如果在 Console 面板看到 JsonUtility 报错首先检查 JSON 是否是多字节编码格式Unity 默认按 UTF-8 处理建议用带 BOM 的 UTF-8 或者无 BOM UTF-8避免中文乱码。5. 接入 Steam从本地原型到 Steam 平台发售准备在 Steam 上发售互动影游除了游戏本身还需要做平台接入工作。这里讲清楚流程不涉及任何灰色手段只说明官方标准过程。Steam 发行主要分为几个步骤Steamworks 应用创建。Steamworks SDK 本地配置。构建游戏并上传 Depot。在 Steamworks 后台设置商店页、价格和版本分支。5.1 创建 Steamworks 应用并获取 AppID进入 Steamworks 官网登录 Steam 账号后在“应用管理”中选择创建新应用。填写应用名称后系统会分配一个 AppID。AppID 是后续所有接入工作的唯一标识。这个步骤需要注册 Steamworks 开发者账户根据 Valve 的规则发布应用需要支付一定费用请依据当前官方政策操作。5.2 配置 Steamworks SDK 与 steam_appid.txt下载 Steamworks SDK 后里面包含很多平台相关文件。最简单的方式是使用官方提供的 Steamworks.NET 库将动态库放入 Unity 项目。实际操作中常见流程是把 steam_appid.txt 放在项目可执行文件同目录或者 Unity 工程根目录内容只写一行480480 是 Valve 官方提供的测试 AppID用来本地测试。真正发布时必须改成你自己的 AppID。注意steam_appid.txt 只是开发阶段本地测试用玩家从 Steam 启动游戏时由 Steam 客户端注入 AppID不需要玩家自己创建这个文件。5.3 引入 SteamManager 简易初始化在正式接入时需要初始化 Steam 客户端 API。一个常见的做法是创建 SteamManager 单例脚本在游戏启动时初始化并在退出时关闭。这里给一个典型示例但具体 API 名称和调用方式请以你使用的 Steamworks SDK 版本为准。using Steamworks; using UnityEngine; public class SteamManager : MonoBehaviour { private static SteamManager instance; private bool initialized; private void Awake() { if (instance ! null) { Destroy(gameObject); return; } instance this; DontDestroyOnLoad(gameObject); try { initialized SteamAPI.Init(); } catch (System.Exception e) { Debug.LogError(SteamAPI.Init 失败: e); } } private void Update() { if (!initialized) return; SteamAPI.RunCallbacks(); } private void OnDestroy() { if (initialized) { SteamAPI.Shutdown(); } } }Steam 原生 SDK 的 C# 顶层接口可能在最新 SDK 中有调整上述示例仅表达初始化思路。实际项目中优先参考官方 SDK 附带的 C# 示例脚本。5.4 构建玩家内容并使用 SteamPipe 上传Unity 中打开 Build Settings切换到 PC、Mac 或 Linux 平台生成可执行文件。注意 Steam 要求游戏目录中附带必要的动态库文件夹。构建完成后使用 SteamPipe 工具上传游戏内容。准备好 AppID、Build ID 和 Depot ID 后创建 depot 配置文件例如DepotBuildFile depot_1000001.vdf DepotID 1000001 ContentRoot D:\GameBuild\content FileMapping *.exe . FileMapping *.dll . FileMapping *.json .实际文件名和路径要按照自己的项目修改。之后运行 SteamCMD 执行构建上传命令。这是官方支持的发行方式不涉及任何第三方灰色渠道。5.5 打包前一定要检查的事项互动影游上传时最容易出的问题不是程序崩溃而是文件缺失。视频文件、立绘、音频资源如果没有被 Unity 正确打进包玩家运行时会直接黑屏或缺字。发布前一定要反复测试从 Steam 下载后的纯净版本不要只测编辑器内运行。6. 常见问题与排查思路互动影游开发和上架阶段下面几类问题出现频率最高。问题现象常见原因解决思路中文文本乱码JSON 编码不是 UTF-8使用带 BOM 的 UTF-8 重新保存 story.json点击选项无反应Button 未绑定监听或 OnChoiceSelected 中捕获变量错误检查 Button.onClick 是否在运行时动态添加检查 capturedChoice 变量剧情跳回开头节点 id 写错Dictionary 找不到节点在 RunNode 开头加 Debug.Log确认当前 nodeId选项按钮越点越多ClearChoices 没有清理旧按钮确认进入新节点时先调用 ClearChoices本地 Steam 初始化报错steam_appid.txt 不存在或 AppID 无效在项目根目录创建 steam_appid.txt并写入测试 AppIDSteamPipe 上传失败Depot 配置路径错误或 ContentRoot 不存在检查 vdf 文件路径确认目录结构匹配视频播放黑屏视频编码格式不支持在 Unity 中优先使用 H.264 编码的 MP4并按目标平台调整设置排查时遵循一个原则先看数据再看 UI最后看平台。数据错误会出现“错误节点”“跳错分支”UI 错误会出现“按钮不显示”“点击无效”平台错误通常只在打包后才暴露出来。7. 最佳实践与工程建议当原型跑通后强烈建议从下面几个方向优化工程结构否则分支多到一定程度后项目会变得难以维护。第一剧情脚本与代码彻底分离。策划和编剧可以直接维护 JSON 文件不需要改代码。如果团队规模变大可以考虑使用 Inky 等可视化叙事工具导出 JSON再交给 Unity 运行时读取。第二状态变量命名要统一。比如用名词性前缀标识当前路线避免出现“flag_1”“flag_2”这种没有含义的名字。推荐使用诸如 truthPath、watchPath、gaveItem 这类清晰标记。第三做好分支复杂度控制。剧情分支并不是越多越好。每增加一个致命分支后续的测试量就会成倍上升。建议主线控制在有限的关键节点内保证玩家每次重玩都能获得明显不同的体验但不要无限膨胀。第四存档与状态恢复要提前设计。影游的核心是“选择积累”如果玩家中途退出必须能恢复到之前的状态。最简单的方式是把 flags 集合序列化成 JSON 保存到本地存档每次启动重新读档。第五多结局测试自动化。手动点几十次分支太耗时。可以写一个自动化测试脚本在编辑器模式下遍历所有节点检查每个选项是否存在死链接。出门前跑一遍能省下大量手工测试时间。第六发布前进行最小环境测试。有条件的话在一台没有安装开发环境、没有额外依赖的干净 Windows 上运行打包后的游戏确认动态库、配置文件都齐全。8. 总结与后续路线本文从一个真实的互动影游现象出发拆解了影游的核心玩法模型并用 Unity 和 JSON 实现了一个最小可运行的分支剧情原型。同时梳理了 Steam 平台发售的接入流程涵盖 AppID、Steamworks 配置、SteamPipe 上传和常见问题排查。掌握了这些内容你已经具备把一段剧情脚本变成可游玩原型的能力。下一步可以沿着几个方向继续深入把纯文本展示升级为视频播放器在关键节点插入短片并支持播放中跳过接入成熟的叙事插件 Ink 或 Yarn Spinner 来管理更复杂的条件逻辑为游戏增加成就、云存档和远程统计功能把 JSON 换成可视化剧情编辑器的输出产物让策划同事可以直接参与内容制作。互动影游的门槛不在于引擎功能而在于对“选择与结果”的理解。把本文的迷你框架跑通一遍再往里面填充你自己的剧情你离一款真正上架 Steam 的影游就不远了。如果这篇文章对你有帮助欢迎收藏备用后续我也会继续更新互动叙事和 Steam 接入相关的实战细节。