Bashcrawl Documentation

Learn terminal commands by exploring a fantasy dungeon. Directories are rooms, files are scrolls, and executables are encounters.

Contents

• Getting Started — Installation, setup, and your first game
• Gameplay Guide — Mechanics, rooms, inventory, combat, and progression
• Complete Walkthrough — Every path, puzzle, and command in the dungeon
• Advanced Topics — Hidden areas, scripting encounters, and scroll standards
• Contributing — How to add rooms, write scrolls, and submit changes
• Improvement Plan — Known issues and planned enhancements
• TermForge Architecture — The universal terminal framework under the web game
• Authoring TermForge Apps — Build your own terminal tools on the framework
• Telnet Host — Serve the game or your tools over lightweight telnet/TCP

Quick Start

git clone https://github.com/bamr87/bashcrawl.git
cd bashcrawl
bash setup.sh
cd entrance && cat scroll

Prefer the browser? Run make web-preview (or open web/index.html) to play the static web trainer.