SuperAPI AI 工具集

bevy-genre-romance

编程与开发

查看项目

更新于 10-16 10:39

技能介绍

用途

本技能是 Bevy 引擎下「恋爱(Romance)」题材的路由入口,用于在对话系统之上处理关系数值与场景路线。它自身不定义新的引擎类型,而是说明该题材应该由哪些 Bevy 子技能承担具体实现,并给出可对照的 ECS 结构范式。

主要能力

  • 关系数值:用 Component 保存单个角色的每实体数据,例如 Bond 中的 affection(好感度)和 last(最近一次选择)。
  • 全局路线状态:用 Resource 保存整个运行周期共享的计数与标记,例如 RouteFlags 中的 confession_open 和 scene。
  • 选择处理与路线推进:系统读取组件与资源,应用选择后计算下一场景编号;涉及同一组件时通过 .chain() 明确执行顺序,避免并行竞争。
  • 场景门控:场景实体携带 SceneGate { id, min_affection },只有当好感度不低于该场景要求的最低值时场景才可用。
  • 运行模式切换:玩法模式变化交由 bevy-state-machines 处理。
  • 事件通知:循环内的通知类逻辑归入 bevy-events-messaging。

使用方式

文档给出以 bevy = "0.20" 作为依赖的示例。示例定义 Choice 枚举(Warm / Cool)、Bond 组件与 RouteFlags 资源;boot 在 Startup 中插入初始资源并生成带 Bond 的实体;apply_choice 根据按键(Digit1 / Digit2)更新 last 与 affection(Warm +10,Cool -5);advance_route 根据好感度是否达到 30 决定 confession_open 并设置 scene。两个系统通过 .chain() 组合,保证先应用选择再推进路线。

ECS 归属约定包括:单实体数据用 Component + Query;全应用共享值用 Resource;稳定模拟步进使用 FixedMain 与 Fixed 时钟;初始生成在 Startup 中用 Commands;必须避免竞争的顺序用 .chain();插件边界用 Plugin 的 build 注册系统与资源。同一组件的两个可变查询必须有顺序或拆分为单一写入方。

适用场景

适用于在 Bevy 中制作恋爱题材游戏的场景管理与关系数值系统:需要按好感度阈值解锁剧情、根据玩家选择切换路线、用资源记录全局路线标记并在存档中保留这些标记。

限制

  • 目标版本为 Bevy 0.20+,只使用文档中列出的 Bevy crate 与 API。
  • 不涉及物理、导航、网络或 XR 相关 crate,也不在本技能中选定此类依赖。
  • 文档 URL 不固定具体小版本,官方页面保持无版本永久链接。
  • 不定义新的引擎类型或题材 API,关系数据在示例中以普通组件与资源表达。

关联技能

前置:bevy-master、bevy-ecs-composition。互补:godot-genre-romance、bevy-dialogue-system(场景)、bevy-rpg-stats(自定义好感度数值)、bevy-save-load(路线标记存取)。