alondero/automobililamborghini-recomp v0.4.2

Automobili Lamborghini Recompiled v0.4.2

on GitHub

Pre-release quality. Built from main for early testing and feedback. Expect rough
edges — crashes, audio glitches, and missing native translations are still the rule, not
the exception. Please open issues rather than running off the latest commit silently.

⚠️ You must supply your own ROM

This release contains no game assets or code from the original cartridge. It ships
only the recompiled executable. To play, you must obtain a legal copy of
Automobili Lamborghini (USA).z64 (the North American release is the only one
supported) and place it next to the executable before launching. See BUILDING.md
for the full instructions; in brief:

1. Extract the archive for your platform into its own folder.
2. Drop Automobili Lamborghini (USA).z64 into that folder.
3. Launch the binary.

Game saves go alongside the ROM (or under %LOCALAPPDATA%\LamborghiniRecomp on
Windows / ~/.config/LamborghiniRecomp elsewhere — see README.md).

What's working

Game is playable, with upscaled resolution, high FPS, and widescreen (including HUD)
support across all race modes, plus N64 Rumble Pak support. This is a small follow-up
to the v0.4.1 Intel driver advisory (#110): where v0.4.1 shipped a manual escape hatch
that required editing graphics.json, v0.4.2 makes the fix automatic for modern
Intel — affected users no longer need to take any action. There's still glitches so
please report issues you find.

Closed since v0.4.1:

Stability / driver compatibility

• #109 follow-up / PR #113 — Modern Intel GPUs (Iris Xe / Arc) now stay on D3D12
  automatically — no graphics.json edit needed. v0.4.1's patch 0010 only worked
  when the user manually set "api_option": "D3D12"; two more users hit the silent
  black-screen wall before finding the workaround, so this makes it the default. The
  Intel force-Vulkan fallback in RT64 was originally written for 6th-gen HD Graphics
  (which device-remove on D3D12), but it was wrongly catching Gen12 Xe / Arc
  (where D3D12 works fine and it's Vulkan that loses the device). Patch 0010 is
  narrowed to exclude any device whose name contains Xe or Arc — they now keep
  D3D12 by default. Genuine 6th-gen parts still get the Vulkan fallback so there's
  no regression. Two smaller companion changes:

  • Setup-retry: if the renderer was started with an explicit api_option and
    that backend fails to initialise, RT64 now tries the other Windows backend
    once before giving up (it already self-retried for Auto).
  • Name-aware advisory severity: the GPU advisory popup is now device-name
    aware. Modern Intel stuck on Vulkan raises the SEVERE popup (the #109 black
    screen); a 6th-gen part correctly on Vulkan is INFO — no scary popup for a
    case that's actually working.

  LAMBO_FAKE_GPU still works for end-to-end testing without an Intel box.
  README troubleshooting reflects the new automatic behaviour.

What's not done yet

This is still pre-1.0 — plenty of force_stub.txt still includes real game primitives
rather than no-ops. The tracker is the canonical "what's next" list.

Known follow-up: a user who explicitly sets "api_option":"Vulkan" on an
old-driver Iris Xe still hits runtime device-loss (setup succeeds, then
vkQueueSubmit fails mid-render). The default-config path is fully covered by the
narrowing, and that explicit-Vulkan combo still gets the SEVERE advisory popup
instead of a silent black screen — but a full fix needs deeper RT64
present-queue surgery. Tracked in #114.

If you find a crash, please open an issue with lamborghini_crash style notes:

• Output window text (or the crash-*.txt dump if the native handler caught it)
• Commit / build provenance (below)
• Approximate in-game location (title screen / car-select / race lap 2 / etc.)

How to run

Linux

unzip lamborghini-recomp-linux-x64.zip -d lamborghini-recomp
cp "Automobili Lamborghini (USA).z64" lamborghini-recomp/
./lamborghini-recomp/lamborghini_modern

Requires libsdl2-2.0-0 and a Vulkan-capable GPU + driver at runtime. Most
desktop distros ship these already.

Windows

Extract lamborghini-recomp-windows-x64.zip anywhere, drop your ROM in the same
folder, and double-click lamborghini_modern.exe. The bundled SDL2.dll,
dxcompiler.dll, and dxil.dll must stay alongside the EXE.

F11 / Alt+Enter toggles fullscreen (and remembers the choice next launch).

Build provenance

• Commit: 03e533a (main, 2026-07-12)
• Workflow run: #29203966918 (Build & Release, dispatch from this SHA)
• Toolchain: Linux build on ubuntu-latest with gcc / cmake / ninja /
  libsdl2-dev / libvulkan-dev. Windows build on windows-latest with
  MinGW-w64 GCC + Ninja (PowerShell, not MSYS bash) per the project's toolchain
  notes.

If you'd rather build it yourself from source instead of running a pre-built
binary, see BUILDING.md. For graphics settings, see README.md.