SAIYAN RUN
A 2D vertical endless survival climber. You climb forever while a deadly
force rises from below — dodge, boost, manage shields, survive as long as
you can.
No tokens, no minting, no wallet required. Connecting a Solana wallet is
optional and does exactly one thing: it carries your personal bests across
your devices.
Playing
Pick a fighter, a world theme and a difficulty, then climb.
- Themes — Volcanic (magma / Tyrants), Planetary (toxic nebula / Aliens),
Antarctica (cold front / Polar Bears). Each has its own danger, enemies and
soundtrack.
- Difficulty — Easy / Medium / Hard. Same climb; the rise accelerates
harder, obstacles pack tighter and enemies hunt smarter.
- Personal bests are kept per difficulty. They save locally, and sync to
your address if you connect a wallet.
Controls
| Action | Keyboard | Touch |
|---|
| Move left / right | A / D or ← / → | D-pad on the virtual pad |
| Boost | W / ↑ / Space | Boost on the virtual pad |
| Freeze (Rin) | — | FREEZE button |
| Tsunami (Tenma) | — | TSUNAMI button |
Shields absorb hits. The Freeze and Tsunami buttons only appear while you
have a charge left, and disable once spent.
The three fighters
All three are free and always available. They are not cosmetic — each is
a different run kit, and they trade against each other rather than laddering.
These abilities used to be locked behind an owned NFT; they survived the
chain removal and now belong to the fighters.
| Fighter | Kit | Plays like |
|---|
| Sora | Baseline climb · 3 shields | The reference. The climb is tuned around Sora — the honest default. |
| Rin | +12% climb & move · 3 shields · Freeze 6s | Fast and fragile. Outruns the rise, buys time with one Freeze. |
| Tenma | −4% climb & move · 5 shields · Tsunami | Heavy. Climbs slower, soaks two extra hits, clears the screen once. |
Freeze holds the rising danger; Tsunami clears it.
Wallet (optional)
Phantom, Solflare and Backpack are detected automatically through the Wallet
Standard. Connecting is identity only — the app never requests a signature
and never builds a transaction. It owns no contracts and holds no funds.
Your address keys a record of your Normal bests so the same scores show up on
your phone and your desktop. Skip it and everything still works; the bests
just live in that one browser.
Local dev
npm install
cp .env.example .env.local # optional — every var has a working default
npm run dev # http://localhost:3000 (--webpack)
npm run build && npm start
Checks:
npx tsc --noEmit # types
npm run lint # lint
npm run check:replay # sim determinism + input-log integrity
check:replay is the important one. The climb runs on a deterministic
fixed-step sim (src/game/sim/ClimbSim.ts, 60Hz), and the check drives it
with an autopilot across every theme and playfield width, replays each
recorded run, and fails unless the outcome is bit-identical. If it goes red,
the physics changed.
Architecture
| Path | What lives there |
|---|
src/game/sim/ | The deterministic climb sim — pure logic, no DOM, no rendering |
src/game/engine/ | The runtime loop that drives the sim and draws it |
src/game/render/, themes/ | Canvas 2D drawing, per-theme worlds |
src/components/game/ | Menu, HUD, virtual pad, character select |
src/web3/ | Solana wallet session + the player/bests store |
src/app/api/normal-bests/ | Wallet-keyed bests, backed by Vercel KV |
Note that Solana addresses are base58 and case-sensitive — unlike an EVM
hex address they must never be lowercased to key a record.
History
Under its former name LOOPTERNITY, this game was built around LOOPITERNS, a 10,000-piece
ERC-721 collection on Robinhood Chain with a Play-to-Mint mode, server-signed
mint vouchers and NFT-gated abilities. All of it — contracts, mint routes,
art pipeline, treasury — has been removed from this project. The deployed
addresses are recorded in docs/launch.md so they are not lost, but nothing
in this app reads them.
