/single-user-dungeon

Single User Dungeon (SUD) scripted in Python language.

Primary LanguagePythonMIT LicenseMIT

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

Python MIT License

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