SKYSPRINT Docs

Overview

Sky Sprint is a competitive Web3 arcade on Robinhood Chain. Instead of paying to play, you earn the right to play by holding — the longer your tokens stay in the wallet, the more runs you unlock. Skill decides the leaderboard; holding decides who gets to enter.

Game Loop

Five steps, in order. Every game in the arcade uses the same loop — only the skill test changes.

1. Connect a walletThe wallet is what the hold gate reads. A wallet with nothing in it earns zero runs, by design.
2. Clear the hold gateYou need 3 hours of accumulated holding before your first run unlocks. See The Hold Gate.
3. Spend a runEach round burns one run from your balance. Runs are earned over time, capped per day — they do not accumulate forever.
4. PlayYour score is whatever the game awards. A bust score of zero is still a spent run.
5. SettleYour score joins the room leaderboard. Top scores at the weekly cutoff take the prize pool.

The Hold Gate

The gate is the entire point of the arcade. Holding is not a fee — it is the entry requirement, and the only thing that generates runs.

Worked example

A wallet held for 10 hours:

floor(10 / 3) = 3 completed blocks
3 × 2 runs per block = 6 runs
6 capped at runCap 6  ->  6 runs available

Held for 9 hours: floor(9/3)=3 → 3×2 = 6 runs. Held for 8 hours: floor(8/3)=2 → 2×2 = 4 runs. Holding 2 hours gives nothing — the gate is not met.

Game Catalogue

Three titles are playable now. All three share the same hold-to-play loop: clear the gate, spend a run, chase a score.

A second shelf of titles is announced but not built — see Announced Titles. Nothing in that shelf has rules, code or a page yet.

Where Everything Lives

The site is three pages. Knowing which one holds what matters, because the same game name can appear in two places with two very different meanings.

Contract Address field

Explore carries a Contract Address row with a Copy button. Until the token is deployed it reads After launch, and copying it says so plainly rather than claiming success on an address that does not exist.

Once a real address is pasted in, the field is recognised as an address and the copy confirmation changes accordingly. The address is a plain text node, so replacing it needs no code change.

Announced Titles

Six further games are named on the site but none of them exist yet. No prototype, no rules written down, no playable build. They are placeholders so the lineup is visible while the work happens.

The intent is a shelf of simple, fast wallet-to-wallet games — the kind you pick up in a minute and learn by playing one hand — each match staked in SKYSPRINT between two connected wallets.

How they differ from the three live titles

Whether an announced title will need runs at all is an open question. If it turns out social games should be staked rather than run-gated, the run economy in Runs & Rewards would not apply to them.

Sky Sprint

The original title. Hold the line — one tap or keypress lifts the craft, gravity pulls it down, and you thread it through a column of gates. Each gate survived adds one to your score.

Difficulty ramp

Speed rises and the gap tightens as you go, but both are bounded — there is always a survivable frame if you are paying attention.

Controls

• Tap the canvas, or press Space / Arrow Up, to flap.
• Escape or the pause button pauses mid-run.
• Touch and mouse both work — touch-action:none keeps the page from scrolling under you.

Outcomes

• Run Over — you hit a gate or the floor. Score stands, run is spent.
• Runs Used Up — you still have the game open but no runs left. Replays wait on the hold gate.
• New best — beating your personal best is called out on the result overlay and stored.

Sky Invasion

Tower defence on a 5 × 7 grid. Energy regenerates on its own timer — tapping never gives you energy, it only places a unit — and aliens walk the lanes toward your core. Lose all three core shield points and the run ends.

The four units

Cooldown and fire rate are in frames, so DPS is 60 / rate × damage.

Lance hits hardest but fires slowly and has the second-worst HP. Barrier does no damage at all — its 220 HP is the point. Sentry is the cheap backbone; Frost is the cheapest source of sustained damage per shot.

Energy

The four alien types

Runner is the fastest and the frailest — it exists to punish a lane you left empty. Boss arrives every 5th wave, moves slowest, and hits for 34, so a single unbraced lane loses the run on its own.

Wave ramp

Outcomes

• Core Breached — all 3 shield points gone. Score stands, run is spent.
• Runs Used Up — you still have the board open but no runs left.

Sky Guardian

You fly the ship. Meteors fall, you shoot them down, and the field only gets thicker. There is no finish line — the run ends when a rock reaches you and your shield is gone.

Ship

Shooting

The meteor field

Every rock's size is rolled at random, so no two waves read the same. Larger meteors take several hits.

Outcomes

• Run Over — your shield hits 0. Score stands, run is spent.
• Runs Used Up — no runs left for another attempt.

Roadmap

Sky Sprint was the first of three titles, and the run economy it defines is shared by all of them. Three things are planned on top of that foundation: staking, player-versus-player battles, and more games. None of them are built or deployed yet.

Token

