Contents
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
- Unzip the download on your computer.
- 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. - Open the address of that folder in a browser. Keep the folder structure exactly as it is.
- Tap or click the start screen: browsers only play sound after the first touch.
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).
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.
Marks on the screenshot
- Play: opens the world map
- Settings
- Shop: colors of the scarf
- Language
Marks on the screenshot
- Back to the title screen
- World name
- Stars of this world
- Next level: one marker per level, the 10th is the boss
- Play the next level
- Endless tower
- Next world (opens after the boss)
Marks on the screenshot
- Hearts (3)
- Level number
- Coins of this run
- Pause
- Height: how far the bell is
- Jade coins of the level (all of them = 1 star)
Marks on the screenshot
- Stars: clear + all the jade coins + no damage
- Coins earned
- Next level
- Play again
- World map
Marks on the screenshot
- Coins to spend
- Color in use
- Other colors: tap to buy, tap again to use
Marks on the screenshot
- Sound effects volume
- Music volume
- Vibration (phones)
- Screen shake
- Reduced motion
- Language
6 Screenshot gallery
Desktop screenshots (1280 × 720) of the same build.
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:
-
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 testchecks with the robot that every level can be finished. -
Difficulty:
TUNEinsrc/config.js(speeds, gravity, hearts, timings). -
Shop: the 6 colors and their prices are in
SCARVESinsrc/art.js. -
Music and sounds:
assets/music/andassets/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.
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
-
nodeornpmnot 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 usenpm.cmd test. -
ENOENT package.json: you are not insidesource/. -
EBADENGINE: update Node.js to 26.13.0 or newer. - Port in use:
PORT=8080 npm run serveon macOS or Linux, orset PORT=8080 && npm run servein 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?
Do I need to know JavaScript?
Does it work offline?
Can I change the hero?
k-*.webp in assets/, keeping the same sizes. The customization guide explains the details.Does each world have its own music?
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.