用途
bevy-genre-rts 是一个针对 Bevy 0.20 的即时战略(RTS)类型路由器(thin router)。它用于处理选择(selection)、移动指令(orders)和控制编组(groups)这些 RTS 类型特有的机制。领域工作本身并不在本技能内实现,而是路由到其他 Bevy 技能。
主要能力
按照 ECS 组织方式划分:
- Components:保存该类型每个实体的标志,作为纯数据。本技能不引入新的引擎类型。示例中定义了
Selected(标记当前选中组)、MoveOrder { target: Vec3 }、Selectable等组件。 - Resources:通过 bevy-data-resources 保存运行范围的计数(分数、波次索引、种子)以及控制编组
ControlGroup { members: Vec<Entity> }。 - Systems:在
Update或来自 bevy-master 的固定时间步上读取这些组件。当后续系统必须看到前一系统的结果时,用.chain()排序。 - Schedule:游戏模式切换通过 bevy-state-machines 处理。不发明类型插件。
具体功能包括:
- 选择:点击选择使用由另一个系统填充的指针资源,半径内的单位获得
Selected组件。 - 移动指令:移动指令是一个目标点,按下按键后把
Selected单位的MoveOrder.target设为指定坐标;march 系统在指令写入后运行,按固定时间步把单位朝目标点移动。 - 控制编组:数字键把选中的实体存到资源上;再次按下该键会清除
Selected并恢复该编组。
使用方式
示例 Cargo 配置:
[package]
name = "rts"
version = "0.1.0"
edition = "2021"
[dependencies]
bevy = "0.20"
指令与行军示例:用 Selected 标记当前组,移动指令是一个目标点,march 在指令写入之后运行,二者通过 .chain() 组合:
#[derive(Component)]
struct Selected;
#[derive(Component)]
struct MoveOrder {
target: Vec3,
}
fn issue_move(keys: Res<ButtonInput<KeyCode>>, mut units: Query<&mut MoveOrder, With<Selected>>) {
if !keys.just_pressed(KeyCode::KeyM) {
return;
}
for mut order in &mut units {
order.target = Vec3::new(12.0, 0.0, 6.0);
}
}
fn march(time: Res<Time<Fixed>>, mut units: Query<(&MoveOrder, &mut Transform)>) {
let dt = time.delta_secs();
for (order, mut transform) in &mut units {
let delta = order.target - transform.translation;
let step = 6.0 * dt;
if delta.length() <= step {
transform.translation = order.target;
} else {
transform.translation += delta.normalize_or_zero() * step;
}
}
}
pub struct OrderPlugin;
impl Plugin for OrderPlugin {
fn build(&self, app: &mut App) {
app.add_systems(FixedUpdate, (issue_move, march).chain());
}
}
控制编组示例:数字键把选中实体存到资源,再次按键清除 Selected 并恢复组:
#[derive(Resource, Default)]
struct ControlGroup {
members: Vec<Entity>,
}
#[derive(Component)]
struct Selected;
fn bind_group(
keys: Res<ButtonInput<KeyCode>>,
selected: Query<Entity, With<Selected>>,
mut group: ResMut<ControlGroup>,
mut commands: Commands,
) {
if keys.just_pressed(KeyCode::Digit1) && keys.pressed(KeyCode::ControlLeft) {
group.members.clear();
for entity in &selected {
group.members.push(entity);
}
return;
}
if keys.just_pressed(KeyCode::Digit1) {
for entity in &selected {
commands.entity(entity).remove::<Selected>();
}
for entity in group.members.clone() {
commands.entity(entity).insert(Selected);
}
}
}
点击选择示例:使用由另一个系统填充的指针资源,半径内的单位获得 Selected:
#[derive(Resource)]
struct PointerWorld(Vec3);
#[derive(Component)]
struct Selectable;
#[derive(Component)]
struct Selected;
fn click_select(
buttons: Res<ButtonInput<MouseButton>>,
pointer: Res<PointerWorld>,
mut commands: Commands,
units: Query<(Entity, &Transform), With<Selectable>>,
selected: Query<Entity, With<Selected>>,
) {
if !buttons.just_pressed(MouseButton::Left) {
return;
}
for entity in &selected {
commands.entity(entity).remove::<Selected>();
}
for (entity, transform) in &units {
if transform.translation.distance(pointer.0) < 1.5 {
commands.entity(entity).insert(Selected);
}
}
}
fn spawn_units(mut commands: Commands) {
commands.insert_resource(PointerWorld(Vec3::ZERO));
for index in 0..4 {
commands.spawn((
Selectable,
MoveOrder {
target: Vec3::new(index as f32 * 2.0, 0.0, 0.0),
},
Transform::from_xyz(index as f32 * 2.0, 0.0, 0.0),
));
}
}
#[derive(Component)]
struct MoveOrder {
target: Vec3,
}
路由关系
- bevy-input-handling:选择点击。
- bevy-ai-navigation:移动指令与导航。
- bevy-combat-system:攻击。
- bevy-economy-system:费用。
前置技能:bevy-master(ECS 所有权与调度)、bevy-ecs-composition(生成与查询形态)。
适用场景与限制
适用于 Bevy 0.20+ 的 RTS 类型中涉及选择、移动指令和控制编组的场景。目标为 Bevy 0.20+。寻路仍由 bevy-ai-navigation 负责。
状态归属约定:单个实体上的数据由 Component 持有,通过 Query 由单个系统修改,运行在 Update 或 FixedMain;整个应用的一个值由 Resource 持有,由单个系统修改,Startup 插入后由读取它的调度运行;生成用 Commands;不能竞态的次序用 .chain();插件边界用 Plugin。借用规则:两个同时可变查询同一组件的系统必须排序(.chain())或拆分,使只有一方写入;不相关的系统保持并行。
明确禁止事项(NEVER):
- 不要在文档 URL 中固定
/0.20.0/。原因:链接保持在latest;0.20 目标只在正文中声明一次。 - 不要从两个无序系统可变查询同一组件。原因:除非
.chain()排序,否则调度并行运行系统。 - 不要在本技能中发明物理、导航、网络或 XR crate。原因:本技能只命名有文档的 Bevy crate 和模块。
- Bevy 代码中不使用场景树类型。原因:Bevy 代码保持惯用 ECS,只使用有文档的 Bevy API。
- 不发明类型 API。原因:Bevy 代码保持惯用 ECS,只使用有文档的 Bevy API。
- 不在此处挑选物理或网络 crate。原因:Bevy 代码保持惯用 ECS,只使用有文档的 Bevy API。
消息和 observer 属于所有权槽位,其 API 见 bevy-events-messaging。bevy-master 上的库版本固定保持 0.20.0,官方链接保持在无版本号的 learn 页面。