The official SKYSPRINT token is planned to launch on Pons, a launchpad on Robinhood Chain. Its contract address does not exist yet — nothing below can be traded today.

3% transfer tax

Every transfer carries a 3% tax. It is split 1 / 2:

Rewards distribution

The 2% rewards share is paid out on two schedules:

• Daily — a smaller, regular payout to qualifying players.
• Weekly — the main distribution, following the settlement window described in Runs & Rewards.

Runs earned per transfer are the intended bridge between the token and the arcade: holding SKYSPRINT is what unlocks play, and the tax that comes with those transfers is what funds the payouts.

Runs & Rewards

Runs are the currency of the arcade. You do not buy them — you earn them by holding, and you can only bank a limited number at a time.

Runs earned by holding time

You reach the cap at 9 hours and it never goes higher. Everything past that only matters if you spend runs — which is the intended pressure: hold, then actually play.

Scoring & Ranking

Each room shows the top 10 scores, your own row highlighted, and your live position against them.

Your position

The result overlay compares you against the 10th-place cutoff, not the leader. Beating the cutoff is what qualifies — chasing first place is not required.

• Score above the cutoff → you are in for the weekly pool.
• Score below it → you still keep the score on your personal best, you just miss the payout.
• A bust result scores zero and still spends the run.

Medals

Positions 1, 2 and 3 are badged. Everything from 4th down is ranked purely on score.

Build Status

Honest per-feature state. Nothing below is inferred — this is what the shipped code actually does.

Admin access

The admin panel is gated by a SHA-256 password hash in server/.env, and the hash stays server-side: the browser only ever receives a session cookie. This is not the old client-side gate, where the comparison ran in the page and anyone who viewed source could read the hash and brute-force it offline. Still worth keeping anything sensitive out of it — it is one login, not multi-factor.

Configuration

Every tuning value lives in one object so the admin panel can rewrite it at runtime without a rebuild. Reads come from localStorage under the key skysprint_config, falling back to the shipped defaults.

Storage keys

One config store per game

The three titles do not share a config key. Each folder keeps its own tuning object, so changing one game never silently retunes another.

Best scores and run counts follow the same prefix per game — <prefix>_best, <prefix>_runs, <prefix>_runbest, <prefix>_scorever. All three also read the same shared hold-time value, so unlocking runs stays consistent across titles.

Live config sync

The storage event does not fire in the same tab and is unreliable on file://, so the game polls a cheap fingerprint of the config instead. When it changes, new values are pulled in. Physics constants need a page reload; run state does not.

Legacy config migration

Configs written before the Sky Sprint rename still carry the old token name and ticker. On load those keys are deleted so a stale ticker can never keep being served.

FAQ

Do I need to connect a wallet?

Not in the current build — nothing is connected and nothing can be spent. The wallet is already central to the design: it is what the hold gate reads. Wallet connection is on the roadmap but unbuilt.

Can I lose real money?

No. There is no contract, no transaction, and no wallet signature anywhere in the code. Every score is local. This changes when the token ships — treat the current build as a playable mock.

Why do I have zero runs?

Either you have not cleared the 3-hour hold gate, or you have spent everything you earned. The Runs cell shows what you earned, what you used, and what is left — if earned is zero, the gate is the reason.

Can I reset my state to test again?

Yes — clear this site's data in your browser, which removes the skysprint_* keys listed above. The admin panel has a round-reset that does the same thing.

Do the difficulty and odds change?

Yes. The admin panel rewrites skysprint_config live, and the running game picks up economy and scoring changes immediately. Physics changes take effect on reload.

My leaderboard rank looks odd.

Expected — the competitors are a hardcoded placeholder list. Your arithmetic against them is real; the field around you is not.

Can I compare scores between the three games?

They all feed one leaderboard, and that is deliberate — the top 10 wallets are picked from a single board. It only works because the score rate is tuned to roughly match: Sky Invasion pays 1 point per drone or runner, 6 per brute and 14 per boss precisely so a good tower defence run scores in the same band as a good Sky Sprint run. That is why one of the constants in that game is a score contract rather than a difficulty knob.

What does "announced" mean on the game cards?

It means the name and a one-line idea exist, and nothing else. No code, no rules, no prototype. If you are deciding whether to hold anything, the announced titles should carry zero weight — only the three playable ones do.

Which game is hardest?

Different failure modes rather than a clear order. Sky Sprint punishes a mistimed input instantly, Sky Guardian punishes slow reactions as the spawn rate tightens, and Sky Invasion punishes a lane you leave empty — a single unbraced boss costs 34 shield damage against a 3-point core.

How many games are there?

Three titles are playable today — Sky Sprint, Sky Invasion, and Sky Guardian. Six more are named but have nothing behind them yet; see Announced Titles. Staking and player-versus-player battles are on the roadmap. This page updates as each one ships.