Bashcrawl Quest: Terminal Adventure RPG
By IT-Journey Team
An interactive terminal-based adventure game that teaches command line skills through exploration and puzzle-solving in a mystical dungeon
Estimated reading time: 9 minutes
Table of Contents
Welcome, brave adventurer, to the mystical realm of Bashcrawl! This is no ordinary quest - it’s an interactive terminal-based adventure that will transform you from a command line novice into a seasoned digital explorer.
In this epic journey, you’ll navigate through mysterious dungeons, solve ancient puzzles, and discover hidden treasures, all while mastering the fundamental commands that every IT hero must know.
🎯 Quest Objectives
By completing this terminal adventure, you will master:
Primary Objectives (Required for Quest Completion)
- Terminal Navigation - Master directory exploration with
cd,ls, andpwd - File Discovery - Learn to identify and examine different file types
- Text Examination - Use
cat,less, and other text viewing commands - Problem Solving - Apply command line skills to solve adventure puzzles
Secondary Objectives (Bonus Achievements)
- Advanced Navigation - Discover hidden directories and secret passages
- Command Mastery - Experiment with advanced options and flags
- Story Completion - Uncover the complete narrative through exploration
Mastery Indicators
You’ll know you’ve truly conquered this quest when you can:
- Navigate any terminal environment with confidence
- Quickly identify file types and their purposes
- Use text examination commands effectively
- Solve new terminal-based challenges independently
🗺️ Quest Prerequisites
📋 Knowledge Requirements
- Basic understanding of what a terminal/command line is
- Familiarity with typing commands and pressing Enter
- Understanding that commands are case-sensitive
🛠️ System Requirements
- Any Unix-like system (Linux, macOS, or Windows with WSL)
- Terminal application access
- Bash or compatible shell environment
🧠 Skill Level Indicators
- Comfortable opening a terminal application
- Can type commands without fear of “breaking” something
- Ready to learn through experimentation and exploration
📚 Resource Codex
To aid you in your quest, consult these ancient tomes of knowledge:
- Play Bashcrawl Online - Start instantly in your browser with no local setup.
- Bashcrawl GitHub Repository - Clone the full game for local play, scripting practice, and contributions.
- The Spellbook: Bash Cheatsheet - Quick reference for essential commands and scripting techniques.
- The Grand Grimoire: Complete BASH Reference - Exhaustive guide covering every aspect of GNU Bash.
☁️ Instant Play Online
The fastest way to begin is the web version:
- Open Bashcrawl Web.
- Start with
pwd,ls -F,cat scroll, andcd cellar. - Use the Docs panel or press
F1when you need help. - Let the quest tracker guide you through the first objectives.
The web game runs fully in your browser, stores progress locally, and keeps you inside a safe simulated terminal. Use it as your first playthrough before installing the full repository.
🌍 Adventure Setup Guide
Use the local repository when you want the complete Bashcrawl experience, including the Textual TUI, classic Bash emulator, native terminal mode, tutorial mode, agent mode, screenshots, tests, and contribution workflow.
🐧 Linux Territory Setup
git clone https://github.com/bamr87/bashcrawl.git
cd bashcrawl
./setup.sh
./main.sh --interactive
🍎 macOS Kingdom Setup
git clone https://github.com/bamr87/bashcrawl.git
cd bashcrawl
./setup.sh
./main.sh --interactive
macOS note: If you download a ZIP, Archive Utility can strip executable permissions.
git cloneis the recommended path.
🪟 Windows Empire Setup (WSL)
# First ensure WSL is installed
wsl --install
# Then in WSL terminal:
git clone https://github.com/bamr87/bashcrawl.git
cd bashcrawl
./setup.sh
./main.sh --interactive
🎮 Choose Your Play Mode
| Mode | Command or Link | Best For |
|---|---|---|
| Web TUI | bamr87.github.io/bashcrawl | First playthrough, classrooms, no-install practice |
| Textual TUI | ./main.sh --interactive |
Beginners who want a rich local interface |
| Classic Bash Emulator | ./main.sh --classic |
Systems without Python/Textual dependencies |
| Native Terminal | ./main.sh --native |
Experienced users who want the traditional filesystem adventure |
| Tutorial Mode | ./main.sh --tutorial |
Step-by-step guided learning |
| Agent Mode | ./main.sh --agent |
AI playtesting, screenshots, and automation workflows |
🛠️ Local Maintenance Commands
./setup.sh --verify # Check installation health
./setup.sh --repair # Fix common permission/setup issues
./setup.sh --health-check # Run diagnostics
./main.sh --status # Show current game progress
./main.sh --reset # Reset progress for a fresh run
🧙♂️ Chapter 1: Entering the Digital Dungeon
As you approach the ancient digital dungeon, you see mysterious symbols carved into the virtual stone. These are not random markings - they are the sacred commands that will guide you through this realm.
⚔️ Essential Terminal Spells
Before beginning your adventure, familiarize yourself with these magical incantations:
| Command | Magic Effect | Adventure Use |
|---|---|---|
ls |
Reveals contents of current location | Discover rooms and items |
ls -F |
Shows file types with special symbols | Identify different entities |
cd [directory] |
Transports you to new location | Move between dungeon rooms |
pwd |
Reveals your current position | Know where you are |
cat [file] |
Reads scrolls and documents | Examine clues and stories |
less [file] |
Reads long texts page by page | Study detailed manuscripts |
🔍 Understanding the Mystical Symbols
When you cast ls -F, you’ll see these magical markers:
- / - Portals to other chambers (directories)
- * - Magical artifacts with power (executable files)
- @ - Mystical links to distant realms (symbolic links)
- (no symbol) - Ancient scrolls and documents (regular files)
🎮 Chapter 2: Beginning Your Adventure
🏰 Step 1: Enter the Dungeon
Start your journey by running the entrance script:
./main.sh --interactive
This will launch the safe local TUI and transport you to the beginning of your adventure. If you are playing online, use the browser prompt instead and begin with pwd.
🗝️ Step 2: Read Everything Carefully
The adventure provides narrative clues and hints. Pay attention to:
- Story text that sets the scene
- Hints about which commands to use
- Descriptions of what you should look for
- Clues about where to go next
⚡ Step 3: Experiment Fearlessly
Remember: You cannot break anything in this virtual dungeon! Feel free to:
- Try different command variations
- Explore unexpected paths
- Read all the files you discover
- Take notes about interesting discoveries
🧙♂️ Chapter 3: Advanced Exploration Techniques
🔮 Power-User Navigation
As you become more comfortable, try these advanced techniques:
# View detailed file information
ls -la
# Navigate up one level quickly
cd ..
# Return to your home base
cd ~
# See command history
history
# Search for specific files
find . -name "*.txt"
🛡️ Problem-Solving Strategies
When you encounter challenges:
- Read all available clues - Every file might contain helpful information
- Try different approaches - If one command doesn’t work, try variations
- Pay attention to file names - They often hint at their contents
- Use tab completion - Type part of a filename and press Tab
- Don’t give up - The adventure is designed to teach through discovery
🎮 Chapter 4: Quest Completion Challenges
🟢 Novice Challenge: Basic Navigation
- Successfully navigate through the first 3 chambers
- Read at least 5 different files using
cat - Identify all file types in each room using
ls -F
🟡 Adventurer Challenge: Exploration Mastery
- Discover all hidden chambers and secret areas
- Solve all puzzles without external help
- Document your journey with notes about each discovery
🔴 Expert Challenge: Command Mastery
- Complete the entire adventure using advanced commands
- Find alternative solutions to puzzles
- Create your own mini-adventure for others
🏆 Quest Completion Validation
Portfolio Artifacts Created
- Adventure Log: Personal notes documenting your journey
- Command Reference: List of commands learned with explanations
- Problem Solutions: Documentation of how you solved each puzzle
Skills Demonstrated
- File Navigation: Confidently move between directories
- Content Examination: Effectively read and understand file contents
- Problem-Solving: Apply terminal knowledge to new challenges
Knowledge Gained
- Terminal Confidence: No longer intimidated by command line
- File System Understanding: Clear mental model of directory structures
- Command Application: Know when and how to use basic commands
🗺️ Quest Network Position
Quest Series: Level 000 - Foundation Skills
Prerequisite Quests:
- None - This is a perfect starting adventure!
Follow-Up Quests:
- Bash Run Quest - Shell Scripting Fundamentals
- Bash Scripting Mastery - Automation and reusable scripts
- Hello n00b Quest - Continuing Your IT Journey
- VS Code Mastery - Development Environment Setup
Parallel Quests (can be completed in any order):
- Character Building and IT Fundamentals quests
- Basic development environment setup quests
🎉 Congratulations, Terminal Explorer!
You have successfully completed the Bashcrawl Terminal Adventure! Your journey through the digital dungeons has equipped you with essential command line skills that will serve as the foundation for all your future IT adventures.
🌟 What’s Next?
Your newfound terminal mastery opens several exciting paths:
- Deepen Your Command Skills: Explore advanced bash scripting
- Expand Your Toolkit: Learn text processing tools like
grep,sed, andawk - Apply Your Skills: Use terminal commands in real development projects
- Share Your Adventure: Help others discover the magic of the command line
📚 Additional Resources
- Play Online: Bashcrawl Web
- Current IT-Journey Fork: GitHub — bamr87/bashcrawl
- Original Upstream Repository: GitLab — slackermedia/bashcrawl
- Command Line Learning: The Linux Command Line
- Terminal Games: Other CLI adventure games
- Advanced Bash: Advanced Bash Scripting Guide
May your commands always execute successfully, your paths be clearly navigated, and your files be forever found! Ready for your next terminal adventure? The digital realm awaits! ⚔️✨