#dialog #yarn #spinner #bevy #run-time #vm #friendly

yarnspinner_runtime

Runtime / VM for Yarn Spinner for Rust, the friendly tool for writing game dialogue

3 unstable releases

0.2.0 Feb 18, 2024
0.1.1 Feb 6, 2024
0.1.0 Jan 30, 2024

#727 in Game dev

Download history 34/week @ 2024-01-28 42/week @ 2024-02-04 31/week @ 2024-02-11 211/week @ 2024-02-18 231/week @ 2024-02-25 241/week @ 2024-03-03 99/week @ 2024-03-10 144/week @ 2024-03-17 300/week @ 2024-03-24

822 downloads per month
Used in 5 crates (via yarnspinner)

MIT/Apache

250KB
4.5K SLoC

Yarn Spinner for Rust

Crates.io Docs Discord

Note: Yarn Spinner for Rust is a work-in-progress project. We don't currently offer any official support for it. We encourage you to file issues if you have them, and to join the official Yarn Spinner Discord to discuss the project!

The Rust port of Yarn Spinner, the friendly tool for writing game dialogue. Read more on docs.yarnspinner.dev or check out the live demo, which was written using the Bevy engine. This project offers first class support for Bevy and assumes you are using it. If you are not, check out the relevant section of the book

Yarn Spinner for Rust Demo

Quickstart

Taken straight from our examples:

First, let's add our dependencies:

cargo add bevy bevy_yarnspinner bevy_yarnspinner_example_dialogue_view

Now, the main.rs:

use bevy::prelude::*;
use bevy_yarnspinner::prelude::*;
use bevy_yarnspinner_example_dialogue_view::prelude::*;

fn main() {
    let mut app = App::new();
    app.add_plugins((
        DefaultPlugins,
        // Register the Yarn Spinner plugin using its default settings, which will look for Yarn files in the "dialogue" folder.
        // If this app should support Wasm or Android, we cannot load files without specifying them, so use the following instead.
        // YarnSpinnerPlugin::with_yarn_source(YarnFileSource::file("dialogue/hello_world.yarn")),
        YarnSpinnerPlugin::new(),
        // Initialize the bundled example UI
        ExampleYarnSpinnerDialogueViewPlugin::new(),
    ))
    .add_systems(Startup, setup_camera)
    .add_systems(
        Update,
        // Spawn the dialogue runner once the Yarn project has finished compiling
        spawn_dialogue_runner.run_if(resource_added::<YarnProject>()),
    )
    .run();
}

fn setup_camera(mut commands: Commands) {
    commands.spawn(Camera2dBundle::default());
}

fn spawn_dialogue_runner(mut commands: Commands, project: Res<YarnProject>) {
    // Create a dialogue runner from the project.
    let mut dialogue_runner = project.create_dialogue_runner();
    // Immediately start showing the dialogue to the player
    dialogue_runner.start_node("HelloWorld");
    commands.spawn(dialogue_runner);
}

And finally, the assets/dialogue/hello_world.yarn:

title: HelloWorld
---
Hello World! To continue the dialogue, click with your mouse, press the space bar or the enter key.
These are options. You can select one by clicking on it or pressing the corresponding number on your keyboard.
-> Some cool option
-> Some other cool option
Now we'll jump to another node!
<<jump AnotherNode>>

===

title: AnotherNode
---
Now, a character will talk. Notice how the upper left corner of the dialogue will show their name.
Hohenheim: Hi, I'm Jan Hohenheim, creator of Yarn Spinner for Rust. I hope you enjoy using it!
Let's set a condition. Do you prefer dogs or cats?
-> Dogs
    <<set $animal = "dog">>
-> Cats
    <<set $animal = "cats">>
-> Turtles
    I, uuuh... okay, why not.
    <<set $animal = "turtles">>
Now let's print the result of the condition. Your preference is...
(Drum roll)
<<if $animal == "dog">>
Dogs! Arf Arf!
<<elseif $animal == "cats">>
Cats! (Can't say I agree, but you do you)
<<else>>
Turtles! Solid choice.
<<endif>>
Et voilà! That was all. Thanks for checking out Yarn Spinner for Rust! Continuing from the last node will exit the dialogue.
===

Version Table

Bevy Yarn Spinner for Rust
0.13 0.2
0.12 0.1

lib.rs:

The runtime components of Yarn Spinner. These mostly follow the same structure as the original Yarn Spinner runtime.

You probably don't want to use this crate directly.

  • If you're a game developer, you'll want to use a crate that is already designed for your game engine of choice, such as bevy_yarnspinner for the Bevy engine.
  • If you wish to write an adapter crate for an engine yourself, use the yarnspinner crate. Everything you need to get starting using the Yarn Spinner runtime.

Dependencies

~6–53MB
~826K SLoC