用途
该技能面向 Bevy 引擎的 ECS 物品栏实现。资料明确的使用时机为“物品堆叠在容器之间移动”时需要加载本技能;UI 网格仍由 bevy-ui-layout 处理,经济价格仍由 bevy-economy-system 处理。
主要能力
以 ECS 结构组织物品栏数据:组件(Components)为用户自定义的物品 id 与堆叠数量;资源(Resources)存放运行期全局表(指向 bevy-data-resources);系统(Systems)在 Update 或固定时间步中修改这些组件,并可用 .chain() 保证“伤害先于死亡”这类顺序;消息(Messages)承载一次性事实(命中、拾取、任务推进),指向 bevy-events-messaging,本文件不新增事件类型名。
资料用归属表说明三种需求:堆叠——组件上的物品 id 加数量,或资源 inventory 内;容器——拥有堆叠的实体;装备——标记组件,属性变化走 bevy-rpg-stats。范围说明指出物品 id、堆叠数量与容器均为组件,移动请求是消息,以便一个系统同时写入两个背包;栏位控件留在 bevy-ui-layout,价格留在 bevy-economy-system。
使用方式
示例包含 Cargo.toml:包名 inventory、版本 0.1.0、edition 2021,依赖 bevy = "0.20"。Rust 代码中定义了 ItemId(u32)、Stack { item, count }、Inventory { slots: Vec<Stack> }、MoveStack 消息(from、to、slot、count)、add_stack 函数、transfer 系统(使用 MessageReader 与 get_many_mut 在同一个查询中同时可变借两个背包),以及 InventoryPlugin(通过 add_message::<MoveStack>() 与 add_systems(Update, transfer) 注册)。另有 equip_first 系统示例(为无 Equipped 的实体插入装备标记)和 spawn_bags 示例(生成带 8 个 ItemId(1) 的背包与空背包)。跨系统借用规则为:两个同时对同一组件可变查询的系统必须用 .chain() 排序或拆分,否则会并行运行发生冲突。
适用场景
适用于 Bevy 0.20+ 项目中需要在实体之间转移物品堆叠、需要容器与装备标记、需要在固定时间步中稳定推进库存逻辑的场景;文档的决策表建议逐实体数据用 Component + Query,应用级配置或时钟用 Resource,稳定模拟步用 FixedMain 与 Fixed 时钟,启动生成用 Startup 中的 Commands。
限制
文档列出 NEVER 约束:不要在文档 URL 中固定 /0.20.0/,目标版本只在散文里声明一次;不要从两个未排序的系统可变查询同一组件;不要在此虚构物理、导航、网络或 XR crate;不要在 Bevy 代码中使用其他引擎的类型;不要使用虚构 API 或未具名的第三方 crate。资料仅列出官方文档链接(Assets、Examples、ECS、Plugins)与关联技能(bevy-master、bevy-ecs-composition、bevy-rpg-stats、bevy-ui-layout、bevy-data-resources、bevy-events-messaging、bevy-state-machines 等)。关于收费、价格、平台、效果等事实,资料暂未提供。