explaingit

webxos/dungeoncrawl

Analysis updated 2026-05-18

2PythonAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

An infinite, procedurally generated text RPG you play entirely in the terminal, with optional local AI narration.

Mindmap

mindmap
  root((Dungeon Crawl))
    What it does
      Procedural dungeon
      Turn-based combat
      Crafting system
    Tech stack
      Python
      Node.js
    Use cases
      Terminal gaming
      Offline RPG
      AI-narrated play
    Audience
      Gamers
      Hobbyist coders

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

Play an endless dungeon crawler in your terminal with escalating zones and over 50 monster types.

USE CASE 2

Choose a Warrior, Mage, or Rogue class and craft weapons, armor, and potions as you progress.

USE CASE 3

Enable optional local AI narration through Ollama, or play fully offline with the zero-LLM fallback.

What is it built with?

PythonNode.jsOllama

How does it compare?

webxos/dungeoncrawl0-bingwu-0/live-interpreter0xkaz/llm-governance-dashboard
Stars222
LanguagePythonPythonPython
Setup difficultyeasymoderatehard
Complexity2/52/54/5
Audiencegeneralgeneralops devops

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

How do you get it running?

Difficulty · easy Time to first run · 5min

AI narration is optional and requires a locally running Ollama model.

MIT license lets you use, modify, and distribute freely, including commercially.

In plain English

Dungeon Crawl is an infinite text-based RPG (role-playing game) that runs entirely in the terminal. The game is built around a procedurally generated dungeon, meaning the rooms are created on the fly as you explore, so you can keep going deeper without ever hitting an end. The dungeon progresses through escalating zones from Entrance through Abyss, Void, Nightmare, Eternal, and finally Boss, with stronger monsters and better loot the deeper you go. You choose a character class (Warrior, Mage, or Rogue), each with unique bonuses, and level up by gaining perks. Combat uses dice rolls and includes options to attack, defend, flee, cast spells, and use items. The game includes over 50 monster families with special abilities, elites, and minibosses. Alongside combat, there is a crafting system: a Blacksmith for weapons and armor, an Alchemist for potions including permanent stat upgrades, a Rune Etching system, and armor sets that grant bonuses when collected together. One of the key usability features is a natural language input system with fuzzy correction, so if you type "attac" instead of "attack", the game understands what you meant. The terminal interface uses progress bars, animations, and visual borders. AI narration from Ollama (a local language model runner) is optional. The game works fully without it in a zero-LLM fallback mode, making it usable on low-resource machines. The game engine is Python, the terminal interface uses Node.js, and the license is MIT.

Copy-paste prompts

Prompt 1
Show me how to install and run Dungeon Crawl in my terminal.
Prompt 2
Explain how to enable AI narration in Dungeon Crawl using a local Ollama model.
Prompt 3
What perks and bonuses does the Mage class get in Dungeon Crawl?
Prompt 4
How does Dungeon Crawl's natural language input handle typos like 'attac' for 'attack'?

Frequently asked questions

What is dungeoncrawl?

An infinite, procedurally generated text RPG you play entirely in the terminal, with optional local AI narration.

What language is dungeoncrawl written in?

Mainly Python. The stack also includes Python, Node.js, Ollama.

What license does dungeoncrawl use?

MIT license lets you use, modify, and distribute freely, including commercially.

How hard is dungeoncrawl to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is dungeoncrawl for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.