Deep Sea Guardians: Merge Defense · Deep Sea Guardians: Merge Defense 1.0.0

Contents

Overview
Installation
Requirements and sound
How to play
Interface guide
Files and customization
Languages
Local saves
Development
Updating and cache
Licenses
Troubleshooting
Support

1 Overview

An underwater merge tower defense in landscape. Recruit little sea guardians, drag two equal guardians together to grow a stronger one, and place your best guardians in the five front rows so they shoot at the pirate submarines heading for the reef barrier. 12 guardian levels, each with its own attack (from a clownfish blowing bubbles to a sea turtle lobbing shells, a frost seahorse, an electric ray, a narwhal lance and a royal octopus whirlpool). 30 campaign waves in 3 worlds (Sunny Reef, Sunken Ruins and Luminous Abyss) with 8 kinds of pirate submarines and a boss every 10 waves (Ram Submarine, Deep Sea Corsair, Abyssal Driller), then an Endless mode. An octopus captain teaches the first game. The Reef Base sells upgrades (Recruitment, Strong Current, Strong Barrier, Quick Patch). 14 interface languages, recorded sound effects and music, no external services.

2 Installation

Extract the ZIP. Open DOCUMENTATION.html for this guide. Upload only the contents of game/ to your static HTTP(S) hosting, keeping all folders beside index.html. Open that address in a browser. No database, PHP, account or Node.js runtime is needed to play. Keep source/ and the full ZIP outside your public website.

3 Requirements and sound

Use a current browser with JavaScript, Canvas 2D, Web Audio and local storage enabled. Mouse and touch are supported. The first click, tap or key press unlocks sound; check browser autoplay settings and the in-game sound controls. Files are bundled locally; normal play makes no request to Polar ranking, advertising or payment services. Host the complete folder; opening game HTML through file:// is not the supported installation method.

4 How to play

Tap Recruit (or press Space) to call a guardian: it appears in a free reef slot. Drag a guardian onto an identical one to merge them into the next level; drag it to a free slot to move it, or onto the bin to recycle it for half its price. Guardians in the front column attack along their row. Each wave starts by itself after a short countdown; Call Wave starts it early for a small bonus. Fish School (from wave 3: tap the sea to send it) and Current (from wave 7) are free powers with a cooldown. Bonus drops sometimes sink onto the field: tap them for coins or a guardian. If the barrier falls, Retry resets the formation to the start of the wave and repairs the barrier. The 1x/2x button changes the game speed. Pause opens Resume, Restart wave, Sound, Language and Main menu.

5 Interface guide

First-game tutorial with the octopus captain

Reef Base (guardian levels and upgrades)

6 Files and customization

All balance numbers are in src/game/data.js: guardians (damage, rate, range), enemies (health, speed, reward), the wave lists, the bosses and the economy (BAL: start coins, prices, rewards, upgrades, barrier). Game feel numbers (shake, hit-stop, particles, coin flight, boss intro) are in src/render/feel.js. Texts are in src/i18n/. Images and sounds are files in assets/: replace them keeping the same names and sizes. After a balance change, run npm test. Internal code names: this game shares its engine with a garden-themed template, so the code keeps neutral internal keys. Sea guardians are plants (p1..p12, files assets/plants/pN-F.webp), pirate submarines are pests (aphid, hopper, beetle, snail, slug, stinkbug, bombardier, ladybug; bosses rhino = Ram Submarine, wasp = Deep Sea Corsair, megasnail = Abyssal Driller), the reef barrier is fence, the Reef Base is shed, the Fish School power is bees, the Current power is fertilizer and the octopus captain mascot poses are assets/ui/hazel-*.webp. Player-facing names come from src/i18n/ (en.js, pt.js and theme-generated.js for the other languages), so renaming in the texts never breaks the code.

game/                       upload these contents
source/                     editable source, tests and tools
documentation/index.html    offline illustrated guide
DOCUMENTATION.html          guide shortcut
THIRD-PARTY-LICENSES/       font license

source/index.html              entry page: loads css/game.css, css/screens.css and src/main.js
source/css/game.css            HUD, title, tutorial and bottom bar (sizes in --u = 1% of the stage height)
source/css/screens.css         Reef Base, wave held, barrier fell, pause/settings, victory
source/src/main.js             boot, fixed-step loop, save/load, input, music choice, wiring
source/src/game/data.js        every tunable number: guardians, enemies, waves, bosses, prices (BAL)
source/src/game/rules.js       pure rules (no drawing): recruiting, merge, waves, combat; used by the tests
source/src/render/scene.js     the Scene class: game events -> particles, shots, shake, sound cues
source/src/render/scene-draw.js  the draw passes of the Scene (barrier, shots, particles, texts)
source/src/render/scene-art.js image loading, baked sprites, guardian and enemy views, background
source/src/render/feel.js      every game-feel number (shake, hit-stop, merge pop, coin flight)
source/src/render/view.js      16:9 stage fitted to the window, lanes and reef slots
source/src/app/                HUD, overlay screens, first-game tutorial (DOM)
source/src/audio.js            sound effects and music (Web Audio, mobile unlock)
source/src/i18n/               one file per language (14) + theme-generated.js (sea names)
source/src/debug.js            testing panel (?debug=1, localhost only)
source/assets/                 images (WebP/PNG), sounds and music (MP3), font
source/tools/                  build.mjs (copy to dist/), serve.mjs (local server)
source/test/                   node --test tests (rules and bosses)

