inkgd - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #golang #macos #cli #kubernetes #awesome-list #vue #pytorch #security #ios #mcp

inkgd

(★ 390)

Implementation of inkle's Ink in pure GDScript for Godot, with editor support.

File Explorer

Download Latest Version (.zip)

- - bug_report.md
- - continuous-integration.yml
- PULL_REQUEST_TEMPLATE.md
- - autofree.gd
  - comparator.gd
  - compare_result.gd
  - diff_formatter.gd
  - diff_tool.gd
  - doubler.gd
  - get_native_script.gd
  - gut.gd
  - gut_cmdln.gd
  - gut_config.gd
  - gut_plugin.gd
  - GutScene.gd
  - GutScene.tscn
  - hook_script.gd
  - icon.png
  - icon.png.import
  - junit_xml_export.gd
  - LICENSE.md
  - logger.gd
  - method_maker.gd
  - one_to_many.gd
  - optparse.gd
  - orphan_counter.gd
  - parameter_factory.gd
  - parameter_handler.gd
  - plugin.cfg
  - plugin_control.gd
  - printers.gd
  - result_exporter.gd
  - signal_watcher.gd
  - source_code_pro.fnt
  - spy.gd
  - strutils.gd
  - stub_params.gd
  - stubber.gd
  - summary.gd
  - test.gd
  - test_collector.gd
  - thing_counter.gd
  - UserFileViewer.gd
  - UserFileViewer.tscn
  - utils.gd
- - .gitignore
  - ink_player.gd
  - ink_player_factory.gd
  - LICENSE
  - plugin.cfg
  - runtime.gd
- - conf.py
  - index.rst
- .gdignore
- make.bat
- Makefile
- requirements.txt
- - Poppins-Medium.tres
  - Poppins-Medium.ttf
  - Vollkorn-Regular.tres
  - Vollkorn-Regular.ttf
- - inkgd.png
  - inkgd.png.import
  - inkgd_the_intercept.png
  - inkgd_the_intercept.png.import
  - spinner.png
  - spinner.png.import
  - transparent.png
  - transparent.png.import
- - crime_scene.tscn
  - main.gd
  - main.tscn
  - the_intercept.tscn
- icon-1024.png
- icon-1024.png.import
- icon-120.png
- icon-120.png.import
- icon-76.png
- icon-76.png.import
- icon.png
- icon.png.import
- - test_base.gd
- - performance_test.gd
  - performance_test.tscn
- - compile_fixtures
- - test_ink_item.gd
  - test_path.gd
  - test_utils.gd
