Skip to content

e.g. /home/yourname/bashcrawl/ENTRANCE/cellar (the ... is your install…

The cellar reeks of wine and secrets. Barrels line the walls; cobwebs drape the ceiling. Four iron doors lead deeper into the dungeon — armoury, chapel, vault, scrap. But first you must find the emerald amulet.

🕹️ Play This Chamber

This page is your walkthrough and strategy guide — play right here in the browser, then follow the steps below.

The {% raw %}{% include %}{% endraw %} tag below renders an interactive terminal on the published site; in the raw Markdown source it just looks like a macro.

{% include bashcrawl-terminal.html room="Cellar" %}

🎯 Quest Objectives

  • Identify every file type in the cellar using ls -F
  • Use the file command to interrogate items
  • Create a useful alias to speed up exploration
  • Find and collect the emerald amulet
  • Locate all four exits (armoury, chapel, vault, scrap)

🗺️ Quest Prerequisites

⚡ Command Cheatsheet

Command What It Does
ls -F List with type markers
ls -la Long listing, including hidden files
file filename Describe what type of file this is
alias name='cmd' Create a command shortcut
alias List all defined aliases
unalias name Remove an alias
type name Show how a name is resolved (builtin/alias/function/file)

ls -F Symbol Key

Symbol Meaning
/ Directory
* Executable file
@ Symbolic link
= Socket
\| Named pipe (FIFO)
(none) Regular file

🗺️ Walkthrough

Step 0 — Enter the cellar

First launch the game shell — this drops you inside the dungeon at an interactive prompt:

./main.sh --interactive

Once you see the game prompt, descend from the entrance into the CELLAR:

cd cellar
pwd
# e.g. /home/yourname/bashcrawl/ENTRANCE/cellar  (the ... is your install path)

If you arrived here straight from the Entrance walkthrough, you are already in the game shell — just cd cellar.

Step 1 — Survey the cellar

ls -F
# Example output:
# emerald_amulet  armoury/  chapel/  vault/  scrap/  dusty_scroll  recipe*

Notice the variety: a regular file (emerald_amulet), directories (/), and an executable (recipe*). The * after recipe is the executable marker ls -F adds — it is not part of the filename, and running the recipe is optional.

Step 2 — Investigate with file

file dusty_scroll
# dusty_scroll: ASCII text

file recipe
# recipe: Bourne-Again shell script, ASCII text executable

file reads the file's magic bytes — much more reliable than guessing from the name.

Step 3 — Read the scroll

cat dusty_scroll

The scroll confirms the emerald amulet rests here in the cellar and warns about hidden traps in the deeper chambers.

Step 4 — Collect the amulet

cat emerald_amulet

Reading it adds it to your inventory. Verify with inventory — a special command the bashcrawl game environment provides (not a standard Unix command):

inventory
# Shows: emerald amulet ✓

Step 5 — Create a helpful alias

# Quick inventory check shortcut
alias inv='inventory'

# Quick navigation shortcut
alias back='cd ..'

# Verify
alias

Curious how the shell resolves a name? type tells you whether it is a builtin, an alias, a function, or a file on disk:

type ls
# On Debian/Ubuntu: ls is aliased to `ls --color=auto`
# On a minimal system: ls is /bin/ls

Aliases last only for the current session unless added to ~/.bashrc or ~/.bash_profile.

Step 6 — Identify all four exits

ls -F
# armoury/  chapel/  vault/  scrap/

The output above is abbreviated to highlight the four doorways — the regular files from Step 1 (emerald_amulet, dusty_scroll, recipe*) are still listed too. Each directory leads to a distinct area of the dungeon. You can tackle them in any order.

💡 Common Pitfalls

Problem Cause Fix
alias: bad alias name Space in alias name Use underscores: alias my_cmd='...'
inventory not found Not in game shell Start with ./main.sh --interactive
Can't find emerald amulet Wrong directory pwd; make sure you are in CELLAR
All four exits missing Older game version Run ./setup.sh --repair

✅ Validation

  • You can explain every ls -F symbol from memory
  • You created and tested at least one alias
  • The emerald amulet is in your inventory
  • You know which four chambers you can enter next

➡️ Next Steps

Choose your next chamber — all four are unlocked:

Chamber Skills Link
⚔️ Armoury Permissions, chmod, combat Armoury
⛪ Hidden Chapel Hidden files, man pages Chapel
🔒 Vault Environment variables, export Vault
🗑️ Scrap Heap Symbolic links, ln -s Scrap

{% include bashcrawl-play-local.html %}

📚 External Resources

Continue your terminal adventure with these resources:

Emerald amulet secured. Four doors, four paths. The dungeon deepens. 🍷

🕸️ Knowledge Graph

Structured wiki-links connect this quest to the IT-Journey knowledge graph. Open the Obsidian Graph View to explore connections. The [[wiki-link]] syntax below is Obsidian wiki-link notation — clickable in Obsidian, plain text elsewhere.

Level hub: [[Level 0000 - Foundation & Init World]] Overworld: [[🏰 Overworld - Master Quest Map]] Prerequisites: [[Bashcrawl Entrance: Your First Terminal Commands]] Unlocks: [[Bashcrawl Armoury: File Permissions and Script Execution]] · [[Bashcrawl Hidden Chapel: Hidden Files and Man Pages]] · [[Bashcrawl Vault: Environment Variables and the Goblet Puzzle]] · [[Bashcrawl Scrap Heap: Symbolic Links and Portal Creation]] Sequel quests: [[Bashcrawl Armoury: File Permissions and Script Execution]] · [[Bashcrawl Hidden Chapel: Hidden Files and Man Pages]] · [[Bashcrawl Vault: Environment Variables and the Goblet Puzzle]] · [[Bashcrawl Scrap Heap: Symbolic Links and Portal Creation]] Obsidian docs: [[Obsidian Knowledge Graph and Wiki Links]]