Internal code names: this game shares its engine with a garden-themed template, so the code keeps neutral internal keys. Sea guardians are `plants` (`p1`..`p12`, files `assets/plants/pN-F.webp`), pirate submarines are `pests` (`aphid`, `hopper`, `beetle`, `snail`, `slug`, `stinkbug`, `bombardier`, `ladybug`; bosses `rhino` = Ram Submarine, `wasp` = Deep Sea Corsair, `megasnail` = Abyssal Driller), the reef barrier is `fence`, the Reef Base is `shed`, the Fish School power is `bees`, the Current power is `fertilizer` and the octopus captain mascot poses are `assets/ui/hazel-*.webp`. Player-facing names come from `src/i18n/` (`en.js`, `pt.js` and `theme-generated.js` for the other languages), so renaming in the texts never breaks the code.

7 Languages

The game interface offers 14 languages (English, Portuguese, Spanish, French, German, Italian, Dutch, Polish, Turkish, Russian, Indonesian, Japanese, Korean and Chinese). The game picks the browser language on the first visit and the player can change it in Settings. This guide is in English, Brazilian Portuguese and Spanish; screenshots stay in English. Each language is one file in src/i18n/; English fills any missing key. Edit the texts without changing placeholders such as {n}.

8 Local saves

Progress belongs to this browser and origin. This buyer edition uses its own storage namespace, separate from the Polar website game. Clearing site data, using another browser or changing the hosting origin does not transfer progress. Private browsing and blocked storage may prevent persistence. There is no account, online ranking or cloud synchronization.

deep-sea-guardians.template.save.v1      campaign: wave, coins, guardians, upgrades, best level, Endless
deep-sea-guardians.template.settings.v1  language, music and sound volume, speed, less motion, tutorial done
(keys set by SAVE and SETTINGS at the top of source/src/main.js)

9 Development

The game is plain HTML, CSS and JavaScript (ES modules): there is no compile step. Edit the files in source/ and reload the page. npm run build copies index.html, css/, src/ and assets/ into an empty dist/ folder, which is the same as game/. On localhost, ?debug=1 opens a testing panel (coins, win or lose a wave, jump to a wave, next boss, unlock guardian levels) and window.__bb exposes the game state for automated tests; both are off on any public host.

New to Node.js? 1) Install the LTS version from nodejs.org (Windows or macOS installer) or with your package manager on Linux; it must be 26.13 or newer. 2) Close and reopen the terminal, then run node -v and npm -v to confirm both print a version. 3) Open the terminal inside the source/ folder (the one containing package.json). 4) Run npm ci to install the exact tools from package-lock.json (only Prettier). 5) Run npm test for the tests, then npm run build to write the game to dist/. 6) Try it with npm run serve (http://localhost:5191/; the page needs a web server, it does not run from a double-clicked file), then upload the contents of dist/ like game/. Common errors: node or npm not found (reopen the terminal or fix PATH); on Windows PowerShell, npm.ps1 cannot be loaded (run npm.cmd ci or use Command Prompt); ENOENT package.json (you are not inside source/); EBADENGINE (Node.js is older than 26.13); network or proxy failures during install (check your connection and proxy); npm ci complaining about the lock file (do not edit package-lock.json; delete node_modules and retry).

cd source
npm ci
npm test
npm run build
npm run serve
# http://localhost:5191/

10 Updating and cache

Keep a backup of your edited files before replacing a release. Upload all updated assets together and keep the public URL unchanged to preserve the browser save. Clear hosting or CDN caches when applicable. Test a private window after deployment; adding ?v=2 to the entry URL can help diagnose stale HTML but does not replace updating all assets.

Clearing the cache without losing progress

Progress is stored in this browser, not on the server. Clearing cached images and files, or doing a hard reload, keeps your progress.

Computer: press Ctrl+F5 on Windows and Linux, or Cmd+Shift+R on macOS. Phone: in the browser settings, choose the option to clear cached images and files.

Do not choose cookies and site data, or clear site data, for the game's address. That deletes the local save.

11 Licenses

The game artwork, audio and editable game code are supplied under the purchased item license. Included fonts retain their complete SIL Open Font License notices in game/licenses/ and THIRD-PARTY-LICENSES/. Developer dependencies retain their own upstream licenses. Original production PNG masters and artwork-generation tools are not included.

12 Troubleshooting

If the page is blank, check that every folder was uploaded, the URL is served over HTTP(S), and the browser console and Network panel have no missing files. Module builds need correct JavaScript MIME types. If sound is silent, interact once and inspect browser and game volume. If progress resets, inspect storage permissions and origin changes. The guide itself also opens offline through file://.

13 Support

For support and customization contact willian@polargames.com.br. Include the product version, browser, device, hosting URL, reproduction steps and a screenshot. No backend, native app, ad SDK or real-money purchasing system is included.

Support request

When you write to support, include the browser and device, the game version, the page address, the steps that caused the problem, a screenshot and the first error shown in the browser console. Never send passwords, payment details or secret keys.