Contents
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. Extract
tenfloe-static-1.0.0.zipon your computer. -
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. Upload only the contents of the
game/folder, so thatindex.htmlsits directly inside the target folder. -
4. Keep
assets/,src/,style.css,style-2.cssandstyle-3.cssbesideindex.html, with names and letter case exactly as extracted. -
5. Open
https://your-domain.example/games/tenfloe/in a modern browser.
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.htmldirectly 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
Marks on the screenshot
- Play the next level
- World map
- Sound volumes
- Settings
Marks on the screenshot
- Stars of this world (out of 30)
- Settings
- Sound volumes
- Current level
- Finished level with its stars
- Locked level
- World chest (opens after the 10 levels)
- Gate to the next world
- Play the current level
Marks on the screenshot
- Moves left
- Stars you would get now
- Settings
- The penguin
- Door: deliver the gift of this color here
- Numbered ice block (its scarf shows its color)
- Undo
- Brush
- Shovel
- Extra moves
Marks on the screenshot
- The new element
- Close the card and play
Marks on the screenshot
- Stars
- Moves used
- Total stars
- Play again
- Next level
Marks on the screenshot
- Try again
Marks on the screenshot
- Vibration
- Reduced motion
- Sound volumes
- Language
- Home
Marks on the screenshot
- Music volume
- 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 (W1toW5), 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 ofsrc/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.jsandsrc/locales-more.js: every interface text in the 14 languages;src/i18n.jspicks 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:
gateis a door,pipis the penguin,ice,pinandboxare the ice block, the crystal block and the surprise box,holesare the snow mounds,brush,shovel,plusandundoare the helpers.
7 Customizing levels, texts and sounds
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.
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
localStorageof 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_PREFIXinsrc/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).
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=12opens level 12 directly;?screen=mapopens the world map;?unlockopens every level;?reseterases the progress of this browser. -
?notutorialhides the tutorial hints and?allpowersopens all helpers. -
?qaexposes the running game aswindow.__tenfloefor 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 toindex.html. -
A level you edited cannot be won or
npm testfails: runnpm testand 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=5does 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?
Can I add ads, a store, cloud saves or a ranking?
Can I publish it on game portals or app stores?
Can I make my own levels?
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?
?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.