Yarn parser for Javascript, in the same vein as YarnSpinner.
This is the stable version of bondagejs, which unfortunately is not fully compliant with the yarn 2 format.
There is however a newer version which is! You can ge it from this branch: Bondagejs - next - with full Yarn 2.0 compliance -- https://github.com/hylyh/bondage.js/tree/2.0
To run through your yarn files in your browser, go to http://hayley.zone/bondage.js, paste your yarn data in the field, then hit "compile".
Installation: npm install -g bondage
Now you can use the bondage
command to run through Yarn files from the command line. You can load one or multiple files at a time. If you load multiple files and a two nodes are encountered with the same name, the node will be overwritten.
Examples
- Running a single file from the default start node (named "Start"):
bondage run yarnfile.json
- Running a single file from the specified node name:
bondage run -s StartNode yarnfile.json
- Running multiple files from the specified node name:
bondage run -s StartNode yarnfile1.json yarnfile2.json ...
- See the compiled ast:
bondage compile --ast yarnfile.json
- See the tokenized input:
bondage compile --tokens yarnfile.json
Web
Include dist/bondage.min.js somewhere in your html, and the bondage
variable will be added to the global scope. You can then access everything in the example below (such as bondage.Runner
) through that variable.
Node
Installation: npm install bondage
const fs = require('fs');
const bondage = require('bondage');
const runner = new bondage.Runner();
const yarnData = JSON.parse(fs.readFileSync('yarnFile.json'));
runner.load(yarnData);
// Loop over the dialogue from the node titled 'Start'
for (const result of runner.run('Start')) {
// Do something else with the result
if (result instanceof bondage.TextResult) {
console.log(result.text);
} else if (result instanceof bondage.OptionsResult) {
// This works for both links between nodes and shortcut options
console.log(result.options);
// Select based on the option's index in the array (if you don't select an option, the dialog will continue past them)
result.select(1);
} else if (result instanceof bondage.CommandResult) {
// If the text was inside <<here>>, it will get returned as a CommandResult string, which you can use in any way you want
console.log(result.text);
}
}
// Advance the dialogue manually from the node titled 'Start'
const d = runner.run('Start')
let result = d.next().value;
let nextResult = d.next().value;
// And so on
For usage of the yarn format itself, please see the YarnSpinner Documentation, everything there should carry here too (if something does not match up, please open an issue).