Velocity Blocks 1.3.5

New in 1.3.5: keep and trade runs with your friends.

• Runs: a new menu where every run you import or open is kept. Watch it, race it, or delete it.
• Save a run as a .vbst file (great on PC) and open it in any Velocity Blocks: phone, PC or browser.
• Run links can now open in the app, and the web game has an Open in the app button.
• The game tells you when an update is out, with what's new. Update now, later, or skip it.
• Cleaner racing: the floating label over the ghost is gone; the gap panel stays.

What's new

Runs: your collection of shared laps

• Main menu > Runs keeps every run you open from a link or import from a file: track, driver, time, vehicle, date, and whether your game verified it.
• Watch a run with its full telemetry, Race it to chase it as your ghost, or delete it.
• Import run file (.vbst) and Paste a link are on the same screen. On a PC you can also drop a .vbst file on the game window.
• The same run opened twice is kept once; the newest are on top (up to 100).

Save runs as files (.vbst)

• Save run file is next to Share run in every replay that has an input log. It saves a .vbst file (on Android through the Save as screen), named like VelocityBlocks-A01-Warm-Up-Shaurya-0-10-60.vbst.
• What's inside: the track, driver, time, vehicle, walls, the date, the game version and whether the run was verified, then the run itself (readable JSON).
• Opening one: use Runs > Import run file in any version of the game. On Windows, double-click the file (the installer registers .vbst).
• Verification: your game drives every opened run itself and only shows ✓ verified when it finishes at the claimed time. A file edited to claim a faster time opens, but shows "not verified".

Run links open in the app

