Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/souvik-basak/bubble_game


https://github.com/souvik-basak/bubble_game

Last synced: about 20 hours ago
JSON representation

Awesome Lists containing this project

README

        

# Bubble Pop Game 🫧

Welcome to the Bubble Pop Game repository! This is a simple and entertaining web-based game where your goal is to pop as many bubbles as you can within a limited amount of time. The game is built using HTML, CSS, and JavaScript, and it's a great way to challenge your reflexes and have some fun. The twist is that each bubble has a random number associated with it, and you can only score when the number matches the target number.

## Table of Contents

- [Demo](#demo)
- [Features](#features)
- [Getting Started](#getting-started)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [How to Play](#how-to-play)
- [Technologies Used](#technologies-used)
- [Gameplay](#gameplay)
- [Scoring](#scoring)
- [Game Over](#game-over)
- [Contribution](#contribution)
- [License](#license)

## Demo

Check out the live demo of the Bubble Pop Game [here](https://souvik-basak.github.io/Bubble_Game/).

## Features

- Simple and intuitive gameplay.
- Engaging bubble-popping mechanics.
- Timer-based challenge to test your speed and accuracy.
- Real-time scoring system.
- Randomly generated numbers for each bubble to keep the game dynamic.
- Matching the number of bubbles to the target number earns you points.

## Getting Started

### Prerequisites

Before you begin, ensure you have the following prerequisites:

- Web browser (Google Chrome, Mozilla Firefox, Safari, etc.)
- Text editor or integrated development environment (IDE) of your choice.

### Installation

1. Clone the repository to your local machine using the following command:

```bash
git clone https://github.com/souvik-basak/Bubble_Game.git

2. Navigate to the project directory:

```bash
cd Bubble_Game

3. Open the `index.html` file in your preferred web browser or set up a local development server.

### Technologies Used

- HTML5 for structuring the game layout.
- CSS3 for styling the user interface.
- JavaScript for game logic and interactivity.

### How to Play

- Launch the game by opening the `index.html` file.
- As soon as the game starts, bubbles will begin to appear on the screen.
- Click or tap on the bubbles to pop them.
- Also you have to match the number on the bubble to the target number to earn a score.
- The game lasts for a specified duration (e.g., 60 seconds), so try to pop as many bubbles as you can before the timer runs out.

### Gameplay

- The gameplay is simple and enjoyable:
- When the game starts, bubbles will begin to appear on the screen, each containing a random number.
- A target number will be displayed at the top of the screen. Your goal is to pop bubbles in a way that their number matches the target number.
- Click on bubbles to pop them. The popped bubble number will be compared to the target number.
- If the number matches the target number, you'll earn points based on the number of bubbles popped.
- Keep popping bubbles and scoring points until the timer runs out.

### Scoring

Each bubble popped adds points to your score.
The faster you pop a bubble after it appears, the more points you'll earn.

### Game Over

The game ends when the timer reaches zero.
At this point, you can see your final score and try to beat it in the next round!

### Contribution

If you're interested in contributing to the Bubble Pop Game project, feel free to fork the repository, make improvements or fix bugs, and submit a pull request. Contributions are always welcome!

### License

This project is licensed under the MIT License, which means you're free to use, modify, and distribute the code as you see fit.

Enjoy the Bubble Pop Game and have a blast improving your interactivity while popping bubbles! If you encounter any issues or have suggestions, feel free to open an issue on the repository. Happy gaming! 🎈🎮