SuperAPI AI 工具集

bevy-genre-platformer

编程与开发

查看项目

更新于 10-16 11:40

技能介绍

用途

这是一个平台跳跃(platformer)类型的路由器(thin router)。它本身不完成具体领域工作,而是把平台跳跃所需的实现路由到相应的 Bevy 技能上,用于处理移动、相机与瓦片。当需要把平台跳跃路由到 movement、camera 和 tiles 时加载本技能。

主要能力与 ECS 形态

  • Components:以纯数据形式保存该类型的每实体标志。本文件不命名新的引擎类型。
  • Resources:通过 bevy-data-resources 保存全局计数器(score、wave index、seed)。
  • Systems:在 Update 或来自 bevy-master 的固定时间步上读取这些组件。当后续系统需要看到结果时,用 .chain() 排序。
  • Schedule:玩法模式切换走 bevy-state-machines。不要自造 genre plugin。

路由指向以下技能:bevy-character-movement(运动)、bevy-camera-systems(跟随相机)、bevy-tilemap(地面瓦片)、bevy-2d-animation(精灵动画片段)。

使用方式(示例要点)

依赖声明为 bevy = "0.20"。

土狼时间与跳跃缓冲保存在 mover 上。重力与跳跃在同一个系统中写入 velocity,从而避免竞态。示例给出 Mover 组件(含 velocity、grounded、coyote、jump_buffer 字段)、arm_jump 系统(按下空格时把 jump_buffer 设为 0.15)、feel 系统(在 Time<Fixed> 上更新 coyote 与 jump_buffer,满足条件时设置 velocity.y = 420.0,并按上升/下落使用不同重力值),以及 install_feel 把它们分别注册到 Update 与 FixedUpdate。

文中指出:arm_jump 与 feel 都写 Mover,且位于不同 schedule。若产生借用冲突,把 arm_jump 移到 FixedUpdate 并在 feel 之前 .chain()。

integration 读取 Mover、写入 Transform,应链在 feel 之后,示例按 time.delta_secs() 累加位移。

单向平台是一个带顶部高度的组件 OneWay(half_width、top)。mover 只在下落时吸附:land 系统在下落(velocity.y <= 0)时,判断水平距离是否在 half_width 内、脚部与平台顶部差值是否小于 6.0,满足则设为 grounded 并把 velocity.y 归零。

相机复制玩家的 translation 并保留自身 z:follow 系统用 Player 查询玩家 Transform,对带 Camera2d 且不含 Player 的相机写入 x、y。

适用范围与限制

  • 瓦片碰撞与精灵片段路由到 bevy-tilemap 和 bevy-2d-animation。
  • land 与 feel 都写 Mover,两者都安装时需在 FixedUpdate 上 .chain()。
  • 目标版本为 Bevy 0.20+。
  • 核心 ECS 类型包括 Component、Resource、Query、Commands、Startup、Update、Fixed/FixedMain(bevy::time)、.chain()、Plugin、DefaultPlugins、MinimalPlugins。消息与观察者属于所有权槽位,其 API 见 bevy-events-messaging。系统默认并行运行,除非用 .chain() 排序冲突项。
  • 若干禁止事项:不要在文档 URL 中固定 /0.20.0/;不要从两个无序系统可变查询同一组件;不要在本技能中臆造 physics、navigation、networking 或 XR crate;不要在 Update 上施加重力而让 coyote 与跳跃缓冲在 FixedUpdate 上计时;不要从 arm_jump 与 feel 在两个 schedule 上写 Mover;不要发明 genre API;不要在此选择 physics 或 net crate。
  • 参考资料:bevy-master 的库版本固定为 0.20.0,官方页面保持在无版本的 latest 分支。官方文档包括 Assets、Examples、ECS、Plugins。相关技能分前置(bevy-master、bevy-ecs-composition)、互补(godot-genre-platformer、bevy-character-movement、bevy-camera-systems、bevy-tilemap、bevy-2d-animation)、下游消费者(无,本路由器不拥有第二实现)与 master(bevy-master)。

专家知识增量

状态所有者表说明:单实体数据由 Component 承载、由某系统经 Query 修改,运行于 Update 或 FixedMain;全应用单值由 Resource 承载、单系统修改,Startup 插入后由读取它的 schedule 使用;Spawn 由生成系统用 Commands 完成,初始世界用 Startup,运行时生成用后续 schedule;不可竞态的顺序由 .chain() 保证,仅限被链系统,同一 schedule;插件边界由 Plugin 的 build 注册系统与资源,在应用运行前完成。借用规则:两个都可变查询同一组件的系统必须排序(.chain())或拆分到只有一个写入,无关系统保持并行。

决策表说明:每实体数据用 Component+Query,不要存到实体外的字段;应用级配置或时钟用 Resource,不要复制到每个实体;稳定模拟步用 FixedMain 与 Fixed 时钟,不要把模拟绑到原始帧 Update;启动生成用 Startup 中的 Commands,不要从渲染系统生成;非共享状态的跨系统通知使用 bevy-events-messaging 中的消息或观察者槽位,不要在本文件发明新事件类型;文档集合之外的 API 使用本技能中的示例,不要使用臆造的 crate 或 API。更多所有权表见 references/ecs-ownership.md。