SuperAPI AI 工具集

bevy-genre-visual-novel

编程与开发

查看项目

更新于 10-16 11:40

技能介绍

用途

该技能是一个针对 Bevy 引擎「视觉小说」类型的轻量级类型路由器(thin router)。它不承担领域实现,只负责把视觉小说相关的领域工作分派到既有 Bevy 技能。官方描述指出,当需要处理对话(dialogue)、立绘(portraits)和选择标记(choice flags)时加载本技能。

主要能力

作为路由器,其能力体现在路由表上:

  • bevy-dialogue-system —— 台词。
  • bevy-ui-text —— 正文文本。
  • bevy-ui-layout —— 选择按钮。
  • bevy-save-load —— 路线标记。

此外,它给出视觉小说在 ECS 中的形态约定:

  • 组件(Components)以纯数据保存该类型的每实体标记,本文件不命名新的引擎类型。
  • 资源(Resources)保存全局计数器(分数、波次索引、随机种子),经由 bevy-data-resources。
  • 系统(Systems)在 Update 或来自 bevy-master 的固定时间步中读取这些组件,当后续系统需要看到结果时用 .chain() 排序。
  • 调度(Schedule):玩法模式切换通过 bevy-state-machines,不要发明类型插件。

使用方式

技能给出了一个最小示例:依赖声明中使用 bevy = "0.20"。一个资源持有脚本索引和后续场景读取的标记。示例定义了 Line(speaker、body)、资源 Script(lines、index、flags),以及 current_line、advance、set_flag 等函数。交互上:空格键推进,数字键选择选项并写入其标记。示例中还展示了 Choice 组件(key、flag、next_index)、读取按键的 read_advance 与 read_choice 系统,以及 NovelPlugin 的 build 中插入资源并在 Update 中添加 (read_advance, read_choice).chain()。启动时会生成两个选项,立绘名称作为独立实体上的组件。show_portrait 系统从当前行与立绘实体读取数据写入 ShownLine 资源。

适用场景

适用于在 Bevy 中构建视觉小说玩法:对话台词推进、角色立绘显示、选择分支与路线标记。路由器本身不拥有第二套实现。

限制与约定

目标版本为 Bevy 0.20+。核心 ECS 类型包括 Component、Resource、Query、Commands、Startup、Update、Fixed / FixedMain(bevy::time)、.chain()、Plugin、DefaultPlugins、MinimalPlugins。消息与观察者属于所有权槽位,其 API 参见 bevy-events-messaging。除非 .chain() 对冲突系统排序,否则系统并行运行。

所有权表:单实体数据由 Component 拥有,一个系统经 Query 修改,运行于 Update 或 FixedMain;全应用单值由 Resource 拥有,一个系统修改,Startup 插入后由读取它的调度处理;生成由 Commands 负责;不可竞态的顺序由 .chain() 约束;插件边界由 Plugin 在 build 中注册系统与资源。借用规则:两个都可变查询同一组件的系统必须排序(.chain())或拆分。

NEVER 规则:不要在文档 URL 中固定 /0.20.0/;不要从两个无序系统可变查询同一组件;不要在此发明物理、导航、网络或 XR crate;不要在 Bevy 代码中使用 Godot 类型;不要发明类型 API;不要在此挑选物理或网络 crate。