Contents
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.
- Extract the whole ZIP on your computer.
- Upload the contents of
game/to a folder on static hosting, using FTP or your host's file manager. - Open that folder's URL in a modern browser. The build uses relative paths and can be installed in a subfolder.
- Tap or click to start; browsers require a user gesture before playing audio. Test on the intended devices.
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.
Marks on the screenshot
- Play: opens the map at the current stage
- Climb: starts Endless Climb or the Daily Climb
- Outfits: 6 cosmetic outfits unlocked with golden coins
- Settings: language, vibration, less motion, light effects, assisted aim and sound volumes
Marks on the screenshot
- Back: returns to the main menu
- Total stars collected across all stages
Marks on the screenshot
- Coins collected in the current stage
- Stage timer, used for the time star
- Pause: opens Settings during a stage
Marks on the screenshot
- Resume: closes Settings and continues the stage
- Restart: replays the current stage from its start
- 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, includinggame/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?
Does the game need a server or database?
game/ folder is static files; progress is saved in the player's browser.Can I change the ninja, the worlds or the stages?
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.