Ink Testing Tool

Ian Thomas
1 min readJul 25, 2024

--

Another spare time project! This one to make it easier to test Ink stories.

TL;DR

I’ve written a command-line utility that:

  • Runs your Ink story hundreds or thousands of times (as many as you like), randomly taking choices.
  • Builds stats on how often each line of text was visited.
  • Creates a CSV report of those stats.

This lets you:

  • See if some text is never visited, in which case you almost certainly have a logic error on the path to it.
  • Judge how balanced portions of your story are — will less than 1% of your players access a particular line of text? In which case, maybe you need to tweak some values.

You can find it here with downloads for OSX and Windows.

Updated: Adds support for an out-of-content check mode, which specifically hunts out out-of-content errors and outputs a report on them.

There’s not much else to say! If you are interested in another useful utility, you could check out the simple Ink Localiser tool I wrote — it’s over here.

Thanks as usual to the Inkle team for Ink itself, which I use every day — and thanks to Dan Fabulich at Choice of Games for the idea behind this tool.

--

--

Ian Thomas
Ian Thomas

Written by Ian Thomas

Ian is narrative director, coder, and writer of video games, films, larp, books, live events, and VR/AR experiences. Find him on Bluesky or LinkedIn.

No responses yet