https://github.com/camertron/bashcrawl

Clone of https://gitlab.com/slackermedia/bashcrawl for use in CSCI 335: Cloud Computing
https://github.com/camertron/bashcrawl

Last synced: 18 days ago
JSON representation

Clone of https://gitlab.com/slackermedia/bashcrawl for use in CSCI 335: Cloud Computing

• Host: GitHub
• URL: https://github.com/camertron/bashcrawl
• Owner: camertron
• License: gpl-3.0
• Created: 2023-02-05T04:44:45.000Z (almost 2 years ago)
• Default Branch: master
• Last Pushed: 2023-02-05T04:45:00.000Z (almost 2 years ago)
• Last Synced: 2024-11-04T00:42:07.178Z (2 months ago)
• Language: Shell
• Size: 183 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Welcome!

This is a game to teach you the basics of using a POSIX (Linux, BSD, UNIX) terminal.

## Try it on your machine

To start playing, open a terminal.

Type the letters "cd " (just the letters, not the quotes) into the terminal...

Then a space (press the spacebar)...

Then drag and drop the ``entrance`` directory from this folder into your terminal.

If your terminal asks you what you want to do with what you have just dragged into it, select "Paste location".

If it doesn't ask, then expect it to paste the file path of the folder you just dragged into it.

Once you have something like:

```

$ cd /home/your_username/Downloads/bashcrawl/entrance

```

in your terminal window, press RETURN.

The exact path to the entrance varies, depending on where you saved the file.

Your first move is very important.

Type this into your terminal:

```

cat scroll

```

You are now playing the game.

May the gods save you.

## Try it online with mybinder

- Follow this link: [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gl/nthiery%2Fbashcrawl/HEAD).

- Wait a few seconds to a minute until the launcher appears.

- Click on the Terminal icon.

Note: mybinder sessions are temporary; the game is reinitialized each

time you disconnect.

[Learn more about the mybinder service](https://mybinder.readthedocs.io/en/latest/).

## NOTES FOR macOS X

It appears that there is a problem with the standard `Archive Utility` that is called from `Finder` when a zip archive is double-clicked to extract to the current folder, if you're downloading the archive from GitLab rather than using git's `clone` facility to download the game.  You may find that all of the files in the destination folder are set to be executable.  This will cause great confusion as you play the game as intended, because every plain text file will be indistiguishable from executable scripts.  Here's how to avoid this problem:

1.  Open your favorite terminal emulator app (e.g. `Terminal.app` or `iTerm2`).

1.  Navigate to the directory where you want to unpack the zip archive:

    ```

    cd /path/to/destination

    ```

    Replace '/path/to/destination' with the relative (does not start with slash '/') or absolute (starts with slash '/') path to your desired destination.

1.  Type `unzip ` (that's 'unzip' followed by one or more *spaces* [hit the space bar at least once])

1.  From the `Finder`, drag the bashcrawl-master.zip to your terminal emulator window.  The absolute path to your downloaded archive should be pasted into your terminal window similar to the following:

    ```

    unzip /Users/${USER}/Downloads/bashcrawl-master.zip

    ```

1.  Press `Enter` to unpack the contents of the zip archive to the current directory.

1.  In the terminal window change directory to `bashcrawl-master/entrance`:

    ```

    cd bashcrawl-master/entrance

    ```

At this point, you're in the game!  Have fun!