Polar Games

HTML5 wall-jump climbing game · buyer guide · 1.0.1

Kumo Climb

A one-button wall-jump climbing game in plain HTML, CSS and JavaScript: 50 levels in 5 worlds, a boss in every world, an endless tower and a shop, ready to upload to any static web host.

Version 1.0.1 Edition HTML5 static edition (plain JavaScript)

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

Contents
  1. Overview
  2. Install on your website
  3. Requirements
  4. How to play
  5. Screens
  6. Screenshot gallery
  7. Files in the download
  8. Internal names
  9. Customization
  10. Languages
  11. Save data
  12. Development (optional, for beginners)
  13. Updates and browser cache
  14. Licenses
  15. Troubleshooting
  16. FAQ
  17. Support

1 Overview

You are Kumo, a little red panda ninja climbing a tall shaft between two walls.

Tap to jump to the other wall, keep holding to cling to it, and tap again in the air to dash.

Defeat enemies by jumping through them, collect coins and jade coins, and reach the bell at the top.

  • 50 levels in 5 worlds of 10. Each world adds something new: spikes, shurikens and crows; cracked walls; bats; samurai armor; ice walls.
  • A boss at the end of every world: Great Crow Tengu, Living Temple Bell, Paper Dragon Kite, Shadow Master and Giant Snow Oni.
  • 1 to 3 stars per level: clear it, collect all the jade coins and take no damage. 3 hearts and checkpoint lanterns.
  • Endless tower with a best height, and a shop with 6 colors for Kumo's scarf, bought with the coins of the levels.
  • 14 interface languages, music, sound effects, vibration, screen shake and a reduced-motion option.
  • Portrait and landscape phones, tablets and desktop computers (touch, mouse or keyboard).
  • Plain HTML, CSS and JavaScript: no compile step, no dependencies, commented code, levels written as text and a test robot that plays every level.

The download contains the ready-to-host game, the same game as editable source, this guide, a customization guide and the font licenses:

START-HERE.txt
CHANGELOG.txt
DOCUMENTATION.html
CUSTOMIZATION.html
documentation/
game/
source/
THIRD-PARTY-LICENSES/

2 Install on your website

  1. Unzip the download on your computer.
  2. Upload only the contents of the game/ folder to your web host: FTP, the file manager of your hosting panel or any static host. A subfolder works too.
  3. Open the address of that folder in a browser. Keep the folder structure exactly as it is.
  4. Tap or click the start screen: browsers only play sound after the first touch.
Warning Do not upload source/, documentation/ or the ZIP to the public game folder. No database, PHP, account or online service is needed.

3 Requirements

  • Any static web host; HTTPS is recommended.
  • A current browser: Chrome, Edge, Firefox or Safari, on desktop, Android, iPhone or iPad.
  • Node.js 26.13.0 or newer, only for the optional tools (tests, local server, build).
Warning Open the game through http:// or https://. A double click on index.html (file://) does not work, because browsers block JavaScript modules there. On your computer, use npm run serve (see Development).

4 How to play

  • Tap, click, Space, Up arrow or W: jump to the other wall.
  • Keep holding: cling to the wall when you land; the hero stops climbing.
  • Tap again in the air: lightning dash, the only way to defeat samurai armor.
  • Esc or P: pause or close a panel. Enter or Space also press the main button of a panel.

A wall that glows at its end is about to finish: jump before it. A card explains each new element the first time it appears.

5 Screens

Real phone screenshots of this edition. The numbers on each picture match the list below it.

Title screen
Title screen

Marks on the screenshot

  1. Play: opens the world map
  2. Settings
  3. Shop: colors of the scarf
  4. Language
World map
World map

Marks on the screenshot

  1. Back to the title screen
  2. World name
  3. Stars of this world
  4. Next level: one marker per level, the 10th is the boss
  5. Play the next level
  6. Endless tower
  7. Next world (opens after the boss)
A level
A level

Marks on the screenshot

  1. Hearts (3)
  2. Level number
  3. Coins of this run
  4. Pause
  5. Height: how far the bell is
  6. Jade coins of the level (all of them = 1 star)
Level clear
Level clear

