Bubble Shooter - Classic Match-3 Puzzle Game

Seele01-Flash
By
Bubble Shooter is the ultimate casual puzzle game that combines simple match-3 mechanics with addictive gameplay. Aim your bubble cannon, match colorful bubbles, and clear the board in this timeless classic that's perfect for players of all ages.

Prompt

MODEL: Seele01-Flash
Please use Three.js to generate a **mobile-first game** with the theme "**Bubble Shooter 3D**". Please read the following detailed game design requirements first, and then generate the code accordingly: ### 1. Assets & Environment * **Visual Style**: "Glossy Candy" aesthetic. The game should use a fixed orthographic camera to simulate a 2D plane but render 3D assets. * **Bubble Models**: Use 3D spheres (`THREE.SphereGeometry`) with a `MeshPhysicalMaterial`. High shininess/specular highlights to mimic the glossy look in the reference image. * **Color Palette**: High saturation colors (Red, Lime Green, Bright Blue, Hot Pink, Yellow, Cyan). Background should be a calming, low-saturation Lavender/Light Purple to contrast with the bubbles. * **Particle Effects**: When bubbles match and pop, spawn a small burst of particles (simple 2D planes or small spheres) in the corresponding color before disappearing. * **Performance Optimization**: **Crucial**: Use `THREE.InstancedMesh` for the bubble grid to render hundreds of bubbles efficiently on mobile devices. Limit geometry segments to 16 or 24 to save battery. ### 2. Audio Requirements * **BGM**: A relaxing, looping "Elevator Bossa Nova" or light Marimba track. Cheerful but not distracting. * **Sound Effects (SFX)**: * *Shoot*: A quick "Whoosh" or air-compression sound. * *Impact*: A soft plastic "Thud" when hitting the wall or stack without popping. * *Pop*: A satisfying, high-pitched "Plop" or bubble wrap burst sound. * *Cluster Drop*: A cascading chime sound when disconnected bubbles fall. * *Warning*: A low-frequency pulse sound when bubbles reach the "danger line". ### 3. Gameplay Loop * **Grid System**: Implement a **Hexagonal Grid** (staggered rows) layout. The bubbles must nestle between each other, not sit directly on top. * **Shooting Mechanic**: The player launches a bubble from the bottom center. It must travel in a straight line with constant velocity. * **Wall Reflection**: The bubble must bounce off the left and right vertical walls (calculate reflection vector). It sticks when colliding with another bubble or the top ceiling. * **Matching Logic**: Upon collision, run a Flood Fill (DFS/BFS) algorithm. If 3 or more bubbles of the same color are connected, destroy them. * **Floating Cluster Logic**: After a match, check for "floating islands" (bubbles not connected to the ceiling). These must fall off the screen and award extra points. * **Ceiling Drop**: Implement a "Foul Counter". After 5 shots that do not result in a pop, add a new row of bubbles at the top and push the entire grid down. * **Game Over**: If any bubble crosses a defined Y-threshold near the shooter, the game ends. ### 4. Mobile Controls & Interaction * **Control Scheme**: **"Drag-to-Aim, Release-to-Shoot"**. * Touching and dragging anywhere on the screen rotates the cannon/aim. * Releasing the touch fires the bubble. * *Note*: This is superior to "Tap to shoot" for precise bank shots on mobile. * **Trajectory Guide**: Render a dotted line (using `THREE.Line` or small sprites) that shows the aiming path, including the first bounce off a wall. This helps players plan shots on small screens. * **Orientation**: Portrait mode locked. The camera must resize dynamically (`renderer.setSize`) to fit different mobile aspect ratios without distorting the spheres. * **Haptic Feedback**: Trigger `navigator.vibrate(50)` on a successful match/pop for tactile gratification. * **UI Layout**: Score display at the top left. High Score at top right. Ensure UI buttons are at least 44x44px for touch accessibility. Do not ask for clarification. Do not request confirmation. Directly execute the generation task based on the given instructions.

Game Introduction

About the Game

