首页 / 小说书库 / Rust游戏开发实战 / 正文
点评
13.2 管理背包

物品并不总是静置于地图上,等待玩家走到它们上面。同样,除非你是在设计一款吃豆人风格的游戏,否则让物品在玩家踩过它们时立即生效也是没有意义的。你需要让玩家角色把物品捡起来,装在背包里并继续前进,待到需要时再用掉它们。这会给游戏增添一些策略性,也就是说,玩家需要决定应该在什么时间使用这些宝贵的物品。

物品也是实体,它们之所以能够出现在地图上,是因为有 Point 组件指示它们在地图上的位置。实体渲染系统中的查询逻辑要求实体有一个用来绘制物品或者展示悬浮提示的Point组件。你可以在物品被捡起后就将其 Point 组件移除,这样就巧妙地利用了渲染系统的查询机制来实现捡起物品的效果。换句话说,物品被捡起以后,在地图上就没有其位置信息了。

捡起物品的行为要求开发者删除物品的 Point 组件,同时为物体添加一个 Carried 组件,该组件会存储一个 Entity 类型的数据指向携带该物品的实体。打开 components.rs ,添加一个新的组件,以表示另一个实体携带着当前物品:

#[derive(Clone, PartialEq)] pub struct Carried(pub Entity);

下面你需要添加一些处理玩家输入的代码,以让玩家角色能捡起物品。

之前你是在 systems/player_input.rs 中处理玩家输入的。你需要将G按键的功能指定为获取(get)位于玩家角色脚下的任何物品。首先,将 Item 和 Carried 添加到该系统能够读取的组件列表中:

#[system] #[read_component(Point)] #[read_component(Player)] #[read_component(Enemy)] #[write_component(Health)] ➤ #[read_component(Item)] ➤ #[read_component(Carried)] pub fn player_input(

