A complete, production-ready HTML5 water-sort puzzle game built for commercial distribution. Zero external JavaScript dependencies. Runs on any modern browser straight from a static file host with no build step required.
Pour Party is a color-sort bottle puzzle: tap a bottle to lift it, tap another to pour, and sort every color into its own bottle to clear the board. The game bundles three play modes on one shared bottle-pouring engine — Sort Color Puzzle, Combo Pour, and Twin Flow — each with its own set of 100 hand-verified levels across Easy, Medium, and Hard, plus its own seeded Daily Challenge. The game features five selectable board themes (each with its own fixed background image), four bottle skins, an optional Cartoonic Mode visual style, a shared XP progression system with seven rank tiers, a per-mode/per-difficulty local best-times leaderboard, an eight-achievement system, an unlimited in-game hint, and a full sponsor/ad integration framework — all in a single self-contained HTML5 package.
index.html — no build step, no CLI tools, no package manager requiredscripts/js/game.jsscripts/js/levels.js — every board is a genuinely mixed random deal, independently verified solvable by an A* water-sort solver before being included, so no two modes ever repeat the same boardscripts/css/style.css; sponsor/ad placeholder in scripts/sponsor/sponsor-placeholder.htmlscripts/config/ads.jsscripts/images/bg-amber.webp, bg-jungle.webp, bg-obsidian.webp, bg-midnight.webp, bg-crimson.webp) and one favicon (favicon.jpg)localStorage with graceful degradation when storage is unavailableThe mode is chosen right after the lobby, on its own dedicated “Choose a Mode” screen, before difficulty. All three modes share the same bottle-pouring rules and level structure — only the scoring twist changes.
Each mode has its own independent set of 300 levels (100 Easy + 100 Medium + 100 Hard) and its own separate level-progress save, so playing through one mode’s levels does not unlock or affect another mode’s levels.
Each of the three modes has its own Easy / Medium / Hard level select screen, 100 fixed levels per tier, unlocked in order as you clear them (15 levels per page, with pagination).
Five board themes are selectable from the “Board · Style” screen, shared across all three modes. Each theme owns one fixed background image — there is no separate background picker. The active theme is saved to localStorage and restored on every visit. The default theme is Amber.
A separate Cartoonic Mode toggle (Settings → Appearance) can be layered on top of any theme — it adds chunky sticker-style borders and a playful rounded font to the UI without changing any theme’s colors. It is on by default for first-time players and is saved to localStorage.
A dedicated Bottle Skins screen (reached from the lobby) lets players pick how the bottles themselves look, independent of the board theme. The choice is saved to localStorage.
The left-side action sidebar in every mode offers:
There is no numpad and no on-screen “Check” button in these modes — the win condition is detected automatically the moment every bottle is sorted. The only keyboard shortcut is Esc, which opens or closes the pause popup; pouring, undo, and reset are tap/click-only.
All three modes award XP toward one shared rank system using the same formula: a base amount per difficulty, plus a bonus for finishing with zero mistakes, plus a bonus for finishing under the par time for that difficulty. Both bonus amounts and all base/par values are configurable.
The seven rank tiers:
The current rank and progress toward the next tier are shown as an XP bar in the Stats popup, opened from the lobby’s Stats icon.
Eight achievements are tracked and shown as badges in the Stats popup (lobby → Stats icon). Once more than 3 are unlocked, a “See All Achievements” button opens a full Achievements page for the rest:
All three modes count equally toward these achievements and toward the games-played, best-time, and streak stats shown in the Stats popup. The Streak stat increases by one with every puzzle completed and is not reset by a loss or a missed day — despite the “Day Streak” naming, it is a running completed-puzzle count rather than a calendar-day check.
Because an invalid pour attempt only shakes the bottle and does not count as a mistake, the Mistakes stat for these modes always reads zero — so the zero-mistake XP bonus and the Perfect Solve achievement are effectively earned on every completed puzzle.
A local leaderboard is accessible from the lobby, with tabs for each of the three modes, and Easy / Medium / Hard tabs within each (up to 10 entries per tab by default, configurable). Each entry records time, mistake count, and date. Sort Color Puzzle ranks fastest time first; Combo Pour ranks highest combo bonus first; Twin Flow ranks highest twin bonus first. Daily Challenge wins are recorded under that mode’s Medium tab. The leaderboard can be cleared from its own screen.
All settings are accessible from the lobby settings button. The board Theme, Bottle Skin, and the Cartoonic Mode toggle are saved to localStorage and restored on every visit. The remaining toggles below are session-only — they reset to defaults on page reload and are not written to localStorage.
localStorage.The game ships with a fully integrated, configurable sponsor/ad system ready to connect to any ad network.
ads.preGame.countdown). The Skip button is disabled until the countdown reaches zeroscripts/sponsor/sponsor-placeholder.html. The file contains clearly marked AD REPLACEMENT START and AD REPLACEMENT END comment blocks showing exactly where to paste ad codeads.enabled or ads.preGame.enabled to false in scripts/config/ads.js. As shipped, scripts/config/ads.js sets ads.enabled: false, so the sponsor popup is off by default — set it to true to turn it onImportant: Ad network integrations such as Google AdSense, AdMob, and ironSource are third-party external services not affiliated with or included in this product. Each network operates independently and has its own account registration process, eligibility requirements, approval policies, and potentially associated costs. Pour Party provides the ad slot infrastructure only — buyers are solely responsible for obtaining their own accounts, meeting each network’s requirements, and complying with their respective terms of service.
Game behavior is controlled by a window.EQUATION_CONFIG object, which scripts/config/ads.js creates and adds its ad settings to. Add further keys to that same object (or your own script loaded before game.js) to customize other behavior. All values have built-in defaults so the game runs without any config. Configurable options include:
defaultTheme)showTimer)dailyDifficulty, default “medium”)timeAttackSeconds, 0 = disabled by default)xp.easy, xp.medium, xp.hard, xp.noMistakeBonus, xp.speedBonus)parTime.easy, parTime.medium, parTime.hard)difficulty.easy.label, and matching keys for medium/hard/daily)leaderboardMaxEntries, default 10)ads.enabled, ads.preGame.enabled, ads.preGame.countdown)confetti.enabled, confetti.count, particles.enabled, particles.count, particles.speed)Note: the hint system in Sort Color Puzzle, Combo Pour, and Twin Flow is always unlimited — the maxHintsPerGame key exists in the shared engine but only limits hints in the legacy grid-based modes, not the bottle-pouring modes.
index.htmlThis project relies on an external CDN for one resource. This dependency is third-party, hosted and operated outside of this project and outside of the seller’s control — its uptime, availability, and any future changes to its terms are the responsibility of the provider, not the seller.
fonts.googleapis.com via @import rules in scripts/css/style.css, providing the Crimson Pro (400, 600), DM Sans (300, 400, 500), and Baloo 2 (500, 600, 700, 800) font families.An active internet connection is required for the browser to reach this CDN and load these fonts. Without one, the game still runs normally — text simply falls back to the browser’s default system font. Buyers who need a fully offline build can download the font files, host them locally, and replace the @import lines in style.css with local @font-face rules.
No other third-party or CDN-hosted libraries (such as Chart.js, jsPDF, three.js, or html2canvas) are used anywhere in this codebase.
localStorage, AudioContext, document.querySelector, Promise, Set, and Array.from)Promise, and Set)localStorage access is wrapped in try/catch for safe degradation in private browsing modeindex.html via file:// may cause resource-loading issues in some browsers (notably Chrome) — serve through a local web server (python3 -m http.server, VS Code Live Server, etc.) or deploy to any static host for reliable access