Invoking actions programatically

Orzecho

Hi, I'm using v2.
How can I invoke actions from javascript? I would like to write functions that can combine several things, for example, show the line of text, play the voice and save something to storage. How can this be done?

remeranAuthor

In v2 the monogatari.run("") function will invoke monogatari actions. You can see an example of this in action in this demo game I've made for you.

https://newrem.com/monogatari/helpExamples/monogatariDotRun/index.html
The script.js file : https://newrem.com/monogatari/helpExamples/monogatariDotRun/js/script.js

monogatari.script ({
	// The game starts here.
	'Start': [
	`y In Monogatari, you can invoke actions using the monogatari.run() method.`,
	{'Function':{
		'Apply': function () {
			monogatari.run("y Take a look at the script.js file for this game to see an example!");
		return false;
		},
		'Reverse': function () {
			monogatari.run("y Take a look at the script.js file for this game to see an example!");
			return false;
		}
	}},
	`y Remember to return false in any function that runs a line of dialog! Failing to do this will make the function just immediately jump ahead to the next line and it will feel like it skipped it.`,
	`y I hope you make a great game with that tip!`,
	]
});

For this example we used a reversible function so that if the player clicks the "back" key, they can go back. If we just used a basic anonymous function(){} it would always go forward on that line.

This is, of course, quite flexible. You can make some elaborate functions to do things. You can also make infinite loops where you jump back to the start of a label that just contains the function and the jump, and then have that function be really complex and do all sorts of things with an ultimate condition that escapes the label, such as if you wanted to make a battle minigame that uses the basic monogatari text box, or something cool like that. Get creative!

Hope that helped!

Orzecho

Thank you so much for the extensive answer, it's very helpful! 🙂

Orzecho

Two things I learned using your advice, maybe someone will find it useful:
First one: run() method is asynchronous and returns a promise. So, if you want to run some actions sequentially you will need to use Promise API to achieve that.
Second one: If you use more then one run invocation you will need to add "false" as a second parameter to prevent it from advancing script. Without it, it will move along to the next position while your function will be still running the rest of the statements, or so I am guessing.

Fragment of the code I wrote:

function reversibleTwoWay (func) {
	return {'Function':{
		'Apply': function () {
			return func();
		},
		'Reverse': function () {
			return func();
		}
	}};
}

function say (character, index, text) {
	return reversibleTwoWay(function () {
		monogatari.run('stop voice', false).then(function () {
			return monogatari.run(playVoice(characters[character] ? characters[character] : character, index), false);
		});
		monogatari.run(`${character} ${text}`, false);
		return false;
	});
}