Marks on the screenshot

  1. Stars: clear + all the jade coins + no damage
  2. Coins earned
  3. Next level
  4. Play again
  5. World map
Shop
Shop

Marks on the screenshot

  1. Coins to spend
  2. Color in use
  3. Other colors: tap to buy, tap again to use
Settings
Settings

Marks on the screenshot

  1. Sound effects volume
  2. Music volume
  3. Vibration (phones)
  4. Screen shake
  5. Reduced motion
  6. Language

7 Files in the download

Map of the package. game/ and source/ hold the same game; source/ adds the tests and tools.

game/                         upload THESE CONTENTS to your web host
  index.html                  entry page: every screen and panel
  style-2.css, style.css      styles (loaded in this order)
  src/art.js                  image list, loading, color tint, draw helpers
  src/audio.js                sound effects and music
  src/bot.js                  test robot (npm test, ?bot)
  src/config.js               TUNE (rules) and FEEL (effects)
  src/i18n.js                 language choice
  src/levels.js               50 levels + endless tower (text pieces)
  src/locales.js              texts, 14 languages
  src/main.js                 start-up, screens, HUD, input, panels, map, shop
  src/ribbon.js               cloth animation (not shown, kept for reuse)
  src/save.js                 save (kumo-climb.template.save.v1)
  src/sim.js                  the rules (no drawing)
  src/view.js                 canvas renderer of a level
  assets/                     images (WebP), music/, sfx/, fonts/ (with licenses)
  DOCUMENTATION.txt           short note pointing to this guide
source/                       the same editable game, plus:
  package.json                npm test, npm run build, npm run serve
  package-lock.json, README.md
  test/                       node --test tests (the robot plays all 50 levels)
  tools/build.mjs             copies the game into source/dist/
  tools/serve.mjs             local test server
documentation/                this guide (14 languages), the customization guide and its picture
DOCUMENTATION.html            shortcut to this guide
CUSTOMIZATION.html            shortcut to the customization guide
START-HERE.txt, CHANGELOG.txt
THIRD-PARTY-LICENSES/         font licenses (SIL Open Font License 1.1)

The file source/README.md describes each source file. The short names used inside the code are listed in the section Internal names.

8 Internal names

Code comments are in Portuguese. Some short names in the code come from the engine and differ from what the player sees:

In the code In the game
kumo the hero (Kumo); events kumo-start, kumo-lang, kumo-prefs; test object window.__kumo
scarf the hero's scarf: the shop colors (SCARVES) and the cloth drawn behind the hero
jade green jade coins in the middle of the shaft (all of them = 1 star)
lantern checkpoint: after a fall the hero comes back at the last lit lantern
bell the goal at the top of a level; also the world 2 boss (Living Temple Bell)
tengu, bell, dragon, shadow, oni the five bosses: Great Crow Tengu, Living Temple Bell, Paper Dragon Kite, Shadow Master, Giant Snow Oni
dummy, thrower, armor wall enemies: straw guard, shuriken thrower, samurai armor (only the dash cuts it)
crow, bat flying enemies in the middle of the shaft
crum (x), ice (i), B / C, ^ cracked wall, ice wall, wall ledges, spikes (level letters)
endless the endless tower (best height in meters)
dash the lightning dash (tap again in the air)

9 Customization

Step-by-step recipes for non-programmers are in CUSTOMIZATION.html, in the root of the download (in English). In short:

Open the customization guide

  • Pictures: replace the WebP files in assets/ with your own, same name and similar size.
  • Texts: src/locales.js, one list per language.
  • Levels: src/levels.js. Levels are columns of letters; npm test checks with the robot that every level can be finished.
  • Difficulty: TUNE in src/config.js (speeds, gravity, hearts, timings).
  • Shop: the 6 colors and their prices are in SCARVES in src/art.js.
  • Music and sounds: assets/music/ and assets/sfx/, same file names.

Edit the files in source/, test, run npm run build and upload the contents of source/dist/. Without Node.js, edit the same files inside game/ directly.

10 Languages

The game has 14 interface languages: English, Portuguese, Spanish, French, German, Italian, Turkish, Russian, Polish, Indonesian, Japanese, Korean, Chinese and Arabic (right to left).

