____     _   _     ____
  / ___|   | | | |   |  _ \
  \___ \   | | | |   | | | |
   ___) |_ | |_| | _ | |_| |_
  |____/(_) \___/ (_)|____/(_)

Single User Dungeon

Text-based adventure engine
Inspired by classic MUDs, focused on single-player experience.

Written in Python
Create & explore interactive dungeons with RPG & sandbox elements.

Data & translations via JSON files — easy customization.

Note

This game engine is being developed as from the scripts created by Tomas Varaneckas (Vilnius, Lithuania), and released on his blog Paranoid Engineering on November 25th, 2008.

---

Requirements

• Python 3.8+
• Standard libs: json, os, locale, pathlib
• No external dependencies

---

Installation & Running

$ git clone https://github.com/nerun/single-user-dungeon.git
$ cd single-user-dungeon/src
$ python3 -m game.main

Tip: type help inside the game for commands.

---

Localization

• Game content (rooms, objects, UI) in language/ folder JSON files.
• Add new language: create <locale_code>.json (e.g., fr_FR.json).
• Edit manually or with Poedit (v3.3+).
• Auto-detects system locale, defaults to English if missing.

---

License

MIT License — see LICENSE