Yarn 🐱 🧺

Dialogue editor created for "Night in the Woods" (and other projects) by @NoelFB, @blurymind and @infinite_ammo with contributions from @seiyria and @beeglebug. It is heavily inspired by and based on the amazing Twine software: http://twinery.org/

🧶 Live Web APP (Use it in the browser)

https://yarnspinnertool.github.io/YarnEditor/

📲 Install the Web App on your mobile device

1. Visit https://yarnspinnertool.github.io/YarnEditor/
   with your smartphone or tablet
2. Open the web browser's menu and select "Add to home screen"
3. When you run Yarn from the home screen, it will work in full screen mode, even when you are offline!

💻 Install it on your desktop

Grab Win64, Linux and MacOS electron builds at https://github.com/YarnSpinnerTool/YarnEditor/releases/latest

🚧 Roadmap

You can see planned features, vote for features or see how you can contribute at the roadmap here: https://trello.com/b/ZXhhOzDl/yarn-roadmap

🎮 Game engines that bundle Yarn editor

There are a few game engines that have YarnEditor bundled with their IDE. That means that you can use it straight in those engines, without need to save files and open files and so on. It's directly integratedin their workflow!

• Gdevelop : A full-featured, open-source game development software, allowing to create HTML5 and native games without any knowledge in a specific programming language. All the game logic is built up using an intuitive and powerful event-based system. https://github.com/4ian/GDevelop

🧠 Yarn runtimes

The runtime is a library that allows your game engine to parse the files that yarn creates. There are a couple of popular ones that you can use. If you have created a runtime, you are working on one or want to get one included with your game engine, these can be of some use to you

• YarnSpinner : A C# library for interactive dialogue in games! Ideal if you are using Unity3d or another C# game engine! https://github.com/YarnSpinnerTool/YarnSpinner

• Bondagejs : A Javascript-based parser for the Yarn dialogue tree markup language. Ideal if your game engine uses html5 technologies to run (Gdevelop and ctjs use it). https://github.com/hylyh/bondage.js

🐬 Features 🦄

BBcode and HTML-ish markup styling in editor, Spellchecking, Autocompletion, and more!

• Optional syntax autocompletion (autoclose tags)
• preview of bbcode/html tag effects and goto in trimmed nodes
• optional word guessing and autocompletion
• optional preview bbcode in editor mode
• a color picker (using spectrum.js) to set font color in bbcode
• emoji picker to insert emojis
• nodelink suggestions as you type in the right places
• Night mode - Toggling it will invert all the light colors which the editor currently uses
• A context menu command to visit other nodes via their links in the editor and even create new ones
• Button to go back to the previous edited node. If there is no previous - save and close the current one

Language, writing and debugging tools built right into it

• Ability to playtest yarn stories you are working on - straight inside yarn
• Spellchecking of words (supported for different languages too)
• misspelled word suggestions in the new context menu - if you have selected a misspelled word
• Similar word suggestion for highlighted words (supported for english only)
• Transcribe text - ability to "talk" to yarn without using hands :o (multi-language supported)
• Yarn can also talk to you - tell you what is written (multi-language supported)

Load and Save your yarns from your computer, github gists or anything you can send it to on your tablet/phone

• A variety of export formats supported - yarn, json yarn, twee, twee2, xml
• When used from a mobile device, yarn can send its data to any other app, including to google drive
• Ability to store and load all your yarns using a github gist - private or public, doesn't matter ;)

Customization!

• Support for different themes (you can make your own too)

Electron Builds

Win64, Linux and MacOS builds available at: https://github.com/YarnSpinnerTool/YarnEditor/releases/latest

⚙️ Compile and run web app on localhost:

Make sure you have nodejs installed. Then from the root folder

npm install

npm start

You can access it on your smartphone too if it is on the same wifi network

To build web app:

npm run build

you will find it in the /dist folder

To compile and run electron app:

First of all you need to have compiled the web app (see previous steps)

cd electron

npm install

npm start

To build an electron yarn executable yourself:

cd electron

npm run build-windows

or

npm run build-linux

😮 Examples

Games built using Yarn.

A short hike: https://store.steampowered.com/app/1055540/A_Short_Hike/

Night in the woods: https://store.steampowered.com/app/481510/Night_in_the_Woods/

Lost Constellation: http://finji.itch.io/lost-constellation

Knights and Bikes: https://store.steampowered.com/app/592480/Knights_And_Bikes/

Far From Noise by George Batchelor (@georgebatch): https://store.steampowered.com/app/706130/Far_from_Noise/

YarnTest: http://hayley.zone/bondage.js/

Test drive your Yarn files here ^

How to Connect Nodes

Node connections work similar to Twine. [[ask question|question]] leads to "question" node.

How to Import Twine Files

One way to import Twine files into Yarn is to export a "Twee" file from Twine. (txt format) Open this txt file in Yarn as you would any other file.

Note: This method of importing will not preserve node locations, just each node's title, body and tags.

How to Run Your Dialogue in Unity

You can find basic Yarn parsing and playback example code here:

https://github.com/InfiniteAmmoInc/yarn-test

You can find a more advanced Yarn interpreter here:

https://github.com/YarnSpinnerTool/YarnSpinner

Yarn Icon

Yarn logo/icon created by @Mr_Alistair.