SuperAPI AI 工具集

bevy-genre-rts

编程与开发

查看项目

更新于 10-16 10:38

技能介绍

用途

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 页面。