bevy_talks 0.5.0

A Bevy plugin to write dialogues for your characters to say and do things, together with player choices.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

//! Commands for talks

use bevy::ecs::system::{Commands, EntityCommands};

use crate::prelude::Talk;

use super::{build_command::BuildTalkCommand, TalkBuilder};

/// Extension trait for [`Commands`] to spawn a talk.
pub trait TalkCommandsExt<'w, 's> {
    /// Spawns a dialogue graph and a parent entity with a [`Talk`] component + the input bundle.
    /// Returns a handle of the parent entity.
    ///
    /// # Example
    /// ```rust
    /// use bevy_talks::prelude::*;
    /// use bevy::prelude::*;
    ///
    /// fn setup(mut commands: Commands) {
    ///     let talk_builder = TalkBuilder::default().say("Hello world!");
    ///     commands.spawn_talk(talk_builder);
    /// }
    fn spawn_talk(&mut self, builder: TalkBuilder) -> EntityCommands<'w, 's, '_>;
}

impl<'w, 's> TalkCommandsExt<'w, 's> for Commands<'w, 's> {
    fn spawn_talk(&mut self, builder: TalkBuilder) -> EntityCommands<'w, 's, '_> {
        let parent = self.spawn(Talk::default()).id();
        self.add(BuildTalkCommand::new(parent, builder));
        self.entity(parent)
    }
}