Polar Games

Hold. Pull back. Let go. Climb. · 1.0.0

Ninja Up

A cute ninja climbs Japanese towers, shrines and castles one ring at a time: hold on, pull back like a slingshot, let go, and the grappling hook catches the next ring. The campaign has 55 stages across five worlds, with Endless and Daily climbs and unlockable outfits, and runs with no account, server or ads.

Version 1.0.0 Edition HTML5 static edition

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

Contents
  1. Overview
  2. Install the ready-to-play game
  3. Requirements
  4. Controls and how the game works
  5. Interface
  6. Settings and language
  7. File map
  8. Customize
  9. Languages
  10. Saved progress
  11. Install Node.js and rebuild
  12. Updates and cache
  13. Troubleshooting
  14. Frequently asked questions
  15. Support and licenses
  16. For AI assistants

1 Overview

Ninja Up is a portrait-oriented slingshot climbing game. The ninja, a little cube with an orange headband and a fox mask, hangs from a ring; holding and pulling back aims a shot, and releasing sends the hooked rope toward the next ring. One extra mid-air shot is available on every flight, so a missed angle rarely ends a climb. The campaign has 55 stages across five worlds of 11 (Ninja Dojo, Waterfall Shrine, Dragon Pagoda, Storm Rooftops and Moonlit Castle), each ending in a challenge stage, plus the separate Endless Climb and Daily Climb modes.

This edition has no multiplayer, online ranking, ads or in-app purchases. Progress, stars and unlocked outfits are saved locally in the player's browser only.

This download includes the ready-to-host game, the full editable TypeScript source, this guide and the third-party license notices.

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

2 Install the ready-to-play game

Only the game/ folder needs to be uploaded to play.

  1. Extract the whole ZIP on your computer.
  2. Upload the contents of game/ to a folder on static hosting, using FTP or your host's file manager.
  3. Open that folder's URL in a modern browser. The build uses relative paths and can be installed in a subfolder.
  4. Tap or click to start; browsers require a user gesture before playing audio. Test on the intended devices.
Warning The ready-built game needs no Node.js, PHP or database on your web host.

3 Requirements

  • Any static web host able to serve plain files over HTTPS.
  • A current desktop or mobile browser with JavaScript enabled.
  • Node.js 26.13 or newer, only if you plan to edit and rebuild the TypeScript source.

No database, backend language or build step is required to host the ready-built game/ folder.

Test on the exact devices and browsers your players will use before launch, especially for touch input.

4 Controls and how the game works

Touch and hold the ninja to aim, drag back like a slingshot, and release to fire the grappling hook at the next ring. While airborne, pull and release once more for one extra shot.

A dotted line previews the aimed direction while holding. One extra mid-air shot is available per flight, given back when the ninja grabs a ring or lands. Obstacles are part of the scenery and there are no enemies: spikes, fire from dragon statues, crushing gates, shurikens on rails, water, wind, and rings that crack, are wet, spin or blink.

A stage is cleared on reaching the Golden Scroll at the top. Along the way the ninja collects gold coins with a hole in the middle. Three stars are awarded for finishing in time, collecting 70% of the stage's coins and not falling; each stage also hides one golden coin, and golden coins unlock 6 outfits.

5 Interface

Four real captures from the shipped build, with numbered marks for the elements mentioned in this guide.

Title screen and main menu
Title screen and main menu

Marks on the screenshot

  1. Play: opens the map at the current stage
  2. Climb: starts Endless Climb or the Daily Climb
  3. Outfits: 6 cosmetic outfits unlocked with golden coins
  4. Settings: language, vibration, less motion, light effects, assisted aim and sound volumes
The world map, with stars and unlocked stages
The world map, with stars and unlocked stages

Marks on the screenshot

  1. Back: returns to the main menu
  2. Total stars collected across all stages
Gameplay: rings, coins and the stage timer
Gameplay: rings, coins and the stage timer

Marks on the screenshot

  1. Coins collected in the current stage
  2. Stage timer, used for the time star
  3. Pause: opens Settings during a stage
Settings panel, opened from the pause menu
Settings panel, opened from the pause menu

Marks on the screenshot

  1. Resume: closes Settings and continues the stage
  2. Restart: replays the current stage from its start
  3. Interface language, switched instantly without reloading

6 Settings and language

