▄ ▜
▌▌▌▌▛▌▛▌█▌▛▌▛▌▛▘▛▘▀▌▌▌▌▐
▙▘▙▌▌▌▙▌▙▖▙▌▌▌▙▖▌ █▌▚▚▘▐▖
▄▌
Infinite text-based RPG dungeon crawler with crafting, classes, quests, and optional AI narration.
Built for terminal gameplay, smart natural language commands, and endless replayability.
- Infinite Dungeon – Procedurally generated rooms that go on forever (
go northforever) - Deep Zone System – Entrance → Mid → Deep → Abyss → Void → Nightmare → Eternal → Boss
- Expanded Monster System – 50+ monster families with special abilities, elites, minions, and mini-bosses
- Class System – Warrior, Mage, Rogue with unique bonuses
- Perk Progression – Level up and choose powerful perks
- Rich Combat – Attack, Defend, Flee, Use items, Spells with dice rolls and animations
- Blacksmith – Forge weapons & armor from materials
- Alchemist – Brew healing, buff, and permanent stat potions
- Rune Etching – Apply powerful runes to gear
- Set Bonuses – Collect powerful armor sets (Void Walker, Dragon Knight, etc.)
- Recycle System – Break down unwanted items
- Smart NLI – Natural language input with fuzzy spell correction (e.g.
attac→attack) - Beautiful TUI – Progress bars, dice animations, box borders, status strips
- Quest System – Dynamic and template-based quests
- Persistent Soul – Character memory and personality file
- Optional LLM Narration – Works great with or without Ollama
- Zero-LLM fallback mode (perfect for low-resource machines)
- Python game engine + Node.js TUI
- Save / Load system
- Detailed error logging
- Node.js 18+
- Python 3.9+
- (Optional) Ollama +
qwen2.5:0.5bfor enhanced narration
Put all files into a /dungeoncrawl/ folder on your system, then bash:
cd ~/dungeoncrawl/ #The folder you have the files innpm installnpm start| Action | Example Commands |
|---|---|
| Movement | north, go east, n, e |
| Combat | attack, a, defend, flee |
| Exploration | look, search, take sword |
| Items | use potion, equip iron sword |
| Crafting | blacksmith, alchemist, craft Iron Sword |
| Info | status, inventory, quests |
| Rest | rest |
| Special | cast fireball, /roll, /help |
Full command list: Type /help in game.
- Explore deeply – Better loot and stronger monsters appear in deeper zones
- Craft early – Iron gear makes a huge difference
- Manage HP – Use
restwisely, potions are life-savers - Collect sets – Full armor sets grant powerful bonuses
- Permanent potions are extremely strong but limited
- Backend: Python 3 (game engine, procedural generation)
- Frontend: Node.js + rich TUI
- AI (optional): Ollama (local LLMs)
- Dependencies:
axios,python-shell,dotenv
MIT License
