Skip to content

borislav-dimov/Block-Pop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

3 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Block Pop ๐ŸŸฆ๐Ÿ’ฅ

Block Pop is a high-performance, modern block puzzle game built entirely in vanilla JavaScript and HTML5 Canvas. It features a polished "Classic" aesthetic, smart survival AI, haptic feedback, and a persistent account system.

โœจ Features

๐Ÿง  Smart AI Spawning: The game analyzes the board state. If you are close to losing, the RNG shifts to give you survivable blocks, ensuring skill matters more than luck. ๐Ÿ’พ Resume Capability: Close the tab? No problem. The game saves your exact state, score, and grid layout so you can resume later. โšก Neon Line Preview: Hovering over a valid spot lights up the rows/columns that will be cleared with a neon glow. ๐Ÿ“ณ Haptics & Sound: Synthesized audio effects and vibration feedback (on supported devices) for a tactile experience. ๐Ÿ† Local Leaderboard: Automatic tracking of personal best scores per account. ๐Ÿ› ๏ธ Developer Mode: A hidden menu to cheat scores, toggle AI debug hints, and more.

๐ŸŽฎ How to Play

Drag and Drop blocks from the tray onto the 8x8 grid. Fill Rows or Columns to clear them and earn points. Combo System: Clear multiple lines at once or in consecutive turns to trigger combo multipliers. Game Over: The game ends when there is no space left for the blocks in your tray.

๐Ÿคซ Hidden Developer Powers

Want to test high scores or see how the AI thinks? Open the Settings menu. Tap/Click on the "Settings" Title text 10 times. A hidden "Admin Powers" button will appear. Powers Include: God Mode (AI Hint): Shows the perfect move calculated by the computer. Score Editor: Set your score to whatever you want.

๐Ÿš€ Installation & Usage

This project is a Single File Application. It requires no build tools, no npm install, and no servers. To Play Locally: Download the index.html file. Double-click it to open in your browser. To Host (GitHub Pages): Fork this repository. Go to Settings -> Pages. Set the source to main branch. Your game is now live!

๐Ÿ’ป Tech Stack

HTML5 Canvas: For high-performance 60FPS rendering. Vanilla JavaScript (ES6+): Logic, state management, and audio synthesis. Local Storage: For saving accounts, settings, and game progress. Web Audio API: For generating sound effects on the fly (no assets to load).

๐Ÿ“„ License

Distributed under the MIT License. See LICENSE for more information.

About

Block Pop is a high-performance, modern block puzzle game built entirely in vanilla JavaScript and HTML5 Canvas. It features a polished "Classic" aesthetic, smart survival AI, haptic feedback, and a persistent account system.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages