Cool Puzzle — Full Game Description

Overview

Cool Puzzle is a fully offline, single-player jigsaw puzzle game built as a desktop app. Players assemble scattered pieces into a complete image on a free-form board. It features a polished AAA-style UI with animated menus, particle effects, procedural audio, and multiple game modes.

Game Modes

• Classic Mode — Relaxed, self-paced puzzling with an optional timer. No pressure, just enjoyment.

• Speed Mode — Race against the clock. Placing pieces quickly builds combo multipliers that boost your score.

• Daily Challenge — A fresh puzzle is generated every day. Complete it for leaderboard glory.

Puzzle Selection

• 36 built-in puzzle images stored in the 

   
  Puzzles/ folder.

   

• Custom image upload — players can add their own photos (JPEG, PNG, WebP, GIF) which are saved locally via IndexedDB.

• Gallery screen with search, sort (name, recent, custom), and card hover effects.

• Eye preview button on each card — click to open a full-screen lightbox showing the complete image and its name before committing to play. A "Play This Puzzle" button launches directly from the preview.

Puzzle Mechanics

• Piece counts: 16, 48, 100, 200, 500, or 1000 pieces (slider + presets).

• Rotation toggle — pieces can start at random angles, adding difficulty.

• Snap-to-grid — pieces snap together when dropped close enough to a correct neighbour. Snapped pieces merge into a draggable group.

• Magnet setting — controls the snap detection radius (Low / Medium / High).

• Free-form board — pan and zoom the canvas freely; pieces scatter outside the board edges initially.

• Side tray — a scrollable panel holds unplaced pieces for easy access.

Controls

Scoring

• +100 points per correct snap.

• Combo multiplier — consecutive snaps within ~3 seconds stack the multiplier higher.

• Speed bonus — faster completions score higher.

• Best time, best score, and total pieces placed are saved to LocalStorage and shown on the main menu stats bar.

Win Sequence

1. The completed puzzle assembles with a smooth animation.

2. The full puzzle image is displayed — player must tap "Continue to Results" to proceed.

3. A win card appears showing Time, Pieces, and Score with confetti and celebration effects.

4. Options: Play Again, New Puzzle, or Main Menu.

UI & Presentation

• Dark space theme by default with CSS variable theming (light and space variants available).

• Animated particle background on the main menu.

• Glass-panel modals with blur backdrops.

• Procedural Web Audio API sound effects — no external audio files needed. Includes: snap, combo snap, pickup, place, win fanfare, button clicks, hover tones, countdown ticks.

• Mute button in the nav bar.

• Settings panel in-game for volume, zoom, magnet strength, rotation, and piece count.

Player Utilities

• Clear Stats button on the main menu footer — resets all stats for a new player (with confirmation).

• How to Play modal — detailed in-game guide covering controls, snapping, scoring, modes, and settings.

• Save & Resume — puzzle progress is auto-saved to IndexedDB and can be resumed.

• Leaderboard — daily challenge scores stored locally.

Technical

• Pure HTML/CSS/JavaScript — no frameworks, fully offline.

• Packaged as a portable Windows EXE via Electron (dist/CoolPuzzle-Portable.exe) — no installation required, no registry writes.

• Launches fullscreen automatically.

• All puzzle images, audio, and game logic are self-contained.