Polar Games

A number sliding puzzle on the ice with 50 levels · 1.0.0

Tenfloe Puzzle

This guide explains how to install, customize and update the game. Pick your language at the top; screenshots stay in English.

Version 1.0.0 Edition Standalone buyer edition

This guide works without internet. Images, styles and scripts are already inside this file.

Contents
  1. Overview
  2. Quick installation by FTP
  3. Requirements and sound
  4. Controls and how the game works
  5. Screens and controls explained
  6. Map of the files
  7. Customizing levels, texts and sounds
  8. Languages
  9. Local saves
  10. Optional development
  11. Updating and cache
  12. Licenses
  13. Troubleshooting
  14. Frequently asked questions
  15. Support

1 Overview

Tenfloe Puzzle is an HTML5 number puzzle game on a frozen lake. The board holds ice blocks with numbers. Drag a block and push it into another one: the two numbers add up. A sum under 10 makes one bigger block, a sum of exactly 10 turns the pair into a gift, and a sum over 10 does not merge. The new block or gift takes the color of the block you dragged.

Gifts leave the board through the door of their color, the colored bars on the snow rim. A level is won when no number and no gift is left. Each level has a move limit and gives up to 3 stars for few moves. There are 50 levels in 5 worlds of 10, and each world adds something new: locked doors, ice blocks, snow mounds, crystal blocks and surprise boxes. The 10th level of each world is a timed challenge.

The game runs in any modern browser on phones, tablets and computers, in portrait and in landscape, with touch, mouse or keyboard. It has 14 interface languages, three music tracks and synthesized sound effects. There are no ads, no store, no accounts and no server: it is a set of static files.

2 Quick installation by FTP

Installing takes a few minutes if you have FTP access or a file manager in your hosting panel.

  1. 1. Extract tenfloe-static-1.0.0.zip on your computer.
  2. 2. Connect to your hosting by FTP or its file manager and open the folder where the game should live, for example public_html/games/tenfloe/.
  3. 3. Upload only the contents of the game/ folder, so that index.html sits directly inside the target folder.
  4. 4. Keep assets/, src/, style.css, style-2.css and style-3.css beside index.html, with names and letter case exactly as extracted.
  5. 5. Open https://your-domain.example/games/tenfloe/ in a modern browser.
