SuperAPI AI 工具集

bevy-genre-racing

编程与开发

查看项目

更新于 10-16 11:37

技能介绍

用途

该技能是一个竞速类型的薄路由器(thin router),面向 Bevy 0.20。它的职责不是提供完整的赛车实现,而是在需要处理圈数、分段计时和自有车辆运动时,把具体领域工作导向其他 Bevy 技能。资料明确说明:领域工作位于其引用的各个 Bevy 技能中。

主要能力与 ECS 结构

资料给出的核心模式是:

  • 组件(Component)以普通数据形式保存每个实体的标记,圈数索引、门的顺序和运动学车辆都是组件。
  • 资源(Resource)保存整局共享的计数器,比赛时钟(RaceClock)是一个资源。
  • 系统在 Update 或固定时间步上读取组件,当后续系统必须看到前一步结果时使用 .chain() 排序。
  • 玩法模式切换经由 bevy-state-machines 处理,不自行发明类型插件(genre plugin)。

资料提供了可参考的 Rust 代码示例:RaceClock 资源记录 elapsed、best_lap、lap_start;Racer 组件保存 lap、next_gate、gate_count;Gate 组件保存 index。tick_clock 系统在 FixedUpdate 中累加时钟;cross_gates 系统在赛车接近下一个门时更新 next_gate,若为最后一个门则计算单圈时间、更新最佳圈速、重置 lap_start、增加圈数并把 next_gate 归零。RacePlugin 在 build 中插入 RaceClock 资源,并使用 add_systems(FixedUpdate, (tick_clock, cross_gates).chain()) 串联两个系统。

车辆方面,Vehicle 组件保存 speed 与 heading,drive 系统根据按键输入改变朝向与速度,并只由一个系统写入 Transform。启动时 spawn_track 通过 Commands 生成赛车与三个沿 Z 轴间隔排列的门。

所有权规则与决策

资料给出状态所有权表:单个实体上的数据由组件持有,由一个系统通过 Query 修改;整个应用唯一的值由资源持有;生成使用 Commands,初始世界在 Startup;不能被竞争的排序使用 .chain();插件边界由 Plugin 的 build 注册系统与资源。借用规则指出:两个都可变查询同一组件的系统必须有排序(.chain())或拆分,使只有一个写入;不相关的系统保持并行。

决策表给出的选择包括:按实体数据用 Component + Query;应用级配置或时钟用 Resource;稳定模拟步长用 FixedMain 与 Fixed 时钟;启动生成用 Startup 中的 Commands;圈数与分段计时用 Racer 加 RaceClock 资源并在 FixedUpdate 步进。

使用方式

资料中的示例使用 bevy = "0.20" 作为依赖,展示了 Cargo.toml 片段,并给出组件定义、系统、插件与启动生成的代码。使用者应按这些模式组织自己的竞速玩法代码,并参考其引用的相关技能完成分段计时、角色/车辆运动与赛道搭建。

适用场景

适用于在 Bevy 0.20 中处理自有车辆运动、圈数、分段计时和门的判定顺序的场景,尤其是在需要遵循惯用 ECS 结构、避免系统竞争的情况下。

限制

资料明确说明:刚性体车辆求解器不在此技能范围内,一旦选定物理技能,它由该物理技能负责。此路由器不拥有第二个实现。此外,禁止在文档 URL 中固定 /0.20.0/ 版本、禁止从两个无序系统可变查询同一组件、禁止在此发明物理、导航、网络或 XR crate、禁止使用场景树类型、禁止发明类型 API、禁止在此挑选物理或网络 crate。关于收费、价格、平台或效果等信息,资料暂未提供。