whatisgithub

What is textadventureengine?

doctorgonzo/textadventureengine — explained in plain English

Analysis updated 2026-05-18

2C#Audience · developerComplexity · 3/5Setup · moderate

In one sentence

A Unity toolkit for building text adventure games where rooms, items, combat, and dialogue are authored as data instead of code.

Mindmap

mindmap
  root((repo))
    What it does
      Parses player text commands
      Runs turn-based combat
      Handles saving and loading
    Tech stack
      C#
      Unity 6
      ScriptableObjects
    Use cases
      Build a parser text adventure
      Design branching NPC dialogue
      Create data-driven combat verbs
    Audience
      Unity game developers
      Hobbyist game makers
    Extras
      Connect Four minigame
      Skill and leveling system

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build a text adventure game without writing custom parser or combat code.

USE CASE 2

Design branching NPC dialogue trees that trigger quests and shop events.

USE CASE 3

Create new attack verbs and enemy behaviors purely through Unity data assets.

USE CASE 4

Save and reload full game state including inventory, quests, and status effects.

What is it built with?

C#UnityScriptableObjects

How does it compare?

doctorgonzo/textadventureengineatum-borg-interactive/road-sdkbabelive/windows
Stars222
LanguageC#C#C#
Setup difficultymoderatemoderatemoderate
Complexity3/53/53/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Unity 6 (6000.5.1f1) or a compatible Unity 6 release installed.

No license information was stated in the README.

So what is it?

Text Adventure Engine is a toolkit for building old style text based adventure games inside the Unity game engine. The idea is that most of a game, its rooms, items, enemies, dialogue, quests, and shops, gets built as data assets inside Unity's editor rather than written as code, while the engine itself handles the harder parts like understanding player commands, running combat, and saving progress. A player types commands like go north, take the lantern, or attack goblin into a terminal style screen, and the engine figures out what they mean. The command parser is fairly forgiving: it ignores small words like the and a, lets you type a shortened version of a name and still matches the right item or enemy, and understands direction shortcuts like n for north. Rooms connect to each other in six directions and can have exits that are locked, hidden until triggered, or blocked while you are carrying a certain item. Objects in a room can have their own behavior, letting you push, pull, or activate them to reveal new exits or items. Combat is turn based and takes into account chance to hit, chance to dodge, and how much armor reduces incoming damage, with equipped weapons and armor changing a character's stats. Game designers can define entirely new attack types as data, along with enemy behavior rules like healing when low on health. There is also an optional character progression system with levels, skill points, and both offensive and passive skills that can be learned or bought from trainers. Non-player characters can hold branching conversations with the player, where dialogue choices can be locked behind items or story flags and can trigger effects like giving items, starting quests, or opening a shop. The game state, including inventory, quest progress, room contents, and even temporary status effects, is saved to a file and can be reloaded later, with some built-in tolerance for missing content if assets get renamed or removed. As a bonus example of building an alternate game mode, the engine even includes a fully playable Connect Four minigame with three difficulty levels, the hardest of which plays using a proper lookahead search rather than random moves.

Copy-paste prompts

Prompt 1
Walk me through creating a new game scene with this engine's Create Game Scene tool.
Prompt 2
Explain how the parser matches partial item and enemy names like attack gob.
Prompt 3
Show me how to define a new CombatAction verb like a backstab attack.
Prompt 4
Help me set up a branching dialogue tree that opens a shop when a flag is set.

Frequently asked questions

What is textadventureengine?

A Unity toolkit for building text adventure games where rooms, items, combat, and dialogue are authored as data instead of code.

What language is textadventureengine written in?

Mainly C#. The stack also includes C#, Unity, ScriptableObjects.

What license does textadventureengine use?

No license information was stated in the README.

How hard is textadventureengine to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is textadventureengine for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.