Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Blade Ink Template

This is a template to create interactive fiction games using the Ink language.


  • Publish your games on Android, iOS and Desktop (Windows, Mac and Linux) with no effort.
  • No coding is necessary.
  • Fully customizable fonts, colors and images.

How to generate your own interactive fiction game with the Blade Ink Template

1. Write your story

  • Download Inky and write your story.
  • If you don't know Ink, you can read the tutorial Writing with Ink.

2. Export your story to Blade Ink Template

  • Make sure you have installed the JDK 8
  • Download the Blade Ink Template.
  • Export your story to JSON from Inky as and copy it to the assets folder in the Blade Ink Template.
  • You can now test your story with ./gradlew desktop:run in Mac and Linux, or gradlew.bat desktop:run in Windows.

3. Customize your fonts, colors, images and titles.

  • Edit the ui/ui.json with your text editor and customize the skin of your game.
  • Overwrite the images in ui/1 with yours.
  • Change the title property in the with your app title.

4. Prepare for Android

  • Overwrite all icons in android/res/drawable-* with your app icons.
  • Put your app. name in the android/res/values/strings.xml file.
  • Change the applicationId property in the android/build.gradle file with yours.

3. Prepare for Desktop

  • Overwrite all icons in desktop/src/main/resources/icons with your app icons.

4. Prepare for iOS

  • Overwrite all icons in ios/data/Media.xcassets/AppIcon.appiconset with your app icons.
  • Overwrite all launch images in ios/data with your app launch images.
  • Change and app.idproperties in the ios/ file with yours.

5. Releasing your game

Releasing your game is very easy with the script.

Unfortunately this is an Unix script and only works on Macos and Linux. Windows users can install a bash shell to execute the script or use the gradlew.bat directly to generate the packages. More info about using gradlew here.

The first step is to edit the script and set the next parameters:

# The destination folder for the packaged application

# IOS signing
IOS_SIGN_IDENTITY="iPhone Distribution"
IOS_PROVISIONING_PROFILE="your app provisioning profile"

# Android signing

And now you can:

Generate a .ipa for iPhone and iPad:

./ ios

Generate a .apk for Android:

./ android

Generate a runnable .jar for desktop:

./ desktop

Create native executables for desktop platforms

The normal way to distribute desktop applications is to embed the Java VM inside the package to not force the user to install Java.

There are several tools to create native executables for Windows, Macos and Linux with your runnable .jar. Some examples:

  • packr: Generates Windows, Macos and Linux packages.
  • launch4j: Generates packages for Windows.


A template to create multi platform IF games written with the Ink language.







No releases published


No packages published