SuperAPI AI 工具集

bevy-genre-tower-defense

编程与开发

查看项目

更新于 10-16 11:40

技能介绍

用途

这是一个面向 Bevy 引擎塔防(Tower Defense)玩法的类型路由技能(thin router)。当需要处理防御塔放置、小怪(creep)沿路径点(waypoint)行进、以及在固定时间步长上花费金币等场景时加载该技能。它的定位是路由,领域具体工作交由下列 Bevy 技能完成,本技能不拥有第二份实现。

主要能力与 ECS 结构

  • Components:以普通数据形式保存该类型每个实体的标志;本文件不命名新的引擎类型。
  • Resources:通过 bevy-data-resources 保存全局计数(分数、波次索引、随机种子)。
  • Systems:在 Update 或来自 bevy-master 的固定时间步长上读取这些组件;当后一个系统必须看到前一个系统的结果时,用 .chain() 排序。
  • Schedule:玩法模式变更走 bevy-state-machines,不要自创类型插件。

范围说明:防御塔、小怪、路径点和金币都是普通组件与一个资源;导航网格(navigation mesh)属于 bevy-navigation。

使用方式(示例)

依赖配置使用 Bevy 0.20:

[package]
name = "tower-defense"
version = "0.1.0"
edition = "2021"

[dependencies]
bevy = "0.20"

小怪沿路径点列表行进;冷却完毕且射程内的防御塔消耗一次射击并伤害最近的 creep;金币是一个资源。示例中定义了 Tower、Creep 组件与 Path、Gold 资源,以及 march_creeps、towers_fire 等系统。启动(Startup)时插入路径与金币,然后生成一个防御塔和一个 creep;两个系统共享 Creep,因此在一个链中运行。出售防御塔会返还金币并销毁它,由一个系统同时拥有这两处写入。

状态归属

  • 单个实体上的数据:Component,由一个系统通过 Query 变更,运行于 Update 或 FixedMain。
  • 全应用单一值:Resource,由一个系统变更,Startup 插入,之后在读取它的调度中处理。
  • 生成:Commands,由生成的系统负责,初始世界用 Startup,运行时生成用后续调度。
  • 不能竞态的顺序:.chain(),仅限被链起来的系统,同一调度内。
  • 插件边界:Plugin,build 注册系统与资源,在应用运行前执行。

借用规则:两个都可变查询同一组件的系统必须排序(.chain())或拆分使只有一个写入;不相关的系统保持并行。

决策参考

  • 需要每实体数据:用 Component + Query,不要用 Godot 节点脚本。
  • 需要全应用配置或时钟:用 Resource,不要把值复制到每个实体上。
  • 需要稳定模拟步长:用 FixedMain 与 Fixed 时钟,不要把模拟绑定到原始帧 Update。
  • 启动生成:在 Startup 中用 Commands,不要从渲染系统生成。
  • 跨系统通知且非共享状态:使用 bevy-events-messaging 中的消息或观察者槽位,不要在本文件中新造事件类型。
  • 需要文档集合之外的 API:先查官方文档,不要编造 crate 或 API。

从 Godot 迁移对照

  • Godot 的类型场景树 → 实体加上下方链接的领域技能。
  • Godot 的 Autoload director → 一个资源,而非单例节点。
  • 用于循环的信号总线 → bevy-events-messaging。

路由到的相关技能

  • bevy-game-loop-waves:小怪波次。
  • bevy-navigation:路径与导航网格。
  • bevy-combat-system:防御塔射击。
  • bevy-economy-system:建造花费。

前置技能包括 bevy-master(ECS 归属与调度)、bevy-ecs-composition(生成与查询形态)。互补技能包括 godot-genre-tower-defense(等价的 Godot 技能)等。

限制与禁止事项

  • 不要在文档 URL 中固定 /0.20.0/;链接保持在 latest,0.20 目标只在正文中说明一次。
  • 不要从两个无序系统中可变查询同一组件,因为调度会并行运行系统,除非 .chain() 对其排序。
  • 不要在本技能中自创物理、导航、网络或 XR crate,因为本技能只命名有文档的 Bevy crate 与模块。
  • Bevy 代码中不出现 Godot 类型,不编造类型 API,不在这里挑选物理或网络 crate。

参考资料

官方文档包括:bevy crate(API 参考与 Cargo 特性列表)、Assets、Examples(latest 分支示例树)、ECS(Component、系统、Query、Startup、Update 与 .chain())、Plugins(Plugin、DefaultPlugins、MinimalPlugins 与 add_plugins)。

有关本技能的具体收费、价格、平台或使用效果,资料暂未提供。