Projeto Carmen - Choose your own adventure

Projeto de Conclusão do Módulo 1 - Blue EdTech

This project was created as a final exam for the programming course at Blue EdTech. Projeto Carmen is a choose-your-own-adventure type of game run directly from Terminal using Python.

Why this game exists?

The final exam for the programming course at Blue EdTech was the creation of a choose-your-own-adventure type of game run directly from Terminal using Python. The game must use Object-Oriented Programming as well as programming best practices.

License Disclosure

This project is for educational purposes only. It must not be modified, sold or repurposed for any other reason. Carmen Sandiego is a trademark. Carmen Sandiego: to steal or not to steal is a film production from Netflix. We do not have the rights for this trademark and therefore we use it only for educational purposes. If you own this trademark and want us to remove this repository, send an email to us at joaorodriguesdiasneto@gmail.com.

We also use audio files found at YouTube.com. The links are listed below. If you own the copyrights for those and want us to remove from this repository, send an email to us at joaorodriguesdiasneto@gmail.com.

Carmen Sandiego Theme Song by Netflix: https://www.youtube.com/watch?v=ILTWNFH4F5g

Missions Soundtrack: https://www.youtube.com/playlist?list=PLUarXxb_U_N3oGSQFFyBpzcVnIGzdu_fQ

Install

Out-of-the-box, you'll need to install Python and Pygame and then clone this repository or click the blue shield at the top that says 'Open in Visual Studio Code' if you have VSCode installed.

Installing Python and Pygame

This project was created using Python v3.9.5 as programming language and Pygame as a gamming library for Python. You may use down to Python v3.6 but we strongly recommend a newer version. Python v3.5 or below is not supported since we use the f-string String Formatting Syntax available only on Python v3.6 and newer. We provide info as how to install Python on Windows and Ubuntu.

Windows

If you're on Windows, you can head to Python's download page to download an executable (.exe) for quick installation. Choose the latest version. Click here to download Python.

After installing Python, run the following command on your PowerShell or Terminal window to install Pygame only for the local user instead of globally:

python -m pip install -U pygame --user

Linux-based systems

We'll show how to download and install Python on Ubuntu OS. The instructions for other systems might be similar.

Install the deadsnakes PPA to get the latest Python available

$ sudo apt-get install software-properties-common
$ sudo add-apt-repository ppa:deadsnakes/ppa

Install Python 3.9

$ sudo apt-get update
$ sudo apt-get install python3.9

After installing Python, run the following command on your Terminal window to install Pygame only for the local user instead of globally:

python3 -m pip install -U pygame --user

Running this repository

Cloning or downloading the repository

Assuming you already have Git installed on your machine, you can clone this repository using the code below.

git clone https://github.com/joaodath/projetocarmen.git

You can also download this project using the green button at the top that says 'Code' and then clicking on 'Download ZIP'. Unzip the files and open the entire folder using your preferred IDE.

Running directly from terminal

On Ubuntu, navigate to the folder you cloned the repository. If you're following the instructions from the beginning, you'll have cloned the repo to the current folder you're on. If so, you can run this:

cd projetocarmen
python3 main.py

If you're not on the same folder you downloaded this repository, find it on your machine using cd on terminal or directly open a new terminal window from the folder. Then run:

python3 main.py

On Windows, navigate to the folder you cloned the repository. If you're following the instructions from the beginning, you'll have cloned the repo to the current folder you're on. If so, you can run this:

cd projetocarmen
python main.py

If you're not on the same folder you downloaded this repository, find it on your machine using cd on PowerShell or directly open a new PowerShell window from the folder. Then run: