用途
当 Bevy 应用需要一个以离散步进移动(行走、跳跃手感、落地检测)的玩家或角色,并且需要在编写任何求解器代码之前先确定 ECS 结构时,加载本技能。土狼时间(coyote time)与跳跃缓冲(jump buffer)在这里是设计要点,不是某个节点的移植。
主要能力
本技能聚焦于 FixedUpdate 上的运动学数据:意图(intent)、速度(velocity)、土狼时间与跳跃缓冲。
ECS 形态要点:
- 组件(Components) 持有姿态与意图:位置、速度,以及作为数据的跳跃缓冲或土狼计时器。组件是派生
Component的 Rust 结构体。 - 资源(Resources) 持有每个移动者共享的时钟与调参。
bevy::time0.20.0 记录了Time、Fixed(固定时间步时钟)与Virtual。 - 系统(Systems) 读取意图并写入速度或位置,注册在固定调度上,而非逐节点的物理回调。
- 调度(Schedule):
run_fixed_main_schedule从虚拟时间运行FixedMain。依赖顺序的系统用.chain()排序。
引擎概念对照:
| Godot 概念 | Bevy 惯用法 |
|---|---|
| 自行移动的 Body | 带移动组件和系统的实体(Entity) |
| 帧时间变化时保持稳定的步进 | 固定时间步上的系统(Fixed / FixedMain) |
| 土狼时间、跳跃缓冲 | 实体上的计时器数据或一个小资源,由移动系统消费 |
| 碰撞响应 | 属于 bevy-physics-3d |
依赖声明:
[dependencies]
bevy = "0.20"
本技能给出的示例代码定义了 PlanarIntent(意图组件,含 axis 与 jump_pressed)、KinematicBody(含 velocity、grounded、coyote、jump_buffer)、MoveTuning 资源(含速度、跳跃速度、重力、土狼时间、跳跃缓冲时间及默认值),以及 read_move_intent、step_kinematic、spawn_mover 三个系统,并通过 CharacterMovementPlugin 注册:在 Startup 生成移动者、在 Update 读取移动意图、在 FixedUpdate 执行运动学步进。
使用方式
在 Update 中采样 ButtonInput::just_pressed。因为 FixedUpdate 在一帧中可能运行零次或多次,在那里读取按键会导致按下被丢弃或重复。意图组件会保留这一边沿,直到 FixedUpdate 消费它。
当某个物理技能写入 Grounded 时,把土狼时间补充(chain)在该写入之后,让计时器能在同一 tick 看到接触状态。示例代码给出了 Grounded、CoyoteTimer、CoyoteWindow 与 CoyotePlugin,通过 .chain() 将 refill_coyote 与 tick_coyote 排序。
此外技能说明了状态归属:单个实体的数据由 Component 持有、经 Query 由一个系统修改;全应用单值由 Resource 持有;生成由 Commands 在 Startup 完成;不得竞态的顺序由 .chain() 约束;插件边界由 Plugin 的 build 注册系统与资源。借用规则:两个都可变查询同一组件的系统必须排序(.chain())或拆分,使只有一个写入;不相关的系统保持并行。
适用场景与限制
本技能的目标版本为 Bevy 0.20+。范围内的移动是在 FixedUpdate 上的运动学数据:意图、速度、土狼时间与跳跃缓冲。碰撞响应属于 bevy-physics-3d。
明确禁止的做法:
- 不要在文档 URL 中固定
/0.20.0/;链接保持latest,0.20 目标仅在正文中陈述一次。 - 当步进需要保持稳定时,不要在原始
Update上步进移动;bevy::time为固定时钟记录了Fixed与run_fixed_main_schedule(FixedMain)。 - 不要在
FixedUpdate内读取ButtonInput::just_pressed;该调度可能跳过一帧或运行多次,导致按下丢失或应用两次。 - 不要调用
move_and_slide、_physics_process或CharacterBody2D;这些是 Godot 类型,本技能只负责 ECS 移动数据。 - 不要臆造角色控制器或形状投射(shape-cast)API;本技能负责运动学意图与固定步进,接触查询属于物理技能。
- 不要从两个无序系统可变查询同一移动组件;除非
.chain()排序,系统是并行运行的。
消息与观察者(observers)属于独立归属位,其 API 见 bevy-events-messaging。
参考文档包括 Bevy 官方 Quick Start: ECS、Fixed timestep 与示例树(latest 分支);相关技能包括前置的 bevy-master,互补的 bevy-physics-3d 与 godot-characterbody-2d,以及作为路由的 bevy-master。具体收费、价格与平台信息,资料中暂未提供。