https://github.com/remarkablegames/bubble-gun

💦 🔫 Shoot bubbles at enemies!
https://github.com/remarkablegames/bubble-gun

arcade bubble game global-game-jam html javascript kaplay kaplayjs remarkablegames typescript web website

Last synced: 9 days ago
JSON representation

💦 🔫 Shoot bubbles at enemies!

• Host: GitHub
• URL: https://github.com/remarkablegames/bubble-gun
• Owner: remarkablegames
• License: mit
• Created: 2025-01-21T01:53:12.000Z (23 days ago)
• Default Branch: master
• Last Pushed: 2025-01-26T18:14:35.000Z (17 days ago)
• Last Synced: 2025-01-26T18:32:29.670Z (17 days ago)
• Topics: arcade, bubble, game, global-game-jam, html, javascript, kaplay, kaplayjs, remarkablegames, typescript, web, website
• Language: TypeScript
• Homepage: http://remarkablegames.org/bubble-gun/
• Size: 5.17 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        


  



# Bubble Gun

![release](https://img.shields.io/github/v/release/remarkablegames/bubble-gun)

[![build](https://github.com/remarkablegames/bubble-gun/actions/workflows/build.yml/badge.svg)](https://github.com/remarkablegames/bubble-gun/actions/workflows/build.yml)

Bubble Gun is a top-down survival game where you shoot bubbles at enemies.

This game was made for [Global Game Jam 2025](https://globalgamejam.org/games/2025/kiki-and-boba-4), in which the theme was `Bubble`. The game was bootstrapped from [`kaplay-template`](https://github.com/remarkablegames/kaplay-template). Read the [blog post](https://remarkablegames.org/posts/bubble-gun/).

Play the game on:

- [remarkablegames](https://remarkablegames.org/bubble-gun)

- [itch.io](https://remarkablegames.itch.io/bubble-gun)

- [newgrounds](https://www.newgrounds.com/portal/view/966187)

## How to Play

- Move with WASD or arrow keys

- Left-click to shoot a bubble

- Shoot bubbles at enemies

- Enemies in a bubble will fall down the drain

- Avoid enemies and projectiles

- Choose a reward when you reach a certain score

## Credits

- KitB@sh - Artist, Composer ([SoundCloud](https://soundcloud.com/k1tb4sh), [YouTube](https://www.youtube.com/@kitbash52))

- remarkablemark - Programmer ([GitHub](https://github.com/remarkablemark))

## Install

Clone the repository:

```sh

git clone https://github.com/remarkablegames/bubble-gun.git

cd bubble-gun

```

Install the dependencies:

```sh

npm install

```

Update the environment variables:

```sh

cp .env .env.local

```

## Available Scripts

In the project directory, you can run:

### `npm start`

Runs the game in the development mode.

Open [http://localhost:5173](http://localhost:5173) to view it in the browser.

The page will reload if you make edits.

You will also see any errors in the console.

### `npm run build`

Builds the game for production to the `dist` folder.

It correctly bundles in production mode and optimizes the build for the best performance.

The build is minified and the filenames include the hashes.

Your game is ready to be deployed!

### `npm run bundle`

Builds the game and packages it into a Zip file in the `dist` folder.

Your game can be uploaded to your server, [Itch.io](https://itch.io/), [Newgrounds](https://www.newgrounds.com/), etc.

## License

[MIT](LICENSE)