Warning 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 sound

  • Any static web hosting with HTTPS (or HTTP). Opening index.html directly from the disk (file://) is not supported, because browsers block JavaScript modules there.
  • A current browser: Chrome, Edge, Firefox or Safari, on desktop or mobile. Blocks are dragged with a finger or the mouse.
  • Browsers start sound only after a user gesture, so the music begins after the first tap or click.
  • When the page is hidden, the sound fades out over 30 seconds and stops after 60 seconds; it comes back when the player returns.

4 Controls and how the game works

Drag a numbered block with a finger or the mouse; it slides cell by cell until something stops it. Push it against another numbered block to add them up. When a gift touches the door of its color and fits in it, it is delivered. The penguin on the corner of the board watches the block you drag and cheers at every delivery.

The counter at the top shows the moves left. Finishing within the par plus a small margin gives 3 stars, a bit more gives 2 stars, and any finish gives at least 1 star. When the moves run out, the player can use Extra moves or try again. Timed challenge levels (10, 20, 30, 40 and 50) start the clock on the first move.

Four helpers sit under the board: Undo (3 per level), Brush (paint a gift another color), Shovel (deliver a gift at once or break an ice block) and Extra moves (+5 moves, or +20 seconds on a timed level). Brush, Shovel and Extra moves open on levels 6, 12 and 18; the player starts with 2 of each and gets one more of each from the chest at the end of every world.

The first levels show short hints, and a card explains each new element when it first appears. On a computer the keyboard also works: Z Undo, B Brush, S Shovel, M Extra moves, R restart, Esc settings, Enter on the title screen to play. Settings has vibration, reduced motion, sound volumes, the language list and, during a level, Home.

5 Screens and controls explained

Title screen: Play opens the next level, Levels opens the world map; the round buttons open the sound volumes
and the settings.
Title screen: Play opens the next level, Levels opens the world map; the round buttons open the sound volumes and the settings.

Marks on the screenshot

  1. Play the next level
  2. World map
  3. Sound volumes
  4. Settings
World map: ten stones on an ice path, the chest at the end and the gate to the next world. Finished levels show
their stars.
World map: ten stones on an ice path, the chest at the end and the gate to the next world. Finished levels show their stars.

Marks on the screenshot

  1. Stars of this world (out of 30)
  2. Settings
  3. Sound volumes
  4. Current level
  5. Finished level with its stars
  6. Locked level
  7. World chest (opens after the 10 levels)
  8. Gate to the next world
  9. Play the current level
A level: the moves left and the stars at the top, the board with its colored doors, the penguin, and the four
helpers below.
A level: the moves left and the stars at the top, the board with its colored doors, the penguin, and the four helpers below.

Marks on the screenshot

  1. Moves left
  2. Stars you would get now
  3. Settings
  4. The penguin
  5. Door: deliver the gift of this color here
  6. Numbered ice block (its scarf shows its color)
  7. Undo
  8. Brush
  9. Shovel
  10. Extra moves
A card explains each new element the first time it appears (here: the locked door).
A card explains each new element the first time it appears (here: the locked door).

Marks on the screenshot

  1. The new element
  2. Close the card and play
Win: the stars, the moves used, the total of stars and the buttons to replay or go on.
Win: the stars, the moves used, the total of stars and the buttons to replay or go on.

Marks on the screenshot

  1. Stars
  2. Moves used
  3. Total stars
  4. Play again
  5. Next level
Out of moves: use Extra moves (if the player has any) or try the level again.
Out of moves: use Extra moves (if the player has any) or try the level again.

Marks on the screenshot

  1. Try again
Settings during a level: vibration, reduced motion, sound, language and Home.
Settings during a level: vibration, reduced motion, sound, language and Home.

Marks on the screenshot

  1. Vibration
  2. Reduced motion
  3. Sound volumes
  4. Language
  5. Home
Sound: separate volumes for music and effects.
Sound: separate volumes for music and effects.

Marks on the screenshot

  1. Music volume
  2. Effects volume

6 Map of the files

game/ is the ready-to-host game. source/ has the same editable files plus the tests, a local preview server, the level generator and the build command. Code comments are in Portuguese; the main names are explained below and in source/README.md.

game/                        upload these contents to your web host
  index.html                 entry page: title, map, level and the panels
  style.css, style-2.css, style-3.css   the styles (loaded in this order)
  src/main.js                start-up, screens, HUD, helpers, panels, keyboard
  src/game.js                the board on screen: drag, merge, deliver, effects
  src/rules.js               the rules (sliding, sums, gifts, doors, win) and the solver
  src/levels.js              the 50 levels and the 5 worlds
  src/map.js                 the world map
  src/config.js              feel numbers, colors, helpers, star limits, volumes, save key
  src/fx.js, src/nine.js     effects and the stretched 9-slice pictures
  src/audio/sound.js         synthesized effects and music
  src/locales.js             texts: English, Portuguese, Spanish
  src/locales-more.js        texts: the other 11 languages
  src/save.js, storage.js, i18n.js, viewport.js
  assets/art/                interface images, blocks, penguin, backgrounds (WebP)
  assets/music/              menu.mp3, map.mp3, play.mp3
  assets/fonts/              Fredoka font and its license
  DOCUMENTATION.txt          short note that points to this guide
source/                      the same editable files, plus:
  package.json               npm test, npm run build, npm run serve
  package-lock.json
  README.md
  test/                      node --test tests
  tools/build.mjs            copies the game into dist/
  tools/serve.mjs            local preview server
  tools/gen-levels.mjs       random level generator checked by the solver
documentation/index.html     this guide (offline, 14 languages)
documentation/customization.html   step-by-step customization guide
documentation/img/           the screenshots of both guides
DOCUMENTATION.html           shortcut to this guide
CUSTOMIZATION.html           shortcut to the customization guide
START-HERE.txt, CHANGELOG.txt
THIRD-PARTY-LICENSES/        font license
  • src/levels.js: the 50 levels in five lists (W1 to W5), one line per level: board size, blocks, doors, par, hints and the card of a new element. The format is explained at the top of the file and of src/rules.js.
  • src/rules.js: the rules with no drawing (sliding, sums, gifts, doors, ice, crystal, surprise box, win) and the solver that finds the fewest moves. src/game.js: the board on screen (drag, merge, deliver, effects).
  • src/main.js: screens, HUD, helpers, panels, the penguin and the keyboard. src/map.js: the world map. src/config.js: feel numbers in one place (FEEL), colors, helpers and star limits (RULES_UI), volumes and the save key.
  • src/locales.js and src/locales-more.js: every interface text in the 14 languages; src/i18n.js picks the language. src/audio/sound.js: the synthesized effects and the music.
  • assets/art/: interface images, blocks, gifts, the penguin and the backgrounds of the 5 worlds (WebP). assets/music/: menu.mp3, map.mp3, play.mp3. assets/fonts/: the Fredoka font and its license.
  • Names in the code: gate is a door, pip is the penguin, ice, pin and box are the ice block, the crystal block and the surprise box, holes are the snow mounds, brush, shovel, plus and undo are the helpers.

7 Customizing levels, texts and sounds

Note Not a programmer? The Customization Guide shows every change step by step, with numbered screenshots of the game. It is in English. Open CUSTOMIZATION.html in the main folder of the download.

Customization Guide (step by step, in English)

Levels: each level is one line in src/levels.js. Change the board size, the blocks (position, size, number, color) or the doors, then run npm test: it checks that every level can be solved and that its par is the fewest moves found by the solver, and tells you the right number when it is not. tools/gen-levels.mjs can create new random levels that the solver accepts.

Worlds: WORLDS in src/levels.js lists the five worlds; each world is a list of 10 levels. The world names are texts (w1 to w5) in the language files, and each world has its own backgrounds in assets/art/ (bg-*, map-* and w2- to w5- versions).

Difficulty: the move limit and the star limits are formulas in RULES_UI in src/config.js. The same place sets the level where each helper opens and how many the player starts with. Block and door colors are in COLORS.

Look: the logo is assets/art/logo.webp, the penguin images are pip-*.webp and penguin-*.webp, and buttons, panels, blocks and gifts are the other WebP images in assets/art/. Replace a file with one of the same name and similar size. Styles are in style.css, style-2.css and style-3.css.

Music and sound effects

Music: assets/music/menu.mp3 plays on the title screen, map.mp3 on the world map and play.mp3 during the levels, all in a loop. To change a track, replace the MP3 keeping its name. If a file is missing, the game simply stays silent there.

Sound effects are synthesized in src/audio/sound.js, so they have no files. Their pitch and loudness are set there; the player sets the volumes in the Sound window.

Warning Keep the save key unchanged on a live site. A different key makes the game ignore existing progress and start a new save.

8 Languages

The game has 14 languages: English, Português (Brasil), Español, Français, Deutsch, Italiano, Nederlands, Polski, Türkçe, Русский, Bahasa Indonesia, 日本語, 한국어 and 简体中文. It follows the browser language on the first visit and the player can change it in Settings. English, Portuguese and Spanish are the reference texts; the other 11 languages were not reviewed by native speakers, so a native review is recommended before a launch in those markets. The bundled font covers Latin letters; Russian, Japanese, Korean and Chinese use a font of the device.

To force a language, add ?lang=pt (or another code) to the game address.

To add a language, copy one of the blocks in src/locales-more.js, translate it, add it to MORE at the end of that file, and add its code and name to LANGS, HTML_LANG and NUMBER_LOCALE in src/locales.js. The language test in test/locales.test.mjs expects 14 languages, so update that number too.

9 Local saves

  • Progress (level reached, stars of each level, helpers, chests opened, cards seen) and the settings are saved in the browser localStorage of each device.
  • There are no accounts or cloud saves. Clearing site data resets the progress on that device.
  • The two keys are shown below. Their prefix is STORAGE_PREFIX in src/config.js.
tenfloe.template.save.v1.progress
tenfloe.template.save.v1.lang

10 Optional development

This section is only for changing the code. The game/ folder already contains the finished game, so installing it needs no Node.js. The game has no dependencies and no compile step: npm run build only copies the files into source/dist/, which is identical to game/.

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.1). npm is included.

