Pilot Episode

Licensing

For 3rd-party license compatibility issues, please refer to the information here: https://github.com/razterizer/8Beat/blob/main/README.md

About the Game

A cross-platform (Lin/Mac/Win) terminal-based shooter game.

https://www.youtube.com/watch?v=6ycg91F3Pn4

https://www.youtube.com/watch?v=MCauEDtP2ZU

Build & Run Instructions

There are two options on dealing with repo dependencies:

Repo Dependencies Option 1

This method will ensure that you are running the latest stable versions of the dependencies that work with Pilot_Episode.

The script fetch-dependencies.py used for this was created by Thibaut Buchert. fetch-dependencies.py is used in the following scripts below:

After a successful build, the scripts will then prompt you with the question if you want to run the program.

When the script has been successfully run for the first time, you can then go to sub-folder Pilot_Episode and use the build.sh / build.bat script instead, and after you have built, just run the run.sh or run.bat script.

Windows

Run the following script:

setup_and_build.bat

MacOS

Run the following script:

setup_and_build_macos.sh

Linux (Debian-based, e.g. Ubuntu)

Run the following script:

setup_and_build_debian.bat

Repo Dependencies Option 2

In this method we basically outline the things done in the setup_and_build-scripts in Option 1.

This method is more suitable for development as we're not necessarily working with "locked" dependencies.

You need the following header-only libraries:

• https://github.com/razterizer/Core
• https://github.com/razterizer/Termin8or
• https://github.com/razterizer/8Beat
• https://github.com/razterizer/AudioLibSwitcher_OpenAL ; Will be changed to something like AudioLibSwitcher_libsoundio in the future.
• https://github.com/razterizer/TrainOfThought
• https://github.com/razterizer/3rdparty_OpenAL ; Only needed for building on Windows.

Make sure the folder structure looks like this:

<my_source_code_dir>/lib/Core/                   ; Core repo workspace/checkout goes here.
<my_source_code_dir>/lib/Termin8or/              ; Termin8or repo workspace/checkout goes here.
<my_source_code_dir>/lib/8Beat/                  ; 8Beat repo workspace/checkout goes here.
<my_source_code_dir>/lib/AudioLibSwitcher_OpenAL ; AudioLibSwitcher_OpenAL repo workspace/checkout goes here.
<my_source_code_dir>/lib/TrainOfThought          ; TrainOfThought repo workspace/checkout goes here.
<my_source_code_dir>/lib/3rdparty_OpenAL         ; 3rdparty_OpenAL repo workspace/checkout goes here (only needed for Windows).
<my_source_code_dir>Pilot_Episode/               ; Pilot_Episode repo workspace/checkout goes here.

These repos are not guaranteed to all the time work with the latest version of Pilot_Episode. If you want the more stable aproach then look at Option 1 instead.

Windows

Then just open <my_source_code_dir>/Pilot_Episode/Pilot_Episode/Pilot_Episode.sln and build and run. That's it!

You can also build it by going to <my_source_code_dir>/Pilot_Episode/Pilot_Episode/ and build with build.bat. Then you run by typing run.bat.

MacOS

Make sure you have OpenAL-Soft installed: brew install openal-soft.

Then goto <my_source_code_dir>/Pilot_Episode/Pilot_Episode/ and build with ./build.sh.

Then run by typing ./bin/pilot_episode.

Linux (Ubuntu)

Make sure you have OpenAL-Soft installed: sudo apt install libopenal-dev.

Then goto <my_source_code_dir>/Pilot_Episode/Pilot_Episode/ and build with ./build.sh.

Then run by typing ./bin/pilot_episode.