Struct Quests 

pub struct Quests {
    id_counter: AtomicU64,
    quests: HashMap<QuestId, Quest>,
    related_quests: HashMap<Actor, HashSet<QuestId>>,
}

The easiest way to think about quests is as a virtual Jira board (or, perhaps, a community jobs noticeboard).

This type represents the board. In effect, it is a big database of active and resolved quests. Quests are not, by themselves, ‘active’ participants in the world. They are informal contracts, and it is up to the NPCs and players that interact with them to drive them forward.

Quests that are resolved or that have been active for some time without activity may be garbage-collected, although the exact mechanism for this has not yet been defined.

Fields

id_counter: AtomicU64

Because quests can be created in a multi-threaded context, we use an atomic counter to generate IDs for them. Quest insertion happens at the end of each tick. This is guarded by a utility function, so unregistered quests shouldn’t be visible to the rest of the code.

quests: HashMap<QuestId, Quest>

related_quests: HashMap<Actor, HashSet<QuestId>>

Implementations

impl Quests

pub fn register(&self) -> QuestId

Register a new quest ID. It can be defined later with Quests::create.

Critically, this function works in a shared + concurrent context, which allows us to run it in parallel within the NPC AI code.

pub fn create(&mut self, id: QuestId, quest: Quest)

Create a quest with the given ID.

This ID should be generated by Quests::register and used only once to create a quest.

pub fn get(&self, id: QuestId) -> Option<&Quest>

pub fn related_to( &self, actor: impl Into<Actor>, ) -> impl Iterator<Item = QuestId> + '_

pub fn related_actors( &self, actor: impl Into<Actor>, ) -> impl ExactSizeIterator<Item = Actor> + '_

Find all of the actors that are related to another actor via a quest

pub(super) fn prepare(&mut self)

Trait Implementations

impl Clone for Quests

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for Quests

fn default() -> Quests

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Quests

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Quests

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.