Windows: run the .msi installer, keep npm and Add to PATH enabled, finish the installation and reopen Command Prompt. macOS: run the official .pkg installer and reopen Terminal. Linux: follow the instructions on the official download page for your distribution, including npm.

2. Check the installation. Run node --version and npm --version separately. Both must print a version number, and Node.js must be 26.13.1 or newer. If a command is not found, reopen the terminal and check the installation.

node --version
npm --version

3. Extract the complete ZIP first and open its source/ folder, where package.json is. Windows: type cmd in the address bar of that folder in File Explorer. macOS and Linux: open Terminal and use cd with the folder path in quotes.

4. Run the commands below one by one. npm ci checks the lock file (nothing is downloaded, the project has no dependencies). npm test checks the rules, that every level can be solved in its par, the 14 languages and the save key; it can take up to half a minute. Stop and fix any error before going on.

npm ci
npm test

5. Preview: npm run serve starts a local server; open http://localhost:5196/ in your browser, play a level, and stop the server with Ctrl+C.

npm run serve

6. Build: npm run build empties source/dist/ and copies index.html, the three style files, src/ and assets/ into it. dist/ is what you publish; while the source is unchanged it matches game/ file by file.

npm run build

7. Publish: back up the game on your website, then upload the contents of dist/ in place of the old files, keeping the folders. If you deleted or renamed a file, delete the old one on the server yourself. Clear the browser cache to see the new version (see below).

