Legion已经被包含在Rust的 crate 仓库中了,所以安装它的方式和安装 bracket-lib 的方式很类似。在 dungeoncrawl 项目中打开 Cargo.toml 文件,将Legion加到依赖项列表中:
[dependencies] bracket-lib="~0.8.1" legion="=0.3.1"
注意,这里使用等号( = )为Legion指定了精确的版本号。Legion还在快速的开发迭代过程中,这样做可以保证当前项目使用特定的发布版本。
在开发一个项目时,一旦完成了最初的项目规划和搭建,那么最好使用等号(=)来把依赖项固定下来。这样可以保证在依赖库更新并变更其API时,自己的项目不会受到影响。
在此后的程序中,几乎每个地方都会用到Legion。与其在每个地方写一遍 uselegion::* ,不如在自己的 prelude 模块中重新导出Legion里面的内容,就像之前为 bracket-lib 所做的处理一样。打开项目中的 main.rs 文件,然后将Legion添加到自己的 prelude 模块中:
mod prelude { pub use bracket_lib::prelude::*; pub use legion::*; pub use legion::world::SubWorld; pub use legion::systems::CommandBuffer; ... }
这样,在每一个导入了自己编写的 prelude 模块的地方,就都可以访问到Legion提供的功能了。
现在你需要把之前版本中的一些代码替换为使用ECS的版本。现在不需要再把玩家角色当做特殊情况来处理了,它只是另一个实体而已。从项目中删除 player.rs ,然后从 main.rs 的 prelude 中删除 mod player; 这一行。在同一个文件中,将玩家角色相关的信息从 State 中删除,并且将 tick 函数重新删减为一个简单的桩函数:
impl GameState for State { fn tick(&mut self, ctx: &mut BTerm) { ctx.set_active_console(0); ctx.cls(); ctx.set_active_console(1); ctx.cls(); //TODO: Execute Systems //TODO: Render Draw Buffer } }
此外,你需要从 map.rs 文件中删除 render() 函数。
Legion将所有的实体和组件存储在一个名为 World 的结构体中。你需要创建一个 World 对象来存储游戏中的所有实体。修改 main.rs 中的 State 类型,使之包含一个类型为 World 的字段,以及一个可以持有各种系统的 Schedule 类型的字段。最后,还要从 State 中删除摄像机和地图相关的字段:
struct State { ecs : World, resources : Resources, systems: Schedule }
现在,游戏地图不再是游戏状态的一部分了,而是一个资源——也就是一块可以被共享的数据,对于所有需要用到它的系统都是有效的。地图的创建逻辑还是一样的,但是你不再将地图存储在 State 中,而是将其插入Legion的资源列表中——资源列表也是需要被初始化的。摄像机也变成了资源。注意,这里存储的并不是 map_builder ,而是只存储了它所构建出来的地图。更新 State 的 new() 函数,使之创建出 World 和 Resources 类型的对象。然后将地图和摄像机作为资源插入其中:
fn new() -> Self { let mut ecs=World::default(); let mut resources=Resources::default(); let mut rng=RandomNumberGenerator::new(); let map_builder=MapBuilder::new(&mut rng); resources.insert(map_builder.map); resources.insert(Camera::new(map_builder.player_start)); Self { ecs, resources, systems: build_scheduler() } }
注意,这里用到的 build_scheduler() 函数还不存在,相关内容参见6.5.1节。
World 和 Resources 两个类型的对象都是通过一个名为 default 的简单构造函数创建出来的。地图生成器的初始化方式和之前是一样的,但是不同于之前将其存储在 State 中,这里使用 insert() 将其注入游戏的资源列表里面。
评论 0条