
Bubble Cat is a free browser bubble shooter inspired by the classic Puzzle Bobble (Bust-a-Move) and the Warriors cat novels. Pick a warrior cat, then face off against an AI opponent as you both shoot bubbles on your own boards at the same time. Match bubbles of the same color to pop them, and send penalty cards to disrupt your rival. No download needed, and it plays best in a desktop browser. Bubble Cat is a non-commercial fan game, independently designed and developed.

How to Play
- Choose a warrior cat. Each character has its own bubble color set.
- Special bubbles have unique powers and effects.
- Use the Left/Right arrow keys to aim and the Spacebar to shoot.
- Connect 3 or more bubbles of the same color to pop them. Any bubbles left hanging fall with them.
- Every 5 bubbles you pop sends a yellow penalty card to your opponent.
- Win by making your opponent’s bubbles reach the bottom line first.
Bubble Types & Special Effects
- Standard color bubbles: four colors, one for each of the four Clans in the novels
- Star bubbles: inspired by StarClan. Clears every bubble on the board that matches the color of the bubble you shot.
- Red bubbles: inspired by BloodClan. Clears an entire horizontal row, regardless of color.
- Black clear-all bubbles: inspired by the Dark Forest. Wipes every bubble off the board at once.
- Fixed blocker tiles: inspired by rogues and villain cats. Colorless bubbles or blocks that no bubble can remove.


Card Penalties & AI Battles
- Every 5 bubbles you pop sends 1 yellow card to your opponent
- 3 yellow cards upgrade to a red card, and 3 red cards upgrade to a purple card
- Cards change your opponent’s board, raising the pressure as the match goes on
- The AI plays in parallel on its own board, and opponents get harder in later rounds
Warrior Cat Characters
- Cats from each Clan, with personalities including brave, curious, calm, determined, and mysterious
- Live preview of each character’s bubble colors on the select screen
- 3D-style artwork, with your cat displayed large over your board during battles
- Forest backgrounds that echo each Clan’s home territory


Technical Implementation
- Custom physics engine: shot trajectories, wall bounces, grid snapping, and gravity drop for hanging bubbles
- BFS/DFS group detection and chain clearing
- Real-time dual-board rendering: player on the left, AI on the right
- Web Audio API music and sound effects that keep playing smoothly between screens
- Modular architecture with game logic, UI state, physics, and audio kept separate
- Zero-backend static deployment. Open the URL and start playing.








