<- [[script|Adding New Behaviors]] --------- [[twine_reference|Reference Home]]->

===== Custom Macros =====

It's possible to write your own macros for use in your stories. Doing so will require knowledge of both JavaScript and the Twine engine.

Here's an example passage that creates a macro named ''<<hello>>'' that, when invoked in another passage, displays an alert that greets the reader.

<code>
:: Hello macro [script]
macros['hello'] =
{
	handler: function()
	{
		alert('Hi, reader!');	
	}
}

:: Start
<<hello>>
</code>

If you're curious how a built-in macro works, browsing the [[https://github.com/tweecode/twine|source code repository]] may be helpful, too.

<- [[script|Adding New Behaviors]] --------- [[twine_reference|Reference Home]]->