用途:当游戏以阅读分支文本为主、配合角色立绘与背景时使用,例如视觉小说、恋爱模拟、分支互动小说、剧情选择游戏;也用于设计选项/路线结构、剧情标记(flags)以及回顾、跳过、自动推进、随处存档等便利功能。若对话只是大型游戏中的一个功能,应改用对话系统技能;卡牌/棋盘类玩法不属于此范围。分支脚本引擎本身建议使用 dialogue-systems(Ink / Yarn Spinner)。
主要能力:分支脚本(有序台词、选项、跳转,含条件与变量);文本框(说话人名称、正文、打字机式逐字显示、点击或按键推进);角色(带表情/姿势的立绘、位置、显示隐藏过渡);背景与过渡(场景图、淡入淡出/溶解);选项(展示选项、按标记解锁、记录选择);剧情状态(标记/变量驱动分支与解锁内容);存档/读档(随处存档、完整脚本位置与状态、多槽位、快速存档);VN 便利功能(回顾/历史、跳过已读文本、自动推进、文字速度设置);音频(按场景音乐、音效、可选语音)。
使用方式:脚本作为数据由引擎逐步读取,引擎向脚本请求“下一个要显示的内容”;打字机显示时首次按键立即显示整行,再次按键进入下一行;选项写入标记,后续条件读取标记实现反应性。设计上可调文字速度、自动推进延迟、跳过范围、分支广度与深度、标记解锁内容、路线结构、选项可见性、回顾长度。
限制与注意:存档不能只存检查点,需持久化精确脚本位置、全部标记/变量与已读文本数据;表现逻辑不要写进脚本,内容与外观应分离;缺少跳过/自动/回顾会让重玩体验差;跳过应只快进已读文本;无后果的选项会显得虚假;分支组合爆炸会导致无法完成,建议分支合并加少量标记变化;需保留历史缓冲;文本应数据化以便本地化。具体实现细节与参考文件见资料中的 references/script-and-flow.md。