Note Troubleshooting: ENOENT or a missing package.json means the terminal is in the wrong folder. EBADENGINE means Node.js is too old. If PowerShell blocks npm.ps1, use Command Prompt instead; do not change security settings.

Test shortcuts (local addresses only)

The shortcuts below work only when the page address is localhost, 127.x or a private network address (192.168.x). On any public address they are ignored, so players cannot use them. ?lang=pt (or another language code) is not a test shortcut and works on any address.

  • ?level=12 opens level 12 directly; ?screen=map opens the world map; ?unlock opens every level; ?reset erases the progress of this browser.
  • ?notutorial hides the tutorial hints and ?allpowers opens all helpers.
  • ?qa exposes the running game as window.__tenfloe for automated tests in the browser console.
http://localhost:5196/?level=12&lang=es

11 Updating and cache

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.

12 Licenses

The game code, the levels and the artwork are supplied under the license of the item you purchased. The music used by the game is included in the package and can be replaced or removed (see the customizing section).

The Fredoka font is used under the SIL Open Font License 1.1; its complete license text is in THIRD-PARTY-LICENSES/ and in game/assets/fonts/LICENSE-Fredoka-OFL.txt. The game has no third-party code and no npm dependencies.

13 Troubleshooting

  • Blank page: the game was opened from the disk or a file is missing. Use a web host and keep assets/, src/ and the three style files next to index.html.
  • A level you edited cannot be won or npm test fails: run npm test and read the message; it names the level and the right par, or says that the level has no solution.
  • No sound: tap the screen once; check that the device is not silent and the volumes in the Sound window are up.
  • Old version after an update: clear the browser cache (see below).
  • An address such as ?level=5 does nothing on your website: test shortcuts only work on local addresses (see the development section).

14 Frequently asked questions

Does the game work without internet?
The game calls no external services. It is not an installable offline app, so players need to reach your web address to load it.
Can I add ads, a store, cloud saves or a ranking?
Not in this edition. It has no ad, payment, sync or ranking code. Adding them is developer work that needs your own accounts.
Can I publish it on game portals or app stores?
Yes, within the terms of the license you purchased. Wrapping it as an app needs your own developer accounts and tools.
Can I make my own levels?
Yes. Edit or add lines in src/levels.js (or create them with tools/gen-levels.mjs) and run npm test to check that each one can be solved and has the right par. The Customization Guide shows it step by step.
How do I reset the progress while testing?
On a local address use ?reset. Anywhere else, clear the site data for the game address in the browser, or run localStorage.clear() in the browser console.

15 Support

Questions or problems: write to willian@polargames.com.br with your purchase code, the browser and a short description or screenshot.

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.