The first visit uses the browser language, or English if it is not one of the 14. The player can change it in the settings, and ?lang=ja in the address forces a language.

To add a language, add a line to LANGS and a list to T in src/locales.js (same order as the keys) and a flag picture in assets/. npm test checks that every language has every text.

Note The game texts other than English and Portuguese were not reviewed by native speakers. This guide also has 14 languages, but a different list: it has Dutch, the game has Arabic.

11 Save data

Progress, stars, shop purchases and settings are saved in the browser (localStorage) in one entry: kumo-climb.template.save.v1 (STORAGE_KEY in src/save.js).

Change that name if you host more than one copy of the game on the same domain. Private windows and clearing the site data erase the progress.

12 Development (optional, for beginners)

The game is ready in game/. These steps are only for testing your changes on your computer.

1. Install Node.js 26.13.0 or newer (the current LTS line) from nodejs.org. Windows and macOS have installers; on Linux use your package manager or nvm.

2. Close the terminal and open it again (Windows: PowerShell or Command Prompt; macOS: Terminal), then check the versions:

node --version
npm --version

3. Go to the source/ folder, the one with package.json, for example:

cd Downloads/kumo-climb-static-1.0.1/source

4. Install and test. The project has no dependencies; npm ci only checks the lockfile:

npm ci
npm test

5. Play your copy: run npm run serve and open http://localhost:5196/. Ctrl+C stops the server.

6. Build: npm run build writes a fresh copy of the game to source/dist/ every time. Upload the contents of dist/.

Test robot and test shortcuts

npm test runs the robot of src/bot.js on all 50 levels. It looks ahead in the real simulation and must finish every level; if you edit a level and the robot cannot finish it, the test names that level.

On localhost and private network addresses only, the address accepts test options: ?bot (the robot plays in the browser), ?level=12, ?level=endless, ?world=3 and ?screen=shop. On a public address they are ignored.

?qa adds 9999 coins to the save of that browser and creates window.__kumo for automated tests.

http://localhost:5196/?bot&level=12

Common problems

  • node or npm not recognized: open the terminal again after installing, or add Node.js to the PATH.
  • Windows PowerShell blocks npm.ps1: run the same command in the Command Prompt (cmd), or use npm.cmd test.
  • ENOENT package.json: you are not inside source/.
  • EBADENGINE: update Node.js to 26.13.0 or newer.
  • Port in use: PORT=8080 npm run serve on macOS or Linux, or set PORT=8080 && npm run serve in the Windows Command Prompt.

13 Updates and browser cache

After you upload a new version, a browser may still show the old files from its 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.

  • A private window shows the new version at once.
  • Purge the cache of your host or CDN if you use one.
  • Add a version to the address, for example index.html?v=2, to skip old copies.

14 Licenses

Fonts: Fredoka and Kaushan Script, SIL Open Font License 1.1 (files in THIRD-PARTY-LICENSES/ and assets/fonts/).

The game code, pictures, music and sound effects are part of this item and are covered by the license of your purchase. No third-party JavaScript library is used.

15 Troubleshooting

  • Black or empty page: the game was opened from file://, or a file is missing. Open it through a web address and keep the folder structure.
  • No sound: browsers start audio only after the first touch, which the start screen asks for. Check the volumes in the settings and the silent switch of the phone.
  • Old version after an update: see Updates and browser cache.
  • Progress lost: private windows and cleared site data do not keep the save.
  • A level you edited cannot be finished: run npm test; the robot names the level.

16 FAQ

Can I put the game on my site or in an app?
Yes, within the license you bought. It is a static web page, so it also works inside a WebView.
Do I need to know JavaScript?
Not for pictures, texts, sounds and colors: follow the customization guide. Levels are plain text with a legend.
Does it work offline?
Once loaded it needs no server and makes no request to other sites.
Can I change the hero?
Yes: replace the pose pictures k-*.webp in assets/, keeping the same sizes. The customization guide explains the details.
Does each world have its own music?
No. There are 3 music tracks: menus, levels and boss levels (assets/music/).

17 Support

Questions, problems or custom work: willian@polargames.com.br. Please include the item name, the browser and device, the address of your copy (if online) and a 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.