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: 4 months 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 (9 months ago)
- Default Branch: master
- Last Pushed: 2025-03-20T19:09:38.000Z (7 months ago)
- Last Synced: 2025-03-20T20:43:35.415Z (7 months 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: 7.1 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Bubble Gun
[](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), which the theme was **Bubble**.
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)
Read the [blog post](https://remarkablegames.org/posts/bubble-gun/).
## 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](https://soundcloud.com/k1tb4sh) - Artist, Composer ([YouTube](https://www.youtube.com/@kitbash52))
- [remarkablemark](https://github.com/remarkablemark) - Programmer
## 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)