- tests.tscn
.gitattributes
.gitignore
.gut_editor_config.json
.gutconfig.json
.inkgd_ink.cfg
AUTHORS
build_example
CHANGELOG.md
ci_export_presets.cfg
CONTRIBUTING.md
default_env.tres
inkgd.csproj
inkgd.sln
LICENSE
project.godot
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ![inkgd](https://i.imgur.com/QbLG9Xp.png)

[![build](https://github.com/ephread/inkgd/workflows/build/badge.svg)](https://github.com/ephread/inkgd/actions)
[![Documentation Status](https://readthedocs.org/projects/inkgd/badge/?version=latest)](https://inkgd.readthedocs.io/en/latest/?badge=latest)
![Version](https://img.shields.io/badge/version-0.5.0-orange.svg)
![Godot Version](https://img.shields.io/badge/godot-3.3+-blue.svg)
![License](https://img.shields.io/badge/license-MIT-green.svg)

Implementation of [inkle’s Ink] in pure GDScript, with editor support.

> [!IMPORTANT]
> _inkgd_ is compatible with Godot 4.2+, but has no official releases yet.
> To use _inkgd_ with Godot 4.2+, fetch the [`godot4`] branch.

> [!NOTE]
> _inkgd_ shines for rapid prototyping in GDScript and small games.
> While the runtime implementation is feature-complete and passes the
> test suite, it’s slower than the original C# implementation. It is used
> in commercial games, but if you need a faster solution and don’t mind C#,
> you should consider using [godot-ink].

[`godot4`]: https://github.com/ephread/inkgd/tree/godot4
[inkle’s Ink]: https://github.com/inkle/ink
[godot-ink]: https://github.com/paulloz/godot-ink

## Table of contents

* [Features](#features)
  * [Requirements](#requirements)
  * [Contributing](#asking-questions--contributing)
      * [Asking Questions](#asking-questions)
      * [Contributing](#contributing)
  * [Installation & Getting Started](#installation--getting-started)
  * [Editor Plugin](#editor-plugin)
  * [Compatibility Table](#compatibility-table)
  * [Acknowledgement](#acknowledgement)
      * [Code](#code)
      * [Ink Stories](#ink-stories)
  * [Sponsors](#sponsors)
  * [License](#license)

## Features
- [x] Fully-featured Ink runtime
- [x] Advanced editor features
	- [x] Automatic recompilation of managed stories
	- [x] Integrated story previewer

## Requirements
- Godot 3.3+
- Inklecate 1.0.0+

## Asking Questions / Contributing

### Asking questions

If you need help with something in particular, [start a discussion].
If you want to report a problem, [open an issue].

[start a discussion]: https://github.com/ephread/inkgd/discussions/new
[open an issue]: https://github.com/ephread/inkgd/issues/new/choose

### Contributing

If you want to contribute, be sure to take a look at [the contributing guide].

[the contributing guide]: https://github.com/ephread/inkgd/blob/master/CONTRIBUTING.md

## Installation & Getting Started

*inkgd* is available on Godot's [Asset Library]. The full documentation is
hosted on [Read The Docs].

[Asset Library]: http://godotengine.org/asset-library/asset/349
[Read The Docs]: https://inkgd.readthedocs.io/en/stable/

## Editor Plugin

![Ink panel demo](https://raw.githubusercontent.com/ephread/inkgd/main/docs/source/advanced/editor_plugin/img/ink_panel/ink_panel.gif)

## Compatibility Table

| _inkgd_ version | inklecate version |  Godot version  |
|:---------------:|:-----------------:|:---------------:|
|  0.1.0 – 0.1.4  |   0.8.2 – 0.8.3   |   3.1 – 3.2.1   |
|  0.2.0 – 0.2.1  |       0.9.0       |   3.1 – 3.2.1   |
|      0.2.2      |       0.9.0       |   3.2 – 3.2.3   |
|      0.2.3      |       0.9.0       |    3.2 – 3.4    |
|      0.3.0      |       1.0.0       |    3.2 – 3.4    |
|  0.4.0 – 0.4.7  |       1.0.0       |    3.3 – 3.5    |
|      0.5.0      |       1.1.1       |    3.3 – 3.5    |

## Acknowledgement

### Code

- _inkgd_ is based on the [original C# implementation], released under the
  MIT license, copyright inkle Ltd.
- _inkgd_ uses code ported from [godot-ink], released under the MIT license,
  copyright Paul Joannon.

[original C# implementation]: https://github.com/inkle/ink/blob/master/LICENSE.txt
[godot-ink]: https://github.com/paulloz/godot-ink/blob/master/LICENSE

### Ink Stories

- [_The Intercept_] and [_Crime Scene_], released under the MIT license,
  copyright inkle Ltd. The sample project uses slightly modified versions of
  these two stories.
- [_LD41 Emoji_], released under the MIT license, copyright Pat Scott.
- [_Not a halloween game_], released under the MIT license, copyright Samuel
  Sarette and Zachary Sarette.

[_The Intercept_]: https://github.com/inkle/ink-library/tree/master/Stories/The%20Intercept
[_Crime Scene_]: https://github.com/inkle/ink/blob/master/Documentation/WritingWithInk.md#7-long-example-crime-scene
[_LD41 Emoji_]: https://github.com/inkle/ink-library/tree/master/Stories/LD41%20Emoji
[_Not a halloween game_]: https://github.com/lunarcloud/not-a-halloween-game

### Documentation & Tutorials

- @videlanicolas started the documentation project on ReadTheDocs.
- Nicholas O'Brien did a whole [video series] about inkgd & Godot.

[video series]: https://www.youtube.com/playlist?list=PLtepyzbiiwBrHoTloHJ2B-DWQxgrseuMB

## Sponsors

[![WILD WITS Games](https://raw.githubusercontent.com/ephread/inkgd/main/docs/source/img/wild_wits_logo.webp)](https://wildwits.games)

## License

_inkgd_ is released under the MIT license. See LICENSE for details.