{"id":48305724,"url":"https://github.com/jlorenzetti/quattro","last_synced_at":"2026-04-05T00:01:50.917Z","repository":{"id":344082104,"uuid":"1177216789","full_name":"jlorenzetti/quattro","owner":"jlorenzetti","description":"A sober, historically-minded falling-blocks game for Commodore 64, built with contemporary software engineering discipline.","archived":false,"fork":false,"pushed_at":"2026-04-02T12:10:48.000Z","size":1248,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-02T23:23:43.513Z","etag":null,"topics":["6502","c64","commodore-64","falling-blocks","game-development","homebrew","llvm-mos","retrocomputing"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jlorenzetti.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-09T20:13:03.000Z","updated_at":"2026-04-02T12:10:52.000Z","dependencies_parsed_at":"2026-04-05T00:01:19.254Z","dependency_job_id":null,"html_url":"https://github.com/jlorenzetti/quattro","commit_stats":null,"previous_names":["jlorenzetti/quattro"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/jlorenzetti/quattro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlorenzetti%2Fquattro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlorenzetti%2Fquattro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlorenzetti%2Fquattro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlorenzetti%2Fquattro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jlorenzetti","download_url":"https://codeload.github.com/jlorenzetti/quattro/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlorenzetti%2Fquattro/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31419549,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T20:09:54.854Z","status":"ssl_error","status_checked_at":"2026-04-04T20:09:44.350Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["6502","c64","commodore-64","falling-blocks","game-development","homebrew","llvm-mos","retrocomputing"],"created_at":"2026-04-05T00:00:41.870Z","updated_at":"2026-04-05T00:01:50.588Z","avatar_url":"https://github.com/jlorenzetti.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Quattro\n\nA sober, historically-minded falling-blocks game for Commodore 64, built with contemporary software engineering discipline.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/quattro-demo.gif\" alt=\"Quattro gameplay demo\" width=\"800\"\u003e\n\u003c/p\u003e\n\n**Experimental browser demo:** [Play Quattro](https://jlorenzetti.github.io/quattro/)\n\n## Status\n\n**0.1.0** — first public release. Summary: [`release-0.1.0.md`](docs/notes/release-0.1.0.md). RC verification: [`phase-4-rc-closure.md`](docs/notes/phase-4-rc-closure.md).\n\nThe C64 build runs the full loop (title → start/help with levels 0–9 → play → game over → replay). The host-side core is tested and shared with the C64 build.\n\n## Why\n\nQuattro explores a simple question: what happens when you develop for Commodore 64 as if it were a contemporary platform with extreme constraints — without betraying its identity?\n\nThe answer is not a feature-rich reinterpretation, but a rigorous, minimal, highly playable game built with clear architecture, reproducible builds, careful optimization and obsessive attention to feel.\n\n## Host-side harness\n\nThe host-side harness is intentionally austere: testable, deterministic, and slightly evocative of the Elektronika 60 lineage.\n\n```text\nquattro\nseed 12345\n\nLINES: 0000\nLEVEL: 00\nSCORE: 0000\n\n\u003c! . . . .[] . . . . .!\u003e\n\u003c! . . . .[][][] . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c! . . . . . . . . . .!\u003e\n\u003c!====================!\u003e\n\nA/D MOVE  Z/X ROTATE  SPC DROP  G TICK  Q QUIT\n```\n\n## Current features\n\n- Tested host-side core (deterministic, test-backed)\n- C64 build (llvm-mos, VICE or hardware). Game seed from jiffy time at start; fixed seeds for host tests / debug builds.\n- Title (block wordmark, PRESS ANY KEY) and start/help (level 0–9, RETURN)\n- Gameplay: board frame, HUD (SCORE / LINES / LEVEL), next-piece preview, level-based gravity\n- Game over on field + RETURN AGAIN → start/help\n- SID micro SFX (six one-shots; mute with `QUATTRO_AUDIO=0` — **Building**, [`phase-4-micro-sfx.md`](docs/notes/phase-4-micro-sfx.md))\n- Same rules on host and C64 — [`host-core-contract.md`](docs/host-core-contract.md)\n\n## Building\n\n- **Host / tests:** `make host_debug`, `make test` (standard `cc`).\n- **C64:** `make c64` ([llvm-mos](https://github.com/llvm-mos/llvm-mos) `mos-c64-clang`). Run: `make c64_run` (VICE) or load `build/quattro.prg`. Debug seed: `make c64_fixed_seed` or `make c64 C64_DEFS=\"-DQUATTRO_FIXED_SEED=12345\"`. Silent build: `rm -f build/quattro.prg \u0026\u0026 make c64 C64_DEFS=\"-DQUATTRO_AUDIO=0\"`.\n- **Release artifact (local):** `make release_artifacts` or `make release_artifacts VERSION=v0.1.0` copies the default PRG into `dist/` for attaching to GitHub Releases; `dist/` is local staging (gitignored) — do not commit release binaries.\n- **clangd:** `make compdb` or `make compdb-all` ([Bear](https://github.com/rizsotto/Bear)); generated DBs not committed.\n- **Browser demo (experimental):** Pages deploy from CI — [`README.md`](web-src/README.md).\n\n## Controls (C64)\n\n**Gameplay:** A / D = left / right (repeat when held) · Z / X = rotate CCW / CW · SPACE = soft drop  \n**Setup:** 0–9 = start level · RETURN = start / again after game over  \n**Joystick (port 2):** left / right / down / fire — move / soft drop / rotate ([`input.c`](src/platform/c64/input.c) header).\n\n## Design constraints\n\n- **Toolchain:** llvm-mos; assembly only where profiling justifies it.\n- **Rendering:** character mode; custom charset deferred ([`custom-charset-investigation.md`](docs/notes/custom-charset-investigation.md)).\n- **Core:** C; deterministic PRNG; no 7-bag; CW/CCW rotation; no wall kicks by default.\n- **Scope:** see [`scope.md`](docs/scope.md).\n\n## Documentation\n\n| Kind | Files |\n|------|--------|\n| **Stable / public** | [`scope.md`](docs/scope.md), [`architecture.md`](docs/architecture.md), [`core-spec.md`](docs/core-spec.md), [`roadmap.md`](docs/roadmap.md), [`release-0.1.0.md`](docs/notes/release-0.1.0.md) |\n| **Engineering notes** | [`docs/notes/`](docs/notes/) — input, performance, audio, closure records, investigations |\n| **Contract** | [`host-core-contract.md`](docs/host-core-contract.md) |\n\nChange history: [`CHANGELOG.md`](CHANGELOG.md).\n\n## Repository\n\n| Path      | Purpose                |\n|-----------|------------------------|\n| `docs/`   | Design, spec, roadmap  |\n| `src/`    | Core, platform C64   |\n| `tests/` | Core tests             |\n| `tools/` | Host debug harness     |\n| `web-src/` | Browser demo source  |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjlorenzetti%2Fquattro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjlorenzetti%2Fquattro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjlorenzetti%2Fquattro/lists"}