Skip to content

razterizer/Pilot_Episode

Repository files navigation

Pilot Episode

GitHub License Static Badge

build ubuntu build macos build windows Valgrind Status

Top Languages GitHub repo size C++ LOC Commit Activity Last Commit Contributors

GitHub Downloads (all assets, all releases)

About the Game

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

image image image image image image image image image

ubuntu_cbbbzvqdup_360

ubuntu_gk3dzzntm0_360

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:

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_applaudio ; AudioLibSwitcher_applaudio repo workspace/checkout goes here.
<my_source_code_dir>/lib/TrainOfThought             ; TrainOfThought repo workspace/checkout goes here.
<my_source_code_dir>/lib/applaudio                  ; applaudio 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

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

Then run by typing ./bin/pilot_episode.

Linux

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

Then run by typing ./bin/pilot_episode.

Make New Release

To make a new release, you first have to update the RELEASE_NOTES.md document. E.g.:

image

Then to make a new release you should use the tag_release.sh script:

./tag_release -f RELEASE_NOTES.md

or if you want to re-upload an existing release, e.g.:

./tag_release 1.1.5.7. -f RELEASE_NOTES.md

you can also use these commands:

./tag_release bump patch "Release notes."
./tag_release bump minor "Release notes."
./tag_release bump major "Release notes."
./tag_release 1.1.5.7 "Release notes."

If you want to remove a release for some reason, you can do so by running the following git commands:

# Delete local tag
git tag -d release-1.0.0.0

# Delete remote tag
git push --delete origin release-1.0.0.0

Running from a Release

When you download a MacOS release then you need to tell the gatekeeper unblock the executable (here: pilot_episode), but only if you trust the program of course (check source code + release workflow if you're unsure). When you feel ready, you can allow the binary to be run by going to the release folder and type the following:

xattr -dr com.apple.quarantine pilot_episode

On Windows, you might have to unblock the exe by right-clicking the exe-file and check the Unblock checkbox.

About

My first terminal based game. It uses libraries Core, Termin8or and 8Beat.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •