Gemfall

CONTROLS: - Desktop: - Mouse Click / Left Mouse Button: Select gem, swap gems, interact with UI buttons and power-ups - Click First Gem: Select gem (highlighted with glow effect) - Click Adjacent Gem: Swap with selected gem if adjacent - Click Same Gem Again: Deselect gem - Click Different Non-Adjacent Gem: Change selection to new gem - Click Power-Up Button: Select power-up (highlighted in yellow), then click gem to use it - Mobile/Tablet: - Touch / Tap: Same as mouse click - select gems, swap, use power-ups, interact with UI BASIC MECHANICS: 1. Gem Selection: - Click a gem to select it (first click) - Selected gem scales up (1.15x) and glows with white glow filter - Visual highlight indicates selected gem - Click same gem again to deselect - Only one gem can be selected at a time 2. Gem Swapping: - Click an adjacent gem (horizontal or vertical neighbor) to swap - Gems must be adjacent (dx=1 and dy=0 OR dx=0 and dy=1) - Swapping animated with bouncy easing effect - Swap reverses if it doesn't create a match - Swap consumes a move only if it creates valid matches 3. Match Detection: - Matches require 3 or more gems of same type in a row (horizontal or vertical) - Horizontal matches checked left-to-right - Vertical matches checked top-to-bottom - Matches must share same type and special status - Multiple matches can occur simultaneously 4. Grid System: - 8x8 grid of gem cells (GRID_SIZE = 8) - Dynamic cell size based on screen dimensions (max 80px, calculated from screen) - Board offset from edges for centering - Grid initialized with random gems (no initial matches) 5. Gem Types: - Six gem types with different colors and shapes: - Type 0: Red Candy (circle shape, color 0xFF6B6B) - Type 1: Blue Candy (square shape, color 0x4ECDC4) - Type 2: Green Candy (triangle shape, color 0x45B7D1) - Type 3: Yellow Candy (star shape, color 0xFFA07A) - Type 4: Purple Candy (diamond shape, color 0x98D8C8) - Type 5: Orange Candy (hexagon shape, color 0xF7DC6F) 6. Gem Falling: - Matched gems removed from grid - Remaining gems fall down to fill empty spaces - New gems spawn from top to fill remaining empty cells - Falling animated with smooth transitions - Cascade effects continue until no more matches 7. Scoring System: - Score increases when matches are cleared - Each level has score goal requirement - Score displayed as "Score: X / Goal" - Score tracked throughout level - Higher scores from larger matches and combos 8. Moves System: - Limited moves per level (varies by level and mode) - Each valid swap consumes one move - Moves displayed as "Moves: X" - Level fails if moves run out before goal reached - Extra Moves power-up adds 5 moves 9. Level Progression: - 7 normal levels with increasing difficulty: - Level 1: 25 moves, 500 score goal - Level 2: 20 moves, 800 score goal - Level 3: 18 moves, 1200 score goal, special gems enabled - Level 4: 15 moves, 1500 score goal, special gems enabled - Level 5: 12 moves, 2000 score goal, special gems enabled - Level 6: 10 moves, 2500 score goal, special gems enabled - Level 7: 8 moves, 3000 score goal, special gems enabled - Progress to next level after completing goal 10. Game Modes: - Normal Mode: Classic level progression through 7 levels - Endless Mode: Infinite challenge, difficulty increases per level (15+ moves, 1000+ score goal) - Time Attack Mode: 60-second time limit, unlimited moves, 2000 score goal - Zen Mode: Relaxed play, unlimited moves, no time limit, 500 score goal, no special gems - Puzzle Mode: Brain teasers, 10 moves, 1500 score goal, special gems enabled - Boss Battle Mode: Epic challenges, 8 moves, 3000 score goal, boss health system 11. Power-Up System: - Five power-ups available: - Hammer (100 coins): Remove any single gem - Bomb (150 coins): Clear 3x3 area around gem - Color Bomb (200 coins): Clear all gems of selected color - Extra Moves (300 coins): Add 5 moves to current count - Shuffle (250 coins): Shuffle all gems on board - Power-ups displayed as buttons at bottom - Click power-up button to select, then click gem to use - Power-ups consumed on use - Power-ups can be purchased with coins if none owned 12. Special Gems: - Special gems created from large matches (4+ or 5+ gems) - Special gem types include: - Striped gems (horizontal or vertical) - Wrapped gems (bomb-like) - Rainbow gems (color bomb) - Special gems have enhanced clearing effects - Special gems enabled from level 3+ in Normal mode 13. Gem Evolution: - Gems can evolve into enhanced versions: - Red → Fire Gem (color 0xFF4500, power 2x size) - Blue → Ice Gem (color 0x00BFFF, power 2x size) - Green → Nature Gem (color 0x32CD32, power 2x size) - Yellow → Lightning Gem (color 0xFFD700, power 2x size) - Purple → Cosmic Gem (color 0x8A2BE2, power 2x size) - Pink → Crystal Gem (color 0xFF69B4, power 2x size) - Evolved gems are larger and more powerful 14. Coin Economy: - Coins earned from gameplay (matching, achievements, daily challenges) - Coins used to purchase power-ups - Coins displayed in center top as "💰 X" - Power-up usage grants coins (Hammer: +10, Bomb: +20, Color Bomb: +cleared*2, Shuffle: +15) - Coins persist between games 15. Combo System: - Chain reactions from falling gems create combos - Higher combos increase score multipliers - Combo counter tracks consecutive matches - Combos rewarded with bonus points - Combo streaks add to score 16. Animation System: - Gem swap animated with bouncy easing (bounceOut function) - Gem fall animated smoothly - Scale effects during swaps (1 + 0.1 * sin animation) - Particle effects on gem destruction - Sparkle effects around board edges - Smooth transitions for all actions 17. Sound System: - Sound effects for gem swaps - Sound effects for matches - Sound effects for special actions - Background music varies by game state - Audio context managed for browser compatibility 18. Visual Effects: - Glow filters on selected gems - Particle systems for gem destruction - Board sparkles for visual appeal - Gradient backgrounds - Colorful gem designs with highlights and shadows - Candy Crush-style visual polish 19. Achievement System: - Achievements tracked for various milestones - Power-up usage tracked - Special gem creation tracked - First match achievement - Various gameplay achievements unlock rewards 20. Daily Challenges: - Three daily challenges available - Challenges include: - Score Master: Score 1000 points in single game - Match Maker: Make 20 matches in single game - Special Gems: Create 3 special gems - And more... - Rewards coins upon completion - Challenges reset daily 21. Streak System: - Daily play streak tracked - Consecutive day streaks grant bonus coins - Streak bonus: streak * 50 coins - Streak displayed with reward notification - Streak resets if day missed 22. Boss Battle Mechanics: - Boss health bar displayed (max 1000 HP) - Boss health decreases when matches made - Defeat boss to complete level - Enhanced challenge with limited moves 23. Time Attack Mechanics: - 60-second countdown timer - Timer displayed prominently - Game over when time reaches 0 - Score 2000 points before time runs out - Unlimited moves available 24. UI Elements: - Level display (top center) - Score display (top left) - Moves display (top right) - Coins display (top center) - Power-up buttons (bottom) - Back button (top left corner) - Mode-specific UI (timer, boss health, etc.) 25. Board Layout: - Colorful gradient board background - Multiple layered backgrounds for depth - Grid lines for clarity - Rounded corners on board - Shadow effects for depth - Board centered on screen with dynamic sizing STRATEGIC TIPS: - Plan Matches: Look ahead before swapping. Plan matches that create cascades and chain reactions for higher scores. - Adjacent Swaps Only: Remember gems must be adjacent (horizontally or vertically) to swap. Diagonal swaps are not possible. - Special Gem Creation: Create matches of 4+ or 5+ gems to generate special gems. Special gems clear more gems and increase scores significantly. - Power-Up Management: Save power-ups for difficult situations. Use Hammer for blocking gems, Bomb for tight clusters, Color Bomb for color domination. - Combo Building: Set up matches that trigger cascades. Falling gems often create new matches automatically. - Move Conservation: Plan efficient moves. Each swap costs a move, so make swaps that create multiple matches. - Board Observation: Scan entire board before selecting. Look for best match opportunities and cascade potential. - Color Strategy: Focus on removing dominant colors when blocked. Use Color Bomb on common colors. - End Game Planning: When moves are low, prioritize moves that definitely create matches. Avoid risky swaps near game end. - Shuffle Timing: Use Shuffle power-up when board has no obvious matches. Can create new opportunities. ADVANCED TECHNIQUES: - Cascade Planning: Plan matches that trigger multiple cascades. Position gems so falling creates new matches automatically. - Special Gem Placement: Create special gems near each other. Combining special gems creates massive clearing effects. - Block Clearing: Use Hammer strategically to remove blocking gems that prevent matches. - Bomb Timing: Use Bomb power-up on dense clusters. 3x3 clearing can trigger cascades. - Color Bomb Optimization: Use Color Bomb on most common color on board. Maximum gem clearing effect. - Combo Maximization: Build matches that set up chain reactions. Higher combos equal higher scores. - Move Efficiency: Calculate move efficiency. Aim for matches that clear 6+ gems per move. - Pattern Recognition: Learn common match patterns. Identify T-shapes, L-shapes, and straight lines quickly. - Power-Up Combinations: Combine power-ups strategically. Use Shuffle then Color Bomb for maximum effect. - Time Attack Strategy: In Time Attack mode, prioritize fast matches over perfect planning. Speed matters more than optimization. WINNING AND PROGRESSION: - Level Completion: Complete score goals within move limits to advance levels. Each level unlocks next challenge. - Score Achievement: Reach required score goals for each level. Higher scores from combos and special gems. - Move Management: Complete levels with moves remaining. Efficient play conserves moves for harder levels. - Mode Mastery: Master all game modes. Each mode offers different challenges and strategies. - Achievement Unlocking: Unlock achievements through gameplay. Achievements provide rewards and progression tracking. - Daily Challenge Completion: Complete daily challenges for bonus coins. Regular play maximizes coin earnings. - Streak Maintenance: Maintain daily play streaks for bonus rewards. Consistent play maximizes coin income. - Power-Up Mastery: Learn effective power-up usage. Strategic power-ups enable level completion. - Special Gem Expertise: Master creating and using special gems. Special gems essential for higher levels. - Endless Progression: Progress through endless levels. Each level increases difficulty and rewards. - Boss Defeat: Defeat boss battles by reducing boss health to zero. Boss battles require efficient matching. - Time Attack Success: Complete Time Attack mode within 60 seconds. Speed and accuracy required. - Coin Economy: Build coin reserves for power-up purchases. Strategic coin usage enables difficult level completion. - Perfect Levels: Complete levels with many moves remaining. Perfect play demonstrates mastery. - High Score Achievement: Achieve maximum scores through combos and special gems. High scores demonstrate skill. Enjoy matching gems and progressing through levels in Gemfall!