上述代码表示允许该系统访问这些类型的数据。找到 player_input() 函数,然后找到以 let delta=match key{ 开头的代码段,为 match 语句添加另一个判断选项:

❶ VirtualKeyCode::G => { ❷ let (player, player_pos)=players .iter(ecs) ❸ .find_map(|(entity, pos)| Some((*entity, *pos))) .unwrap(); ❹ let mut items=<(Entity, &Item, &Point)>::query(); items.iter(ecs) ❺ .filter(|(_entity,_item, &item_pos)| item_pos==player_pos) .for_each(|(entity,_item,_item_pos)| { ❻ commands.remove_component::<Point>(*entity); ❼ commands.add_component(*entity, Carried(player)); } ); Point::new(0, 0) },

❶ 如果玩家按下G键,就为其匹配这个分支。

❷ 创建一个查询及其迭代链,使其返回一个同时包含玩家角色实体( Entity 类型)和玩家角色位置的元组。

❸ find_map 返回迭代器中的第一个元素,并将结果映射为指定的字段。

❹ 创建一个查询,使其只返回同时具有 Item 标签和 Point 组件的实体所包含的这两个组件,以及持有这两个组件的 Entity 本身。

❺ 用 filter() 来保留位置与当前玩家所在位置相同的结果。

❻ 将 Point 组件从物品中移除。

❼ 添加 Carried 组件,并将玩家角色实体作为携带者。

现在运行游戏,玩家角色会找到一个药水或者卷轴,站到它的上面然后按G键,相应的物品会从地图上消失——因为这个物品正在被玩家角色“携带”。接下来要做的是为游戏加入一种查看玩家角色背包里物品的方式。

物品被捡起以后,就不再需要用 Point 组件来描述它在地图上的位置了,随后会被从实体渲染系统中移除——因为渲染查询会寻找同时具备 Point 和 Render 这两个组件的实体。玩家需要知道游戏角色此刻携带着什么物品,这可以用平视显示区实现。

打开 systems/hud.rs ,随后扩展这个系统的定义,使之包含 Item 、 Carried 和 Name 组件:

#[system] #[read_component(Health)] #[read_component(Player)] ➤ #[read_component(Item)] ➤ #[read_component(Carried)] ➤ #[read_component(Name)] pub fn hud(ecs: &SubWorld) {

现在该系统可以读取到 Carried 和 Name 组件类型了,接下来对其进行扩展,以实现显示物品的功能。此时,开发者希望在平视显示区主界面的下方列出玩家角色所携带的物品,同时让每个物品的旁边显示一个数字——与激活该物品的按键相对应。将下列代码插入调用 batch.submit 之前的位置:

let player=<(Entity, &Player)>::query() .iter(ecs) .find_map(|(entity,_player)| Some(*entity)) ❶ .unwrap(); ❷ let mut item_query=<(&Item, &Name, &Carried)>::query(); ❸ let mut y=3; item_query .iter(ecs) ❹ .filter(|(_,_, carried)| carried.0==player) .for_each(|(_, name,_)| { ❺ draw_batch.print( Point::new(3, y), format!("{} : {}", y-2, &name.0) ); y+=1; } ); ❻ if y > 3 { draw_batch.print_color(Point::new(3, 2), "Items carried", ColorPair::new(YELLOW, BLACK) ); }

❶ 用和之前一样的代码来获取玩家角色的实体。

❷ 创建一个查询,以寻找玩家角色携带着的物品,并检索它们的 Item 标签、 Name 组件和 Carried 组件。

❸ 创建一个名为 y 的变量,并将它的值设置为3。这将作为渲染物品列表的开始位置。

❹ 过滤被携带的物品,使其只包含被玩家角色携带的物品。这个过滤可以保证如果某一天开发者决定让怪兽也可以携带物品,被怪兽携带的物品不会出现在玩家的平视显示区上。

❺ 在 (3,y) 这个位置上显示物品的名字,然后递增y。

❻ 如果物品列表被渲染在屏幕上,那么添加一个标题,以解释为什么会有一些物品的名字出现在屏幕上。

现在运行游戏,玩家角色会找到一个药瓶或者卷轴,按G键捡起,然后这个物品就会出现在平视显示区中。如果玩家角色又找到另一个物品并将其捡起来,那么新的物品也会显示在玩家角色的背包列表中,如图13-2所示。

图13-2

玩家的平视显示区显示收集到的物品,并且旁边有一个数字——用来提示激活对应物品的按键。接下来你需要编写让物品在被使用时产生相应效果的代码。

在7.3节中,你引入了一种设计模式,在该模式中,系统发出执行某个动作的意图,真正的动作是在其他各自独立的系统中执行的。使用一个物品的逻辑和这种模式没有什么不同,用这种方式将意图和行为解耦可以使代码保持灵活性。如果你打算让一个强壮的怪兽也使用魔法物品,那么只需发送表示意图的消息即可,不用重复编写代码。

打开 components.rs ,然后添加一个名为 ActivateItem 的组件:

#[derive(Clone, Copy, Debug, PartialEq)] pub struct ActivateItem { pub used_by : Entity, pub item : Entity }

要想发送一个 ActivateItem 消息,玩家需要在键盘上按下与平视显示区中物品旁边的数字相同的按键。打开 player_input.rs ,然后在文件的末尾添加一个新的函数:

fn use_item(n: usize, ecs: &mut SubWorld, commands: &mut CommandBuffer) ❶ -> Point { let player_entity=<(Entity, &Player)>::query() .iter(ecs) .find_map(|(entity,_player)| Some(*entity)) ❷ .unwrap(); ❸ let item_entity=<(Entity, &Item, &Carried)>::query() .iter(ecs) .filter(|(_,_, carried)| carried.0==player_entity) ❹ .enumerate() ❺ .filter(|(item_count, (_,_,_))| *item_count==n) ❻ .find_map(|(_, (item_entity,_,_))| Some(*item_entity)); ❼ if let Some(item_entity)=item_entity { commands ❽ .push(((), ActivateItem{ used_by: player_entity, item: item_entity })); } Point::zero() }

❶ use_item() 函数需要从父系统中访问 SubWorld 和 CommandBuffer 。有了这些变量,开发者可以在系统中传递变量并在函数中使用它们。

❷ 使用查询来获取Player实体,这和之前做的一模一样。

❸ 使用和平视显示区用来查找物品类似的查询,迭代被携带的物品,并筛掉不是玩家角色持有的物品。

❹ enumerate() 为每个结果添加一个从0开始递增的数字。这里有一些令人困惑,因为开发者得到了由两个元组形成的嵌套元组。外层元组的形式是( counter,other_tuple ),前一个迭代步骤产生的元组被包含到了这一步所产生的元组里面,最终的结构是( counter, (Entity, Item, Carried) 。嵌套的括号将这个嵌套的元组解构到具有易用名称的变量中。

❺ 过滤掉枚举计数值不等于传入的参数 n 的物品。例如,如果玩家按下了数字键3,那就需要寻找一个枚举计数值等于2的物品。记住,枚举计数是从0开始的。列表中可能没有任何物品。

❻ find_map() 返回一个 Option 类型。如果迭代器中有任一留下来的物品,那么其中的第一个将被以 Some(entity) 的形式返回。如果没有物品能够和按键匹配,那么 find_map() 会返回None。

❼ 如果有匹配的物品, if let 语句会从 item_entity 这个 Option 类型中抽取出内容,并运行对应语句块中的代码。如果没有匹配的物品, if let 语句就不会做任何事情。

❽ 使用命令缓冲区来创建一个 ActivateItem 条目,就像之前为 WantsToMove 编写的逻辑一样。

随后在 player_input 系统中,再次找到 match 语句。为玩家键盘上的每个数字按键添加对应的匹配分支,并在每个分支中调用刚才编写的函数:

VirtualKeyCode::Key1 => use_item(0, ecs, commands), VirtualKeyCode::Key2 => use_item(1, ecs, commands), VirtualKeyCode::Key3 => use_item(2, ecs, commands), VirtualKeyCode::Key4 => use_item(3, ecs, commands), VirtualKeyCode::Key5 => use_item(4, ecs, commands), VirtualKeyCode::Key6 => use_item(5, ecs, commands), VirtualKeyCode::Key7 => use_item(6, ecs, commands), VirtualKeyCode::Key8 => use_item(7, ecs, commands), VirtualKeyCode::Key9 => use_item(8, ecs, commands),

现在,当玩家按下数字键时,系统会查找与按键关联的物品。如果能找到,系统会发送一个 ActivateItem 消息。接下来要做的是编写一个使用这些消息的系统。

在大型游戏中,开发者可能希望为每种特效开发各自独立的系统(还要有一个系统在所有可能的特效执行完毕后删除激活这些特效的请求)。但对于当前的游戏来说,使用一个简单的单系统方案就够了。

创建一个新的文件 systems/use_item.rs ,添加 mod use_item 到 systems/mod.rs 中,将该系统包含到程序的编译构建过程中。

你可以先添加创建系统所需的样板代码,然后授予对地图和相关组件的访问权限。这个系统需要对 ActivateItem 、 ProvidesHealing 和 ProvidesDungeonMap 的读权限,还需要对 Health 的写权限以实现治疗功能。将下列代码添加到 systems/use_item.rs 中:

use crate::prelude::*;   #[system] #[read_component(ActivateItem)] #[read_component(ProvidesHealing)] #[write_component(Health)] #[read_component(ProvidesDungeonMap)] pub fn use_items( ecs: &mut SubWorld, commands: &mut CommandBuffer, #[resource] map: &mut Map ) {

现在,这个系统的样板代码应该看起来很眼熟了。这里没有涉及新的概念,让我们继续开发这个系统的其他功能。

创建一个向量,以存储一系列要应用的治疗特效:

let mut healing_to_apply=Vec::<(Entity, i32)>::new();

系统在迭代物品的特效时,会把治疗事件放到这个列表中,将其作为一个待办事项列表。直接在原地立即应用特效可能是一种逻辑更清晰的写法,但会使Rust的 借用检查器 (borrow checker)触发编译错误。

Rust对借用有一些硬性规定。

(1)可以对一个变量进行任意多次的不可变借用。

(2)同一时刻只能对一个变量进行一次可变借用。

(3)不能同时以可变和不可变的形式借用一个变量。

如果在原地应用治疗特效,就会导致借用检查器报错。

(1)开发者需要借用 SubWorld 来执行查询。

(2)为了访问物品的实体和组件,开发者需要从 SubWorld 中借用它们。

(3)需要再次借用,以找到药水的 healing 属性。

(4)开发者尝试可变借用玩家角色的 Health 组件,然而此时仍在以不可变的形式借用 SubWorld 。Rust会拒绝编译代码,以防这个可变借用引入的数据修改导致 SubWorld 中的数据遭到破坏。

为了绕过借用检查器的限制,开发者需要保证在下一次借用 SubWorld 之前,上一次借用已经使用完毕。为了满足这个要求,最简单的方法是先提取出需要的东西,然后再进行治疗操作。

借用检查器是Rust最大的优点之一,但有时也是最令人恼火的特性。特别是对于写过C++的开发者来说,他们有时想知道为什么需要调整代码的顺序以满足借用检查器的要求。

借用检查器是对开发者有益的。微软的报告指出,其软件中70%的安全漏洞来自内存安全问题。借用检查器以及Rust的其他安全特性可以帮助开发者避免大量此类型的漏洞。

将借用检查器想象为一名行事严谨的图书管理员,他对内存数据的借用情况了如指掌,并严格要求借用后要归还。这样的做法有时令人恼火,但可以保证整个图书馆 的正常运转。

现在你有地方存储治疗事件了,下一步要做的是解析并执行物品激活后的特效。

每一个 ActivateItem 事件都包含被使用物品的实体对象和使用这个物品的实体对象。这样的设计有助于检索事件组件里面的实体列表,并检查这个事件包含哪些效果组件( ProvidesHeaaling 和 ProvidesDungeonMap )。向正在编写的函数中继续添加如下代码:

<(Entity, &ActivateItem)>::query().iter(ecs) ❶ .for_each(|(entity, activate)| {   ❷ let item=ecs.entry_ref(activate.item); ❸ if let Ok(item)=item { ❹ if let Ok(healing)=item.get_component::<ProvidesHealing>() { ❺ healing_to_apply.push((activate.used_by, healing.amount)); } ❻ if let Ok(_mapper)=item.get_component::<ProvidesDungeonMap>() { ❼ map.revealed_tiles.iter_mut().for_each(|t| *t=true); } } ❽ commands.remove(activate.item); ❾ commands.remove(*entity); });

❶ 创建一个查询,返回 ActivateItem 组件以及它们关联的实体。

❷ entry_ref() 是Legion中用来在查询之外访问实体的一种手段,会返回指向单一实体的引用。通过这个实体,你可以在不使用查询的情况下,独立地访问这个实体所包含的组件。

❸ 你想要访问的实体有可能并不存在。对此, entry_ref() 会通过返回一个 Result 类型来解决这个问题。如果实体存在,那么 if let Ok(item) 的写法将会从 Result 中抽取出物品对应的实体。如果实体不存在,则 if let 语句不会运行其内部的任何代码。

❹ 实体的引用类型用一个 get_component() 函数来访问关联到这个实体的组件。实体可能并不包含指定的组件类型,这种情况下,该函数返回的 Result 类型就不会包含有效结果。只有该物品对应的实体包含所请求的组件时,才使用 if let 语句获取结果并运行语句块中的代码。

❺ 将本次疗伤的必要信息加入刚才创建的 healing_to_apply 向量中。

❻ 再次使用同样的 get_component() 调用来检查实体是否包含 ProvidesDungeonMap 组件。

❼ 如果物品实体具有 ProvidesDungeonMap 组件,则将当前关卡的 revealed_tiles 变量中的每一个元素都设置为 true ,让地图的布局展现出来。

❽ 删除用过的物品,使其不能再被使用。

❾ 删除激活特效的命令,使其不再触发特效。

现在, use_item() 函数可以迭代所有的激活事件,并且在地下城地图被使用时展现整幅地图的轮廓。这个系统还会完成对自身的清理工作。最后一个任务是处理待办列表中的疗伤事件。

你已经把一系列治疗目标和生命值的恢复数量存储在 healing_to_apply 里面了。接下来,迭代这个向量并应用其中的所有治疗请求:

for heal in healing_to_apply.iter() { ❶ if let Ok(mut target)=ecs.entry_mut(heal.0) { ❷ if let Ok(health)=target.get_component_mut::<Health>() { health.current=i32::min( health.max, health.current+heal.1 ❸ ); } } } }

❶ 使用 entry_mut() 来获取指向一个实体的可变引用。和以前一样,使用 if let 语句可以保证仅当返回实体有效时才会执行对应的代码。

❷ 确保特效的作用目标具备 Health 组件。 get_component_mut() 和 get_component() 很类似,只不过它返回指向组件的可变引用,让开发者在借用时可以修改组件的内容。

❸ 治疗回血后的生命值不能超过允许的最大生命值。将当前的生命值设置为最大生命值和当前生命值加上回血值后二者之中较小的那一个。

现在, use_item() 系统已经开发完了。下面要做的是将这个系统添加到调度器中,保证它能够运行。

打开 systems/mod.rs ,这个文件包含了游戏回合中每一部分的调度器的定义。你需要把 use_item 添加到玩家角色的调度器中:

pub fn build_player_scheduler()-> Schedule { Schedule::builder() ➤ .add_system(use_items::use_items_system()) .add_system(combat::combat_system()) .flush()

你或许想让怪兽也能使用物品,那么需要把 use_item 系统也添加到怪兽的调度器中:

pub fn build_monster_scheduler() -> Schedule { Schedule::builder() .add_system(random_move::random_move_system()) .add_system(chasing::chasing_system()) .flush() ➤ .add_system(use_items::use_items_system()) .add_system(combat::combat_system()) .flush()

现在运行程序,你就可以找到药水和卷轴了。喝下药水可以恢复生命值,浏览地图可以看到所有关卡。地下城地图的效果如图13-3所示。

图13-3

现在玩家角色有了用来疗伤的物品,就没必要再通过用休息来恢复生命值的方式降低游戏难度了。玩家仍然可以选择跳过一个回合,在原地等待怪兽到达玩家预设的战场,但管理生命值现在变成了一个战略决策。“我能得到所需要的药水吗?”这样的紧迫感会为游戏增添更多的戏剧性。

打开 systems/player_input.rs ,找到下面这一段代码,并将其从源代码文件中删除:

if !did_something { if let Ok(mut health)=ecs .entry_mut(player_entity) .unwrap() .get_component_mut::<Health>() { health.current=i32::min(health.max, health.current+1); } }

你在8.4节中编写过这段代码。在此之前,如果玩家角色不做出动作,则游戏会把恢复一些生命值作为玩家角色原地等待的奖励。现在,玩家可以用药水来疗伤,如果还用原地等待的方式来恢复生命值,游戏就有些无趣了。 EXr6287u6NNVz+GYLY+7SJneqzhu/PpYtW3JvBxL0w3TWONw8KRKos0qTZTOcW8905C1mNfvCHdpZEogE6oe6g==

本章共 5 页 (每页约 2000 字) 分页阅读 →
上一章
目录
下一章
纠错
加书签
详情
加书架
打赏
投票
自动滚动
设置
夜间

评论 0条

加载中...

设置

阅读主题
正文字体
字体大小
18
页面宽度
滚动速度
5
语音朗读
翻页模式
💎

余额不足

您的水晶或能量余额不足,请充值后再试。

立即前往充值

🎫 投月票

1 张月票 = 1.00 水晶。感谢支持!

🎁 打赏作品

打赏将直接扣除水晶余额,鼓励作者创作。