Contents
- Overview and package contents
- Quick installation by FTP
- Requirements and subfolder hosting
- Controls and how the game works
- Screens and controls explained
- Map of the files
- Languages and audio
- Saves and taking care of progress
- Optional development
- Updating the game
- Dependencies and licenses
- Common problems
- Support and version history
1 Overview and package contents
Explore 100 levels in ten fantasy worlds, rescue dragons, open chests and grow your collection. Play the daily challenge or endless mode and unlock three boosters.
2 Quick installation by FTP
Installing takes a few minutes if you have FTP access or a file manager in your hosting panel.
Upload only the contents of the game/ folder, so that index.html sits directly inside the target folder.
Do not upload the source/ folder, the documentation/ folder or the ZIP itself. Players need no Node.js, PHP, database or account.
3 Requirements and subfolder hosting
- A current version of Chrome, Edge, Firefox or Safari on a computer, tablet or phone.
- Any static hosting over HTTP or HTTPS. HTTPS is recommended for audio and browser features.
- Any subfolder of any domain. The game uses relative paths, so the same files work wherever you upload them.
- Nothing else on the server: no database, PHP or Node.js service is needed to play.
The game must be opened through a web address. Opening its index.html directly from your computer (file://) is not supported. This guide is the exception: it opens by double-clicking, with no internet connection.
4 Controls and how the game works
Drag to aim and release to shoot. Match three bubbles of the same color. Tap the next bubble or right-click to swap; rescue the dragons before moves run out.
5 Screens and controls explained
Marks on the screenshot
- Play
- Settings
Marks on the screenshot
- Bubble board
- Launcher and next bubble
Marks on the screenshot
- Language
Marks on the screenshot
- Play
6 Map of the files
Edit the TypeScript source and theme assets, then rebuild. Keep existing save keys and translation placeholders unless you intend to reset progress.
game/
source/src/main.ts
source/src/game.ts
source/src/game-draw.ts
source/src/meta.ts
source/src/meta-panels.ts
source/src/worlds.ts
source/src/i18n/
source/public/theme/witch/
source/public/audio/
documentation/index.html
THIRD-PARTY-LICENSES/
7 Languages and audio
The interface and this guide have 14 languages. Narration is recorded in English, Brazilian Portuguese and Spanish; the other languages use English audio.
8 Saves and taking care of progress
- Saves belong to one browser on one device. They do not synchronise between devices or browsers.
- Private browsing or blocked storage may prevent saving. The game keeps running for the current session.
- Clearing site data for the game's address deletes the save. Clearing cached images and files does not (see Updating and clearing the cache).
dragon-rescue.template.settings
dragon-rescue.template.unlockedLevel
dragon-rescue.template.stars
dragon-rescue.template.checkpoint.v1
dragon-rescue.template.daily
dragon-rescue.template.bank
dragon-rescue.template.chests
dragon-rescue.template.collection
dragon-rescue.template.endlessBest
9 Optional development
This section is only for changing the code. The game/ folder already contains the built game, so installing it needs no Node.js.
1. Install Node.js. Open https://nodejs.org/en/download and choose the latest Node.js 26 LTS installer for your system (minimum 26.13). npm is included. Internet is needed to download tools and dependencies, not to run a Node.js server for this game.
Windows: run the .msi installer, keep npm and Add to PATH enabled, finish installation and reopen Command Prompt. macOS: run the official .pkg installer and reopen Terminal. Linux: follow the official download page instructions for your distribution, including npm. No global Vite installation is needed.
2. Verify installation. Run the commands below separately. Both must print version numbers; Node.js must be 26.13 or newer. If a command is not found, reopen the terminal and check the installation/PATH.
3. Extract the complete buyer ZIP first. Open its source folder, where package.json and package-lock.json are located. Windows: type cmd in that folder's File Explorer address bar. macOS/Linux: open Terminal and use cd with the actual folder path in quotes. Do not run commands inside the ZIP or game folder.
node --version
npm --version
npm ci
npm test
npm run build
npm run dev
# source/dist/
7. Preview locally. From source/, run the command below and open the exact localhost address printed by Vite. Play a round, open Settings and check the sound after a click. Stop the server with Ctrl+C. This preview server is only for development; do not expose it as production hosting.
Troubleshooting: ENOENT/package.json means the terminal is in the wrong folder. EBADENGINE means Node.js is too old. If PowerShell blocks npm.ps1, use npm.cmd or Command Prompt; do not change security policy. For network/proxy errors, restore access to registry.npmjs.org and retry npm ci. If package files disagree, restore the shipped pair; npm install is for deliberate dependency changes, followed by tests/build and retaining the updated lockfile. Do not run npm audit fix --force blindly. The ready-built game/ remains usable without these developer tools.
10 Updating the game
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 Dependencies and licenses
The game makes no analytics, ranking, payment or advertising calls. It contains no ad SDK and no billing code.
The original artwork and audio supplied with this item remain under the license terms of the purchased item.
Source edition only: Vite and Vitest (MIT License) and TypeScript (Apache License 2.0), installed by npm.
Full notices: the licenses/ folder inside game/, and THIRD-PARTY-LICENSES/ in the ZIP.
12 Common problems
-
Blank page: make sure you uploaded the contents of
game/(notsource/, and not the folder itself), and that you opened the web address rather than a file on your computer. - Missing images or sounds: check the complete upload, the spelling and letter case of file names, and any 404 errors in the browser's console.
-
The files download or do not run: your host must serve
.js,.webp,.woff2and.mp3files with normal types. Ask the host to check its MIME rules. - No sound at first: tap the game once, turn on Sound effects and Music in Settings, and check the device's mute switch and volume.
13 Support and version history
Support and customization: willian@polargames.com.br. Include your purchase reference when you have it. This guide does not promise response times or a schedule of future updates.