Skip to content

bladecoder/blade-ink-template

master
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?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
ios
 
 
raw
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Blade Ink Template

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

Features:

  • 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 story.ink.json 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 inkplayer.properties 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 app.name and app.idproperties in the ios/robovm.properties file with yours.

5. Releasing your game

Releasing your game is very easy with the release.sh 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 release.sh script and set the next parameters:

# The destination folder for the packaged application
DIST_DIR=$HOME"/PACKAGES"

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

# Android signing
ANDROID_KEYSTORE=$HOME/folder/to/the/android.keystore
ANDROID_KEY_ALIAS=androidkeyalias

And now you can:

Generate a .ipa for iPhone and iPad:

./release.sh ios

Generate a .apk for Android:

./release.sh android

Generate a runnable .jar for desktop:

./release.sh 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.

About

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

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published