Greetings, aspiring script mage! In this side quest, you will forge a terminal-based game using the arcane arts of Bash scripting. Starting with bashrun as your foundation, you will enhance and expand it into a fully interactive adventure — complete with inventory, combat, and save systems.

🎯 Quest Objectives

Primary Objectives (Required for Quest Completion)

Clone and explore the bashrun repository — Understand the game’s structure and components
Enhance the storyline and levels — Add new levels with puzzles and objectives
Implement an inventory system — Create item collection and management mechanics
Add save/load functionality — Allow players to preserve and restore progress

Secondary Objectives (Bonus Achievements)

Build a combat system — Create enemy encounters with attack/run mechanics
Add ASCII art and UI polish — Improve the visual presentation of the game
Create a comprehensive tutorial — Help new players learn the game mechanics
Write unit tests for game functions — Validate game logic with automated tests

Mastery Indicators

Can explain Bash function syntax and variable scoping
Can create interactive terminal applications from scratch
Can implement file-based persistence in shell scripts
Can debug and troubleshoot Bash scripts independently

🗺️ Quest Prerequisites

📋 Knowledge Requirements

Basic bash command knowledge (cd, ls, cat, echo)
Terminal navigation skills
Text editor familiarity (nano, vim, or VS Code)

🛠️ System Requirements

macOS, Linux, or WSL on Windows
Git installed and configured
Bash shell access

Starting with bashrun as a base and building upon it is a great way to create an advanced terminal-based game. bashrun is typically built using shell scripts, which can be a bit limiting but also provides a good foundation for learning and expanding.

Here’s a step-by-step guide to start with bashrun and build upon it:

Step 1: Setting Up bashrun

Clone the bashrun Repository: If bashrun is hosted on a repository, you can clone it using:
```
git clone https://github.com/commandlineadventure/bashrun.git bashrun
cd bashrun
```
Note: If the above repository is unavailable, you can create your own bashrun project from scratch using the code examples below, or search for “bash text adventure” on GitHub for similar projects.
Understand the Structure: Explore the directory structure and understand how the game is organized. Typically, it might include directories for maps, scripts for different levels, and resources for the game.

Step 2: Basic Improvements

Enhance Storyline and Levels:
- Add new levels with more complex puzzles and objectives.
- Create more detailed and engaging storylines.
Example of adding a new level (level2.sh):
```
#!/bin/bash
echo "Welcome to Level 2!"
echo "You need to find the hidden key to unlock the treasure."

# Player actions and logic here
```

Improve Navigation and Interaction: Add more commands for interaction, such as examining objects or using items.

Example of an interaction command:

function examine {
    case $1 in
        "key")
            echo "It's a shiny golden key. It might unlock something."
            ;;
        "door")
            echo "It's a sturdy wooden door. It seems to be locked."
            ;;
        *)
            echo "You can't examine that."
            ;;
    esac
}

Add an Inventory System: Implement a simple inventory system to manage items collected by the player.

Example inventory system:

inventory=()

function add_to_inventory {
    inventory+=("$1")
    echo "$1 added to your inventory."
}

function show_inventory {
    echo "Your inventory: ${inventory[@]}"
}

Step 3: Advanced Features

Implement Save/Load Functionality: Allow players to save their progress and load it later.

Example save/load system:

function save_game {
    echo "${inventory[@]}" > savefile.txt
    echo "Game saved."
}

function load_game {
    if [ -f savefile.txt ]; then
        inventory=($(cat savefile.txt))
        echo "Game loaded."
    else
        echo "No saved game found."
    fi
}

Add a Combat System: Create a simple combat system where players can encounter enemies and engage in battles.

Example combat system:

function combat {
    local enemy_health=10
    local player_health=20

    echo "You encounter an enemy!"

    while [ $enemy_health -gt 0 ] && [ $player_health -gt 0 ]; do
        echo "Choose an action: [attack/run]"
        read action
        case $action in
            "attack")
                enemy_health=$((enemy_health - 2))
                player_health=$((player_health - 1))
                echo "You attack the enemy. Enemy health: $enemy_health"
                echo "The enemy attacks you. Your health: $player_health"
                ;;
            "run")
                echo "You run away!"
                return
                ;;
            *)
                echo "Invalid action."
                ;;
        esac
    done

    if [ $player_health -le 0 ]; then
        echo "You have been defeated."
    else
        echo "You defeated the enemy!"
    fi
}

Step 4: Polish and Expand

Enhance User Interface: Improve the display and user interface to make the game more visually appealing. Use ASCII art for maps and objects.
Add More Interactions and Puzzles: Introduce complex puzzles and more interactive elements to keep the game engaging.
Create a Comprehensive Tutorial: Provide a detailed tutorial at the beginning to help new players understand the game mechanics.
Test and Iterate: Continuously test your game and gather feedback. Use this feedback to make iterative improvements.

Example Directory Structure

bashrun/
├── maps/
│   ├── level1.txt
│   ├── level2.txt
├── scripts/
│   ├── level1.sh
│   ├── level2.sh
│   ├── common.sh  # Contains common functions like inventory and combat
├── resources/
│   ├── ascii_art/
│   ├── items.txt
├── savefile.txt
└── README.md

Example `common.sh`

#!/bin/bash

# Inventory system
inventory=()

function add_to_inventory {
    inventory+=("$1")
    echo "$1 added to your inventory."
}

function show_inventory {
    echo "Your inventory: ${inventory[@]}"
}

# Combat system
function combat {
    local enemy_health=10
    local player_health=20

    echo "You encounter an enemy!"

    while [ $enemy_health -gt 0 ] && [ $player_health -gt 0 ]; do
        echo "Choose an action: [attack/run]"
        read action
        case $action in
            "attack")
                enemy_health=$((enemy_health - 2))
                player_health=$((player_health - 1))
                echo "You attack the enemy. Enemy health: $enemy_health"
                echo "The enemy attacks you. Your health: $player_health"
                ;;
            "run")
                echo "You run away!"
                return
                ;;
            *)
                echo "Invalid action."
                ;;
        esac
    done

    if [ $player_health -le 0 ]; then
        echo "You have been defeated."
    else
        echo "You defeated the enemy!"
    fi
}

# Save/Load system
function save_game {
    echo "${inventory[@]}" > savefile.txt
    echo "Game saved."
}

function load_game {
    if [ -f savefile.txt ]; then
        inventory=($(cat savefile.txt))
        echo "Game loaded."
    else
        echo "No saved game found."
    fi
}

This guide should help you get started with building upon bashrun to create a more advanced and engaging terminal game. Enjoy the process and happy coding!

🏆 Quest Completion Validation

Portfolio Artifacts Created

Enhanced bashrun game — Working game with multiple levels and features
Inventory system — Functional item collection and management
Combat system — Enemy encounter mechanics
Save/load system — File-based game state persistence

Skills Demonstrated

Bash Scripting Proficiency — Functions, variables, control flow, and I/O
Game Design Thinking — Level progression, mechanics, and player engagement
File System Interaction — Reading and writing game data
Code Organization — Modular script structure with reusable functions