ink Library

This is a collection of ink resources, samples, tools as well as a running list of projects that use ink. It's an attempt to catalogue everythink in one place.

We're open to pull requests, so feel free to submit any sample ink, tools that you've found useful, or a link to your own project or game.

ink Patreon

Inkle has a patreon page full of tips and tricks, please consider donating if you make use of ink!

ink samples

• Snippets - re-useable functions, examples of techniques, etc.
• Stories - entire playable stories written in ink.

If you want to submit a sample, please make sure to put a header comment at the top of your (main) file that gives an overview of your snippet, or an overview of your story.

Please be aware that any sample content contributed to this repo becomes MIT licensed.

ink Tools

ink Engine ports, wrappers and integration

The repositories marked with ⭐️ are compatible with the latest version of Ink. Warning: the others may be incomplete or works in progress.

• Ink-Unity-integration ⭐️ - Official integration for Unity from inkle.
• inkjs ⭐️ – A JavaScript port of ink (runtime and compiler).
• godot-ink ⭐️ - Official implementation integrated in Godot through mono.
• inkgd ⭐️ – A GDScript port of ink for Godot.
• blade-ink ⭐️ – Inkle Ink runtime implementation in Java.
• UnrealInk ⭐️ - Integration of the Ink language into Unreal 4.
• GMInk ⭐️ – Ink integration for Gamemaker Studio.
• inkcpp - Ink runtime in C++ with an additional JSON to binary converter. At time of writing, many but not all features supported.
• mica-ink – A Kotlin implementation of inkle's open source scripting language (ink) for writing interactive narrative.
• inkhaxe – Ink port from C# to Haxe.
• inkrs – A port/rewrite of inkle/ink in rust.
• pink – An attempt to implement a subset of ink in lpeg.
• ink-iOS – An iOS wrapper for the JavaScript port (see above) of Inkle's Ink scripting language.
• Narrator - An Ink parser and runtime implementation in Lua. Also works with Defold.
• Inklecate-Wasm - WASM port for in-browser and node.js compilation (last update: early 2020)
• StreamINK - play conversational adventures in your Twitch Streams

Analysis and visualisation

• graphink - A graphing tool for visualising ink by the creator of inkjs

Editors and extensions

General

• Inky - Inky is the offical ink editor developed by inkle.
• Borogove - Tool to write, play and share interactive fiction entirely online, with support for ink.
• Quill – Quill is an online tool for playing and sandbox testing Ink stories.
• Ink Language Server – A language server for inkle's Ink, that adheres to the Language Server Protocol (LSP).
• Yarn Editor - A Pwa Desktop/Mobile 📱💻 app that can author, play and compile ink files via the inklecate wasm port and inkjs.

Atom extensions

• atom-language-ink – Adds syntax highlighting and snippets to Ink files in Atom.
• language-ink-atom • Atom Package - Atom port of the SublimeText 3 language grammar for inkle's ink language.

Emacs extension

• ink-mode – syntax highlighting, automatic indentation, snippets, play testing inside Emacs.

VS Code extensions

• ink • Visual Studio Marketplace – Inkle's Ink scripting language support for Visual Studio Code
• ink • Visual Studio Marketplace - This one seems less complete than the above.

Frameworks, templates and command line utilities

• ink-soaked - A template for creating hypertext fiction that acts like most Twine story formats.
• inkjs template to work with webpack and autorebuild-on-edit
  • Another version without compatibility with Mac and Windows (without inklecate-wasm)
• ink-vn-engine - An engine for building browser-based visual novels with ink.
• Mutter – A framework for building bot brains.
• Paper Engine – Paper Engine is designed to allow game writers to create (nearly) their entire (more than Text) game without ever leaving Ink.
• Atrament – A simple interface to Inkjs, which can be used as a core engine for your game app.
• Blotter – A front-end engine for publishing Ink stories on the web.
• Gall – A a simple command-line tool for assembling Ink stories with Blotter.
• PalimpsestNW – A basic template for deploying a game written in ink as a stand-alone desktop app.
• inkphone – A sample app demonstrating how to turn a web-based Ink project into a mobile app with PhoneGap.
• StoryBytes Android / StoryBytes Desktop – Story viewer built on top of blade-ink.
• Ink-Fungus Gateway (source code) – A tool to connect the Ink Unity Integration Plugin with Fungus.
• ink-proof (source code) – Conformance testing for Ink compilers and runtimes.
• ink-tools - Wrapper around command-line ink compiler that has a watch mode for automatic re-compilation.
• binksi - A bitsi-like tool for making small lo-fi graphical adventure games where a character explores a world and interacts with its inhabitants.

Package Management

• homebrew-ink – Homebrew tap for inklecate (macOS only).
• Unofficial NuGet package – A community supported NuGet package of the runtime.

ink games (and non-games!)

By inkle

• A Highland Song
• Overboard!
• Pendragon
• Heaven's Vault
• 80 days
• Sorcery
• Frankenstein
• Down Among the Dead Men
• The Intercept

By the community

• The Wreck
• Sky Caravan
• Sable
• Haven
• Goodbye Volcano High
• Where the Water Tastes Like Wine
• Neocab
• Falcon Age
• Over the Alps
• Closed Hands
• Sea of Thieves - doesn't use the engine but uses a subset of the format
• Southern Monsters
• Shapeshifting Detective
• Bury Me My Love
• Total Darkness
• The Uber Game
• A Place for the Unwilling
• Dust and Salt
• Dust and Salt: The Battle for Murk
• Fabled Lands
• Wayward Strand
• Johnny Bonasera (ep 2+)
• Le Royaume d'Istyald (French)
• Powerless
• Du Lac & Fey: Dance of Death
• Debris
• True Legacy
• Several games from Sand Gardeners
• Heaven Will Be Mine
• Pirates and Traders 2
• Dance of Death: Du Lac & Fey
• Nox Caelo
• Way Down
• Vampire: The Masquerade - Coteries of New York
• Your daily crush
• Linda & Joan
• Signs of the Sojourner
• Dragon Audit
• Stay?
• Railways of Love
• Dull Grey
• Dialogue Box: The Road Less Traveled
• Cien Años Después (Spanish) - made using binksi

Game jams, competitions, experiments and demos

• Lucerne
• The Rats in the Bulkhead
• Fog Lights and Foul Deeds
• Witchwood Academy
• dripping with the waters of sheol
• ⏰
• ink_roguelike
• Cloak of Darkness (parser IF demo)
• Whole souls
• YEETmas carol
• /THERE USED TO BE A SHOW NAMED CHEERS BUT IT DOESN'T EXIST ANYMORE/
• I live next to a train track
• Outside
• Catfish Fish Cat
• The Tetris Killer
• Scoop (Act One)
• The Bitter Drop
• Lost in Myself

Upcoming games

• Thirsty Suitors
• Goodbye Volcano High
• Nighthawks
• Windrush Tales
• Battlecakes
• The Last Night
• Trip the Ark Fantastic
• Crowns and Pawns: Kingdom of Deceit
• Fête de Famille (Familly Gathering)
• MORSE
• Negative Nancy
• NeuroSlicers
• Hauma

Non Games

• Air New Zealand's chatbot Oscar (source)
• Virginia Interactive Boating Safety Course
• Beacon Virtua
• thul, a Keybase bot
• The Sorting Hat Chats