Skip to content

Project Architecture

Main File

NarrativeCraft has a structured way to manage a story with Ink.

Every scene that a chapter contains has its own unique .ink file. The overall flow of the story is controlled by a central file called main.ink.

main.ink is located at:

/saves/<your_world>/narrativecraft/main.ink

When opening main.ink with Inky, all scene files will be included automatically. This allows you to:

  • Define global variables in main.ink
  • Access those variables in any scene file
  • Have a centralized view of your full narrative structure

There is no need to include scene files manually. Every time you add a new scene in-game, NarrativeCraft updates main.ink for you by inserting the correct INCLUDE directives.

Important

Knot names must not be changed manually. Doing so will break the story flow.
If you want to rename a scene, always do it in-game only.

Building the story

To build and export your Ink story for use in NarrativeCraft:

  1. In Inky, go to the Files menu.
  2. Click Export to JSON.
  3. Navigate to the folder:
    narrativecraft/build
  4. Name the exported file:
    story.json

This will generate the compiled Ink story that NarrativeCraft reads at runtime.