The interface language can be changed at any time from Settings, at the title screen or from the in-game pause menu, without reloading the page or losing progress. Settings also include vibration, less motion, assisted aim, separate volumes for music, effects and the ninja's voice, and optional WebGL light effects, which switch themselves off on slow devices or when WebGL is not available. Each world has its own music.

The interface ships in 14 languages: English, Portuguese, Spanish, French, German, Italian, Dutch, Polish, Turkish, Russian, Indonesian, Japanese, Korean and Chinese.

7 File map

Path What it is
game/index.html Entry point; upload it together with the rest of game/.
game/assets/ Images, audio and font files used by the build.
source/src/data/ Stage layouts of the five worlds (world1.ts to world5.ts, helpers in build.ts) and the recorded route in route.ts, which the tests use to prove every stage can be beaten.
source/src/config/tuning.ts Physics, slingshot and aim tuning.
source/src/assets/ Original art, sound and music sources.
source/src/i18n/ Interface strings live in source/src/i18n/, one file per language, each exporting the same set of keys.

8 Customize

Most physics and aim tuning lives in source/src/config/tuning.ts, and stage layouts are in source/src/data/. The ninja is drawn in source/src/render/ninja.ts, the scenery in source/src/render/world.ts and the WebGL light effects in source/src/render/post.ts; menus and screens are in source/src/ui/. Edit a value, then rebuild with npm run build to update game/.

// source/src/config/tuning.ts (excerpt)
export const T = {
  viewWorldW: 540,
  gravity: 2000,
  // ...aim, drag and timing constants
};

Keep the bundled font license notices if you keep using the bundled fonts.

9 Languages

The interface ships in 14 languages: English, Portuguese, Spanish, French, German, Italian, Dutch, Polish, Turkish, Russian, Indonesian, Japanese, Korean and Chinese.

Interface strings live in source/src/i18n/, one file per language, each exporting the same set of keys.

10 Saved progress

Progress, stars, unlocked outfits, settings and Endless Climb records are saved automatically to the browser's local storage under the key ninjaup.save, specific to that browser and site address.

  • Clearing the browser's site data for the game's address deletes this save.
  • There is no cloud save or account; progress does not transfer between devices or browsers.

Uploading a new build over an existing install keeps the save format compatible across updates of this game.

11 Install Node.js and rebuild

Only developers who want to modify the TypeScript source need these steps.

Install Node.js LTS 26.13 or newer from nodejs.org, then from the extracted source/ folder run the commands below in order.

npm ci
npm test
npm run build

12 Updates and cache

Uploading a new build over an existing install keeps the save format compatible across updates of this game.

Re-upload the full contents of game/ after rebuilding, overwriting the previous files.

An old version shown in a browser tab after updating is almost always a caching issue, not a failed upload.

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.

13 Troubleshooting

  • Blank page: check the browser console for a failed file, and confirm every file from game/ was uploaded, including game/assets/.
  • No sound: audio starts only after a tap or click, by browser policy; confirm the music, effects and voice volumes in Settings are not at zero.
  • Touch input feels off: confirm the page is not zoomed and that no parent container blocks pointer events.

Audio needs at least one user gesture (tap, click or key press) before it can play; this is a browser requirement, not a bug in the game.

14 Frequently asked questions

Can I resell this template as-is?
Check the item's license terms on its CodeCanyon page before reselling, redistributing or reusing it in another product.
Does the game need a server or database?
No. The ready-built game/ folder is static files; progress is saved in the player's browser.
Can I change the ninja, the worlds or the stages?
Yes, from the editable TypeScript source: art, sound and music are in source/src/assets/, the ninja is drawn in source/src/render/ninja.ts, stage layouts are in source/src/data/, and physics in source/src/config/tuning.ts. Rebuild with npm run build afterward; npm test checks that every stage can still be beaten.

15 Support and licenses

Font licenses are included in THIRD-PARTY-LICENSES/ and source/public/licenses/.

For product support, write to the address below.

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.

For AI assistants

  • Read the installation and customize sections before changing anything. Upload only game/ to a host; source/ is not the playable build.
  • Preserve progress: keep the save key ninjaup.save, the relative paths and the translated texts unless the buyer asks for a change.
  • Do not assume an account system, a server, ads or payments. This edition has none, and the code is the source of truth.