TextAdventureJS

A text based adventure engine written in JavaScript. Create your own text adventure games and embed them into your website, or share and play them with the included demo player.

• Games are JSON files, that follow the textAdventureGameDatabase schema (tadb).
• Editor folder contains an editor that allows to create games with a GUI.
• Player folder contains a demo player that shows how to integrate the engine

The library and the player are written in pure JavaScript. The editor and some example code uses jQuery to keep the code more compact

History

The initial version was written around 2018 as a mini-game for my personal website.
In 2020, the project was refactored and published on GitHub.
In 2023, I started writing an Editor with a graphical user interface to make creating games easier, but I dropped it to work on other projects.
In 2025, I picked it up again and completed my work from 2023 together with major refactorings that simplified the game database complexity among other improvements to the engine itself, such as an automatic save feature.

Demo Player

The project includes a generic player for TextAdventureGameDatabase JSON files, which also acts as an example for creating your own.

Try it here: https://dak0r.github.io/TextAdventureJS/player/

Editor

I quickly realized that writing a complex game entirely in JSON is cumbersome and error-prone. So the idea for an editor with a graphical user interface came up early on in the project, but it took a few years until I finally ended up writing it. Here it is!

Try it here: https://dak0r.github.io/TextAdventureJS/editor/

Source Code

Documentation and source code is available on GitHub: https://github.com/Dak0r/TextAdventureJS?tab=readme-ov-file#usage