Bubble Shooter is one of the most beloved casual puzzle games worldwide, offering a perfect blend of relaxation and strategic challenge. This colorful match-3 game puts you in control of a bubble cannon at the bottom of the screen, tasked with clearing clusters of vibrant bubbles by creating matches of three or more identical colors.

What starts as a simple, relaxing experience quickly evolves into a strategic challenge as you progress through increasingly complex bubble formations. The game's addictive nature lies in its perfect balance - easy to learn but difficult to master, making it impossible to put down once you start playing.

Core Features

Classic Match-3 Gameplay

The game follows tried-and-true match-3 mechanics that have captivated players for decades. Simply aim your colored bubble at matching bubbles on the board to create clusters of three or more, causing them to burst and disappear.

Progressive Challenge System

  • Easy Start : Begin with simple patterns and plenty of space
  • Increasing Difficulty : Face more complex bubble arrangements as you advance
  • Strategic Depth : Plan multiple moves ahead for maximum efficiency
  • Time Pressure : Avoid ceiling collapses by making smart moves quickly

Rewarding Point System

Every bubble you pop earns points, but strategic plays yield higher rewards: - Simple matches provide basic points - Chain reactions and hanging bubble eliminations offer bonus scores - Fewer shots and faster completion increase your final score - Wasted shots count against you, adding tactical pressure

Visual and Audio Excellence

  • Colorful Graphics : Bright, cheerful bubbles that are easy to distinguish
  • Smooth Animations : Satisfying bubble-popping effects
  • Pleasant Sound Effects : Audio feedback that enhances the gaming experience
  • Clean Interface : Intuitive design that focuses on gameplay

Game Mechanics

Strategic Elements

Success in Bubble Shooter requires more than quick reflexes:

Hanging Bubble Strategy : Target support bubbles that hold up entire clusters. Remove one strategic bubble to trigger massive chain reactions.

Wall Banking : Use the side walls to ricochet bubbles into hard-to-reach spots and create unexpected matches.

Color Management : Avoid creating scattered single bubbles that make future matches difficult.

Next Bubble Preview : Plan your moves using the preview of your next bubble color.

Pressure Management

The game adds tension through its ceiling descent mechanic. After five missed shots, a new row drops from the top, reducing your playing space and increasing pressure. Master accurate shooting to maintain control.

Controls and Accessibility

Simple Controls

  • Desktop : Move mouse to aim, left-click to shoot
  • Mobile : Tap to aim and shoot
  • Universal : Works seamlessly across all devices

Cross-Platform Compatibility

  • Web Browser : Play instantly on any modern browser
  • Mobile Devices : Optimized for iOS and Android
  • No Download Required : Start playing immediately
  • Progress Saving : Your high scores are remembered between sessions

Why Play Bubble Shooter?

Perfect for Any Moment

Bubble Shooter excels as both a quick distraction and an extended gaming session. Its pick-up-and-play nature makes it ideal for: - Short breaks during work or study - Commuting and travel entertainment - Relaxing evening gameplay - Casual social gaming

Cognitive Benefits

  • Strategic Thinking : Plan multiple moves ahead
  • Pattern Recognition : Identify optimal bubble clusters
  • Hand-Eye Coordination : Improve aiming precision
  • Stress Relief : Enjoy meditative, focused gameplay

Timeless Appeal

With roots tracing back to arcade classics, Bubble Shooter has proven its staying power. The game offers thousands of potential level variations, ensuring fresh challenges every time you play.

Game Tips for Success

  1. Prioritize Hanging Bubbles : Look for bubbles that support large clusters below them
  2. Use Bank Shots : Bounce bubbles off walls to reach difficult spots
  3. Manage Colors Carefully : Avoid scattering single bubbles across the board
  4. Plan Ahead : Use the next bubble preview to strategize your moves
  5. Control the Ceiling : Keep missed shots to a minimum to prevent premature ceiling drops
  6. Focus on Clusters : Target areas where you can create the biggest chain reactions

Frequently Asked Questions (FAQ)