Supports A-Frame 0.9.2.
This component wraps the InkJS library, for running Ink JSON files in the browser, in a few lines of code.
It goes very well with the aframe-state-component to synchronise the state of the InkJS runtime and the state in the A-Frame application, because there should be only one single source of truth in your application. That means when you keep variables in Ink they are automatically propagated to the registered application's state and vice versa. The mapping of the state variables is done by their exact name. So be careful to name variables accordingly in the Ink script and in your initialState object!
The component must be attached to the
|src||Asset link to the story JSON file produced by the Inky editor.||
|choice||The Ink choice object to continue the storyline. Must be updated on each continuation of the story. Otherwise use the
|sync||Whether to sync state variables to Ink's own state machine using the stateupdate event.||
||Fired when the Ink story has been loaded. The InkJS instance to programmatically work with the story is passed as the event data.|
||Fired when the Ink story has continued. The event data contains the current text and tags list (may be empty) and the available choices object list (may be empty). The selected choice object must be either passed to the
||Fired when the Ink story state variable has changed|
|continue||choiceIndex||Continues the story with the optional choice index.|
Install and use by directly including the browser files:
My A-Frame Scene
Install via npm:
npm install aframe-ink-component
Then require and use.