An open API service indexing awesome lists of open source software.

https://github.com/devarajan8/balloon-rise-up

Balloon Rise Up is an engaging game developed in the Jack programming language, a core component of the Nand2Tetris course. Players navigate a balloon through dynamically generated obstacles, testing their reflexes and precision. The goal is to keep the balloon rising while avoiding collisions, offering a challenging and entertaining experience.
https://github.com/devarajan8/balloon-rise-up

jack

Last synced: 5 months ago
JSON representation

Balloon Rise Up is an engaging game developed in the Jack programming language, a core component of the Nand2Tetris course. Players navigate a balloon through dynamically generated obstacles, testing their reflexes and precision. The goal is to keep the balloon rising while avoiding collisions, offering a challenging and entertaining experience.

Awesome Lists containing this project

README

          

# Balloon Rise Up

Balloon Rise Up is an engaging game written in the Jack programming language. The objective of the game is to navigate a balloon through a series of obstacles and keep it rising up without colliding.

## Project Description
Balloon Rise Up is a fun and challenging game where players must maneuver a balloon to avoid various obstacles. The game is designed to test your reflexes and timing as you strive to achieve the highest score possible.

### Features
- Control a balloon and navigate through obstacles.
- Dynamic obstacle generation.
- Collision detection to make the game challenging and engaging.
- Score tracking to keep track of your high scores.

## Installation
To get started with the Balloon Rise Up game, follow these steps:

1. **Clone the Repository**
```sh
git clone https://github.com/DevaRajan8/Balloon-Rise-Up.git
2. **Navigate to the source directory**
```sh
cd Balloon-Rise-Up/src

### Compile the Jack Files

Use the Jack compiler to compile the `.jack` files. You can use the Jack tools provided by your development environment or the [Nand2Tetris software suite](https://www.nand2tetris.org/software).

If you are using the Nand2Tetris tools, follow these steps:

1. **Download the Nand2Tetris software suite from [here](https://www.nand2tetris.org/software).**
2. **Extract the downloaded files to a directory on your computer.**
3. **Open a terminal and navigate to the directory where you extracted the Nand2Tetris tools.**
4. **Run the JackCompiler on the `src` directory:**
```sh

tools/JackCompiler.sh path/to/balloon-rise-up/src

### Usage

To play the game, follow these instructions:

1. **Objective**
- Keep the balloon rising without colliding with the obstacles. The game ends when a collision occurs.

2. **Start the Game**
- Run the compiled game on the Jack Virtual Machine Emulator

If you are using the Nand2Tetris tools, follow these steps:
- Open the VM Emulator from the Nand2Tetris tools.
- Load the compiled `.vm` files located in the `src` directory.
- Start the VM Emulator to run the game.

3. **Control the Balloon**
- Use the left and right arrow keys to move the balloon and avoid obstacles.

4. **Application Screenshots:**

- **Start Screen:**

- ![WhatsApp Image 2024-06-02 at 15 48 47_188e8180](https://github.com/DevaRajan8/Balloon-Rise-Up/assets/153832931/6b24babd-9195-492d-ae55-60e8954cd1c6)
)

- **Gameplay Screen:**

- ![WhatsApp Image 2024-06-02 at 15 49 00_6b6aaa7e](https://github.com/DevaRajan8/Balloon-Rise-Up/assets/153832931/f5e988ca-6a6a-4e45-a4fe-09725201bbee)

- **Balloon Collision Screen:**

- ![WhatsApp Image 2024-06-02 at 15 49 12_90953f86](https://github.com/DevaRajan8/Balloon-Rise-Up/assets/153832931/9b0f783d-eb41-4df9-b570-0448dd39072b)

### License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

### Acknowledgments

Thank you for utilizing the Balloon Rise Up game project! We hope you enjoy playing it and find it both challenging and entertaining.

### Contact

For any inquiries or feedback, feel free to contact us:

- sharukesh@gmail.com
- shayanathif13@gmail.com
- rdeva6046@gmail.com
- p8001479@gmail.com