🎮 Game Overview
Falling Stars Catcher is a vertical arcade game where reflexes and resource management are key. You control a basket at the bottom of the screen, scrambling to catch falling stars while dodging bombs. The game features a persistent progression system, meaning coins you collect can be spent on permanent upgrades to help you tackle harder worlds.
🕹️ Controls
The game is designed to be accessible on all devices with three control schemes:
-
Mouse (PC Recommended): simply move your cursor left or right. The basket follows your mouse position instantly. This offers the highest precision.
-
Keyboard:
-
Arrow Left / ‘A’: Move Left
-
Arrow Right / ‘D’: Move Right
-
-
Touch (Mobile/Tablet): Drag your finger anywhere on the game canvas to slide the basket.
-
UI Controls:
-
Pause: Top right button.
-
Fullscreen (⛶): Top right button (expands game to fit the whole monitor).
-
🌍 The Worlds (Levels)
There are 4 distinct worlds, each with unique visuals, difficulty scaling, and target scores required to unlock the next.
1. Sunny Fields ☀️
-
Theme: A bright blue sky over green grass.
-
Visuals: Yellow Stars, Dark Grey Bombs.
-
Difficulty: Easy.
-
Description: The training ground. Objects fall at a moderate pace, allowing you to learn the hitbox size and build your first combo chains.
-
Unlock Requirement: Default / Open.
-
Goal: Reach 200 Score to complete.
2. Neon City 🌃
-
Theme: A synth-wave aesthetic with a purple/night-blue gradient background.
-
Visuals: Cyan Neon Stars, Hot Pink Bombs.
-
Difficulty: Medium.
-
New Hazard: Moving Bombs. Unlike World 1, bombs here have a chance to drift horizontally, forcing you to predict their path rather than just standing still.
-
Goal: Reach 450 Score to complete.
3. Mystic Jungle 🌿
-
Theme: Deep forest greens.
-
Visuals: Pale Yellow Stars, Brown “Coconut” Bombs.
-
Difficulty: Hard.
-
Bonus: Higher spawn rate for coins, making it a good farming spot for upgrades.
-
Goal: Reach 800 Score to complete.
4. Galactic Ice ❄️
-
Theme: Deep space blue.
-
Visuals: White Stars, Bright Red Bombs.
-
Difficulty: Expert (Chaos Mode).
-
Mechanics:
-
Extreme Speed: Gravity is significantly higher here (
1.6xbase speed multiplier). -
High Density: Objects spawn much faster.
-
-
Goal: Reach 1300 Score to complete.
⭐ Items & Power-ups
Items fall from the top of the screen. You must catch the good ones and avoid the bad ones.
| Item | Visual | Effect |
| Star | ⭐ 5-pointed shape | +10 Points (plus combo bonus). Increases Combo count. |
| Coin | 🟡 Yellow Circle | +5 Coins. Used for purchasing upgrades. |
| Heart | ♥️ Red Heart | +1 Life. Very rare. Restores health up to a max of 5. |
| Shield | 🔵 Blue Ring | Invincibility. Protects you from exactly one bomb hit. |
| Bomb | ⚫ Round w/ fuse | -1 Life. Resets your Combo to zero. If you have a Shield, the shield breaks instead. |
🛠️ Upgrade System (The Shop)
You earn Coins by catching Stars (+1 coin) and Coin items (+5 coins). These persist even after Game Over. You can spend them in the Pause or Game Over menu on three permanent stats:
-
Basket Speed:
-
Effect: Makes your basket move faster (crucial for Keyboard players).
-
Cost: Starts at 50 coins.
-
-
Basket Size:
-
Effect: Widens your basket, making it significantly easier to catch stars without perfect precision.
-
Cost: Starts at 60 coins.
-
-
Star Magnet:
-
Effect: Creates a magnetic field around you. Stars and Coins that “almost” miss you are pulled into the basket automatically.
-
Cost: Starts at 70 coins.
-
💯 Scoring & Combo Mechanics
The secret to high scores is the Combo System:
-
Chain Catches: Every Star you catch adds +1 to your Combo counter.
-
The Bonus: You get extra points equal to
2 * Current Combo.-
Example: If your combo is 20, the next star gives you 10 (base) + 40 (bonus) = 50 points.
-
-
Combo Breakers:
-
Missing a Star: If a star hits the ground, your Combo resets to 0.
-
Hitting a Bomb: You lose a life AND your Combo resets to 0.
-
💾 Save System
The game uses localStorage to automatically save:
-
Your total Coins.
-
Your Upgrade Levels.
-
Your Unlocked Worlds.
-
Your High Score.
-
Mid-Run State: If you close the browser tab in the middle of a game, you can click “Continue” next time to resume exactly where you left off.