• Android: run links from velocityblocks.vercel.app now open straight in the app when it's installed. The website vouches for the app (.well-known/assetlinks.json), which Android 12 and later require.
• Browser: a run link opened in a browser has an Open in the app button (velocityblocks://). It opens the installed Android or Windows app.
• Windows: the game registers velocityblocks:// links when it starts. A link opens the game, or goes to the one already running. The portable .exe takes a little longer because it unpacks itself first.

Update prompt in the apps

• When it checks: the Android APK and the Windows app look for a new release at every start, at most once an hour.
• What it shows: what's new (this summary), with Update now, Later, Skip this version and Full release notes.
• How the update installs: the Android APK downloads the update in the game. The Windows installer downloads and runs the new installer. The portable .exe opens the download in your browser.

Racing

• No more floating tag over the ghost: the "PB ▲ 0.42" label is gone, because it pulled focus while driving. The gap panel on the left, the ghost car and its line on the road stay.

Good to know

• Android links: opening run links in the app needs this version and the updated website. On an older version, links still open the web game, and its Open in the app button works.
• Windows file types: the portable .exe can't register .vbst files. Use Runs > Import run file, drop the file on the window, or Open with.

For developers

• New code:
  • src/game/runLibrary.ts (Runs, in localStorage vb.runs).
  • In runShare.ts: the .vbst format (runFile, runFileName, parseRun reads files and velocityblocks:// links) and APP_LINK_BASE.
• Android:
  • AndroidManifest.xml: autoVerify on the https link filter, plus a velocityblocks scheme filter.
  • The site serves /.well-known/assetlinks.json (the release certificate 8A:B1:92:36:…) as JSON.
• Windows (desktop/main.cjs): reads .vbst paths and velocityblocks:// links from the command line and from second instances, registers the protocol (the portable by its own path), and shows the release notes in the update prompt. build-desktop.mjs adds fileAssociations and protocols.
• Updates: updates.ts checks at most once an hour (it was 24 h) and adds noteSummary (the text before the first heading) and the release page link. updateUi.ts adds the Full release notes button.
• Tests: 1558 passed, 1 skipped. New: tests/runShare.test.ts (links, .vbst files, forged times, Runs) and the notes summary in tests/updates.test.ts.

Velocity Blocks 1.3.0

New in 1.3.0: chase a ghost and share your best lap.

• Race one target ghost at a time: Gold, then the Author, then your best. Its line is on the road for the whole lap, with a live gap and your split at every checkpoint.
• Author times are now set by an AI driver that practised every track. They are tougher.
• Replays show gas, brake, steering and nitro, and the line you drove.
• Share a replay as a video, or as a link your friends can watch and race.

What's new

Chase a ghost, follow its line

• One target ghost at a time: Gold until you win gold, then the Author, then your personal best. Pause > Chase picks a different one.
• Its line on the road for the whole lap, coloured by what it does there: green on the throttle, yellow lifting, red braking, violet on nitro.
• A live gap to the ghost (green when you're ahead, red when behind), with your gap logged at every checkpoint.
• The ghost's name tag stays on screen even when the ghost is behind you, so it never just disappears.

New author times

• Set by a pro AI driver that practised every track for the Car, Bike and Truck. They are about 20-24% faster than before (A01: 10.00 s, was 12.86 s), and the gold, silver and bronze times follow from them.
• Existing medals may change: they are now judged against these times. Your records and unlocked tracks are untouched.

Replays you can read

• Telemetry in every replay: gas and brake %, steering, nitro, speed, the clock and your splits.
• Line: driven shows the path you actually took; Line: ideal shows the racing line, to compare.
• ▶ Best lap on every campaign card opens your best lap's replay without racing first.
• Author lap on the results screen shows how the author time was driven.

Share your best

• Share video: records the replay with its telemetry and opens the share sheet (WhatsApp and the like).
• Share run: sends a small link that replays your exact lap in your friend's game, marked verified when it matches your time. They can tap Race it to race against you.
• Opening a link: run links open in the app (choose Velocity Blocks in "Open with"), or use Menu > Open shared run and paste one.

Good to know

• Best laps set before 1.3.0 replay without the pedal and steering telemetry, and can't be shared as a run link. Video works for them, and new best laps have everything.
• Video format: MP4 on most phones. On older Android WebViews it's WebM, which WhatsApp sends as a file.
• Run links in a browser play in the web game once the website is updated to 1.3.0.

For developers

• Pull request: #4. Version: 1.3.0 (versionCode 10300).
• New:
  • src/game/proDriver.ts, src/track/proLaps.json (author laps, 23 kB), scripts/pro-laps.ts (regenerate after physics changes).
  • src/game/ghostDelta.ts, drivenLine.ts, inputLog.ts, runShare.ts.
  • src/ui/telemetry.ts, src/app/replayVideo.ts.
• Android: VbNativePlugin gains writeShareChunk, shareFile, shareText, takeLink and a link event, plus a VIEW intent filter for https://velocityblocks.vercel.app/play. No new permissions or dependencies.
• Testing: ?autoplay / ?autoplay=base let the AI drive every race on a device or emulator (window.vbTest for DevTools).
• Tests: 1542 passed, 1 skipped. Checked on an Android 15 emulator.

Velocity Blocks 1.2.2

What's new in 1.2.2

• ⬇️ Updates download inside the game with a progress bar, then Android asks you to confirm the install. No more hunting for the APK in Downloads. (The first time, Android asks you to allow installs from Velocity Blocks.)
• 🔁 Respawn starts you from a standstill at the last checkpoint, instead of keeping the speed and boost you had there.
• 🔓 Everything is unlocked in this download: all 24 tracks, the Bike and the Truck, and the realistic models.

New here? Download VelocityBlocks.apk below and open it on your Android phone. It installs over an older version and keeps your progress. Coming from 1.2.1 or older, this one update still downloads in your browser; from 1.2.2 on, updates happen in the game.

🪟 Windows: download VelocityBlocks-Setup.exe (installer, with Start menu and desktop shortcuts, updates itself) or VelocityBlocks-Portable.exe (runs without installing). Windows 10 and 11, 64-bit. The files aren't code-signed yet, so if Windows says "Windows protected your PC", click More info, then Run anyway.

📱 iPhone and iPad: play at https://mitovoid-ai.github.io/VelocityBlocks/play/ in Safari, then Share > Add to Home Screen for a full-screen app.

Velocity Blocks 1.2.1

Download VelocityBlocks-1.2.1.apk below and open it on your Android phone. Already have Velocity Blocks? It installs over your version and keeps your progress.

What's new

• 🔓 Everything is unlocked in this download: all 24 tracks (Stadium, Desert and Water), the Bike and the Truck, and the realistic car, bike and truck models. No purchase needed.

Everything else in Velocity Blocks

• 🏜️ 6 Desert and 🌊 6 Water tracks next to the 12 Stadium tracks
• 🏍️ Bikes and trucks, ⚡ nitro, 🧱 walls on all roads, tilt steering sliders
• 🏅 Animated results with a secret Author medal
• 🛠️ Track editor with water, splash blocks and themes

Install

Needs Android 6.0 or newer. If your phone says the install is blocked, tap Settings and allow installs from your browser or file manager, then go back and tap Install.

_{Realistic models: CC BY 4.0 by Comrade1280, Milin Andrei and Daniel Zhabotinsky (see public/vehicles/CREDITS.md).}

Velocity Blocks 1.2.0

Download VelocityBlocks-1.2.0.apk below and open it on your Android phone. Already have Velocity Blocks? It installs over your version and keeps your progress. From now on the game tells you when a new version is out.

What's new

• 🏜️ 6 Desert tracks: sand, dunes, mesas and a sunset sky
• 🌊 6 Water tracks: bridges, river jumps, lagoons and splash zones (fall in and you're back at the last checkpoint)
• 🏍️ Bikes and trucks, each with its own handling and records
• ⚡ Nitro button that recharges 6 seconds after every boost
• 🧱 Walls on all roads option, tilt steering sliders
• 🏅 Animated results: the Author medal stays secret until you beat it
• 🚗 Realistic car, bike and truck models and smarter graphics that adapt to your phone
• 🛠️ Track editor: water and splash blocks, Desert / Water / Sunset themes

Install

Needs Android 6.0 or newer. If your phone says the install is blocked, tap Settings and allow installs from your browser or file manager, then go back and tap Install.

_{Realistic models: CC BY 4.0 by Comrade1280, Milin Andrei and Daniel Zhabotinsky (see public/vehicles/CREDITS.md). The Full Game unlock is bought through the Google Play version.}