SuperAPI AI 工具集

bevy-genre-educational

编程与开发

查看项目

更新于 10-16 10:38

技能介绍

bevy-genre-educational 介绍

用途

这是一个「薄路由」(thin router)技能,面向 Bevy 0.20 的教育类玩法循环。当需求涉及题目、答案与进度标记时加载本技能。它属于 game-design-agentic-skills 技能库中的 genre(类型)路由层,具体的领域工作由下列 Bevy 子技能承担。

ECS 形态与主要能力

资料给出的核心结构如下:

  • 组件(Components) 以纯数据形式保存一道题目和每个选项。
  • 资源(Resources) 保存已判分的答案数量与其中正确的数量。
  • 系统(Systems) 先选择一个选项,再对它判分。.chain() 保证判分在选择之后执行。
  • 调度(Schedule): 玩法模式切换经由 bevy-state-machines 处理。

依赖配置:

[package]
name = "educational"
version = "0.1.0"
edition = "2021"

[dependencies]
bevy = "0.20"

示意结构为「一道题、两个选项、一个进度资源」,定义了 Prompt(含 text)、Choice(含 label、correct、picked、graded)两个组件,以及 LessonProgress(含 answered、correct)资源。

spawn_lesson 在启动时生成题目与选项,并初始化 LessonProgress 资源。

pick_first 选择第一个未被判分且未被选中的正确选项,将其标记为已选中。

grade 对已选中且未判分的选项累加已答数与正确数,并重置选中状态。

LessonPlugin 在 Startup 中执行 spawn_lesson,在 Update 中以 (pick_first, grade).chain() 串联两个系统。资料说明:由于 pick_first 与 grade 都会写入 Choice,所以必须保持链式顺序。

show_score 只读取进度资源,ScorePlugin 初始化 LessonProgress 并注册该系统。

使用方式

  1. 为项目引入 Bevy 0.20 依赖。
  2. 按教育玩法的领域数据定义题目、选项组件与进度资源。
  3. 通过插件(Plugin)在 build 中注册系统与资源。
  4. 对存在写冲突的系统使用 .chain() 排序。
  5. 需要提示、选项、存档、模式切换时,路由到对应子技能。

路由说明

  • bevy-ui-text —— 提示(Prompts)。
  • bevy-ui-layout —— 选项(Choices)。
  • bevy-save-load —— 进度存档(Progress saves)。
  • bevy-state-machines —— 课程模式(Lesson mode)。

前置技能包括 bevy-master(ECS 所有权与调度)与 bevy-ecs-composition(生成与查询形态)。本路由下游没有第二个实现。

适用场景

适合按 Bevy 惯用 ECS 方式搭建「题目—选项—判分—累计进度」循环的开发者,尤其是需要保证选择与判分顺序不能竞态、且把整局进度集中存放在一个 Resource 中的教育类玩法。

限制与约束

资料明确列出以下 NEVER 规则:

  • 不在文档 URL 中固定 /0.20.0/,链接保持在 latest,0.20 目标只在正文中声明一次。
  • 不让两个无序系统可变查询同一个组件,因为调度默认并行执行,除非用 .chain() 排序。
  • 不在本技能中发明物理、导航、网络或 XR 相关 crate,因为这里只命名有文档的 Bevy crate 与模块。
  • 不使用场景树(scene-tree)类型,代码保持惯用 ECS,只用有文档的 Bevy API。
  • 不发明类型(genre)API。
  • 不在此处选择物理或网络 crate。

所有权方面:单个实体的数据由 Component 持有、经 Query 由一个系统修改;整个应用一个值由 Resource 持有;生成走 Commands;不能竞态的顺序由 .chain() 保证;插件边界由 Plugin 的 build 在应用运行前注册。借用规则:两个都可变查询同一组件的系统必须排序或拆分,只保留一个写入者。

参考资料指向 Bevy 官方文档的 Assets、Examples、ECS、Plugins 页面。其他信息(如收费、价格、平台、具体效果、安装命令等)在资料中暂未提供。