Tetris Redux — Changelog

Unreleased

0.1.3 - 2026-05-25

• Title screen now shows your local top-5 instead of the global panel.

The global leaderboard moved into the pause menu under a "GLOBAL TOP 10"

item — accessible but not in your face every time you open the app.

• Fixed level progression when starting above 0. Previously level was

`max(startingLevel, totalLines/10)`, which meant starting at L4 required

*50* line clears before reaching L5. Now level advances every 10 lines

*relative to the chosen starting level* — L4 → L5 after 10 lines, etc.

• Pause menu: new `GLOBAL TOP 10` row opens a full sub-view of the global

leaderboard. ESC (or Enter) returns to the menu, then ESC again resumes

the game as before.

0.1.2 - 2026-05-25

• Default starting level is now 4 (was 0). It's the first level with

painted artwork and the music's baseline tempo, so a fresh game lands on

meaningful difficulty immediately. Settings still lets you pick 0–19.

• Background-art cycle anchored to level 4 → `back0`. Level 5 → `back1`,

etc., wrapping mod 10. Levels below 4 (only reachable via the setting)

wrap to the later scenes rather than skipping the artwork.

• Music tempo: level 4 is now 1.0× (baseline). Each level above adds 4%

(clearly audible by level 6 — 1.08×), reaches the 2.0× cap at level 29.

Levels below 4 dip below 1.0× (down to 0.75×) — "easy mode" feel.

• Global leaderboard now visible inside the app: top-5 panel on the

title screen and in the pause overlay. Replaces the local-only HIGH

SCORE line. Shows LOADING… / NO SCORES YET / LEADERBOARD OFFLINE

gracefully depending on network state.

0.1.1 - 2026-05-25

• Leaderboard: submit every non-zero score, not just new local PBs.

Previously the global submit was gated on the new score being the local

top, which suppressed submissions any time the player didn't beat their

own existing local PB — even when the score would have been a global

top-10. Worker already dedupes/sorts/trims, so unconditional submit is

safe and gets new entries onto the global board as soon as you play.

• Log a one-line success/failure trace per submission so future leaderboard

issues are diagnosable from Console.app.

0.1.0 - 2026-05-25

• First versioned release.
• Native Swift / SpriteKit reimplementation, fully replaces the abandoned

NullpoMino-on-Apple-Silicon attempt.

• Real-time chiptune music rendered directly from the original Game Boy

Tetris GBS file via a bundled `gbsplay` emulator — no recordings, no

audio file, no loop seam.

• Pitch-preserving per-level tempo scaling (`AVAudioUnitTimePitch`),

flat through level 4, ramps to 2.0× by L37.

• Tetris Classic 1992 Pushkin background art for the 10 levels, decoded

from the original game's LZEXE-packed/PKWARE-DCL-compressed assets.

Native 320×200 PNGs scaled nearest-neighbour at render time — no blur.

• Per-level playfield-border colour, sampled from each scene's painted

alcove so the drawn border merges with the artwork.

• Block sprites lifted from the Tetris Classic 1992 VGA tile set.
• File-backed, versioned high-score store at

`~/Library/Application Support/Tetris/highscores.json`, with rolling

per-save backups. Top 20 retained.

• Configurable starting level (0–19) and slide time (lock-delay

duration). All QOL toggles bypassable via the "1989 Mode" master

switch.

• Press Start 2P (SIL OFL) for all UI text.
• Volume meter drawn as cells (Press Start 2P doesn't ship block glyphs).
• 40 unit tests covering gravity, scoring, randomisers, board mechanics,

starting level, pause/spawn lifecycle — run on every build.

• Auto-update via Sparkle 2.x, appcast served at

https://tetris-leaderboard.jimmys.dev/appcast.xml

• Global top-10 leaderboard at the same domain (Cloudflare Worker + KV).