automobililamborghini-recomp

KO | EN

gitlite — search

#windows #ai-agent #computer-vision #security #machine-learning #postgresql #github #typescript #claude #awesome

automobililamborghini-recomp

(★ 33)

Static Recompilation of Automobili Lamborghini for the N64

File Explorer

ZIP Download

- hookify.warn-new-patch-needs-build-sync.local.md
- - bug_report.md
  - feature_request.md
- - build-release.yml
- PULL_REQUEST_TEMPLATE.md
- - lambo.rcss
  - launcher.rml
  - settings.rml
- - 83-3p4p-fog-widening-before-after.png
  - 84-3p4p-sky-before-after.png
  - hud-2p-split-before-after.png
  - hud-3p4p-split-widescreen-before-after.png
  - hud-56-2p-minimap-before-after.png
  - hud-67-geometry-before-after.png
  - hud-78-quad-text-before-after.png
  - hud-time-trial-before-after.png
- analog-brake.md
- analog-throttle.md
- HUD.md
- no_lod_audit.md
- rumble-triggers.md
- TEXTURES.md
- TRACK_INDEX.md
- N64ModernRuntime
- RmlUi
- rt64
- 0001-lamborghini-runtime-scheduler-audio-vi.patch
- 0004-plume-d3d12-mingw-com-abi-struct-return.patch
- 0005-rt64-mingw-gcc-compat.patch
- 0006-rt64-interp-angular-velocity-matching.patch
- 0007-ultramodern-savestate-thread-context-relink.patch
- 0008-rt64-skybox-stretch-parallaxless-backdrop.patch
- 0009-rt64-widescreen-split-subviewport.patch
- 0010-rt64-intel-explicit-d3d12-escape-hatch.patch
- 0011-rt64-fov-independent-backdrop.patch
- 0012-n64modernruntime-lazy-rdram-commit.patch
- gen_syms_toml.py
- n64recomp_race.toml
- InterfacePS.hlsl
- InterfaceVS.hlsl
- - lambo_controls.cpp
  - lambo_controls.h
  - lambo_controls_sdl.cpp
  - lambo_controls_sdl.h
- - lambo_ui.cpp
  - lambo_ui.h
  - lambo_ui_controls.cpp
  - lambo_ui_controls.h
  - lambo_ui_input.cpp
  - lambo_ui_input.h
  - lambo_ui_render_interface.cpp
  - lambo_ui_render_interface.h
  - lambo_ui_settings.cpp
  - lambo_ui_settings.h
  - rt64_render_interface_builders.h
- app.manifest
- lambo_analog_brake.cpp
- lambo_analog_brake.h
- lambo_analog_throttle.cpp
- lambo_analog_throttle.h
- lambo_audio.cpp
- lambo_audio.h
- lambo_camera.cpp
- lambo_camera_projection.h
- lambo_config.cpp
- lambo_config.h
- lambo_crash.cpp
- lambo_crash.h
- lambo_flare_widescreen.c
- lambo_fog_widescreen.cpp
- lambo_gpu_advisory.cpp
- lambo_gpu_advisory.h
- lambo_hud_widescreen.c
- lambo_hud_widescreen.h
- lambo_input_gate.cpp
- lambo_input_gate.h
- lambo_log.cpp
- lambo_log.h
- lambo_manifest.rc
- lambo_menu.cpp
- lambo_menu.h
- lambo_no_lod.cpp
- lambo_player_name.cpp
- lambo_player_name.h
- lambo_rt64.h
- lambo_savestate.c
- lambo_sky_widescreen.cpp
- lambo_startup.cpp
- lambo_startup.h
- lambo_warp.c
- libultra_stubs.c
- main.cpp
- mingw_dx12_uuid_compat.h
- register_overlays.cpp
- rt64_renderer.cpp
- stub_renderer.cpp
- test_analog_brake.cpp
- test_analog_throttle.cpp
- test_camera_projection.cpp
- test_controller_pak.c
- test_controls.cpp
- test_controls_capture.cpp
- test_controls_sdl.cpp
- test_crash_whitelist.cpp
- test_gpu_advisory.cpp
- test_hud_bracket_pairing.c
- test_hud_shift_scale.c
- test_input_gate.cpp
- test_live_config.cpp
- test_quit_path.py
- test_rdram_allocation.cpp
- test_startup.cpp
- test_ui_assets.py
- test_ui_controls.cpp
- test_ui_input.cpp
- test_ui_settings.cpp
- - ares_debug_client.py
  - ares_session.py
  - decode_framebuffer.py
  - diff_rdram_regions.py
  - dump_memory.py
  - dump_memory2.py
  - input_auto.lua
  - measure_ares_state_dwell.py
  - probe_analog_brake.py
  - probe_analog_throttle.py
  - rdp_trace.lua
  - rdram_dump.lua
  - run_ares_debug.py
- decode_dump.py
- drive_input.py
- make_pack.py
- probe_lod_patch.py
- pvs_distance_audit.py
- scan_lod_patterns.py
- test_decode_dump.py
- trace_analyst.py
.gitignore
.gitmodules
aspMain.us.toml
build.ps1
build.sh
BUILDING.md
CLAUDE.md
CMakeLists.txt
CONTRIBUTING.md
dump.toml
force_stub.txt
lamborghini.syms.toml
lamborghini.us.toml
LICENSE
README.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A native PC port of the Nintendo 64 game **Automobili Lamborghini** (USA), produced by *static recompilation* of the original game code. The N64 machine instructions are translated ahead-of-time into C with [N64Recomp](https://github.com/N64Recomp/N64Recomp), run on the [N64ModernRuntime](https://github.com/N64Recomp/N64ModernRuntime) libraries (`ultramodern` + `librecomp`), and rendered with [RT64](https://github.com/rt64/rt64).

This is the same approach used by many recent N64 recompilation projects such as [Snowboard Kids 2 Recompiled](https://github.com/cdlewis/snowboardkids2-recomp), [Smash Bros Recompiled](https://github.com/zestydevy/smash64r), [Bomberman 64 Recompiled](https://github.com/RevoSucks/BM64Recomp).

## Legal

**This repository contains no game assets or code from the original ROM.** It ships only the recompilation configuration, the runtime/renderer glue code, and a symbol map (function names and addresses recovered by reverse engineering — no ROM bytes).
To build or run the port you must supply your own copy of the original cartridge dump.
Only the **North American (USA) release** is currently supported. The build reads code directly from your ROM to regenerate the recompiled C; that output (`RecompiledFuncs/`) is deliberately git-ignored and never committed.

## Status

This is an in-progress port. It boots, presents the attract/title sequence and menus, and goes in-race. Input, audio, and rendering are wired through RT64. Expect rough edges — see the issue tracker.

## Graphics options

Graphics settings persist in `graphics.json` (in `%LOCALAPPDATA%\LamborghiniRecomp` on
Windows, `~/.config/LamborghiniRecomp` elsewhere; create a `portable.txt` in the
directory you launch from to keep everything there instead). Game saves live in the
same directory. The file is created with
defaults on first run. On Windows, the **Graphics** and **Enhancements** menu-bar menus
apply the commonly used options immediately and save them automatically. The graphics API
selection is also in the menu but takes effect on the next launch because RT64 creates the
backend at startup. Advanced settings (texture paths and per-circuit numeric overrides) remain
available by editing the file and relaunching. The schema and vocabulary match the other
N64Recomp ports (Zelda 64: Recompiled et al.):

| Key | Values | Default | Meaning |
| --- | --- | --- | --- |
| `res_option` | `Original`, `Original2x`, `Auto` | `Auto` | Internal render resolution. `Auto` scales with the window size; `Original`/`Original2x` render at 1×/2× of 240p, each supersampled by the `ds_option` factor. |
| `ar_option` | `Original`, `Expand`, `Manual` | `Expand` | Aspect ratio. `Expand` widens the 3D view to the window's aspect (true widescreen, not stretch). |
| `hr_option` | `Original`, `Clamp16x9`, `Full` | `Clamp16x9` | Where edge-pinned HUD elements sit in widescreen (takes effect as HUD elements gain extended-GBI alignment). |
| `rr_option` | `Original`, `Display`, `Manual` | `Display` | Presented framerate. `Display` renders RT64-interpolated frames at the monitor refresh rate — game logic stays at its native 30Hz. `Manual` uses `rr_manual_value`. |
| `msaa_option` | `None`, `MSAA2X`, `MSAA4X`, `MSAA8X` | `MSAA2X` | Anti-aliasing. |
| `hpfb_option` | `Auto`, `On`, `Off` | `Auto` | High-precision framebuffer. |
| `wm_option` | `Windowed`, `Fullscreen` | `Windowed` | Window mode. **F11** or **Alt+Enter** toggles at runtime (and is remembered). |
| `window_width` / `window_height` | pixels | `1600`/`900` | Windowed-mode size. |
| `api_option` | `Auto`, `D3D12`, `Vulkan`, `Metal` | `Auto` | Graphics API. |
| `texture_pack` | path to a directory or `.rtz` | `""` | Loads one native RT64 texture pack at startup. An empty value keeps the original textures. |
| `texture_dump` | directory path | `""` | Dumps each texture used during play as RT64 TMEM/RDRAM data for pack authors. |
| `widescreen_fog_match` | `true`, `false` | `true` | Widens the dense 3P/4P split-screen fog to the open 1P fog window/colour so the extra draw distance shows. Only affects 3+ player races. |
| `widescreen_sky_match` | `true`, `false` | `true` | Draws the sky panorama in 3P/4P split screen (the original skips it, leaving a flat dark backdrop above the horizon). Only affects 3+ player races. |
| `no_lod` | `true`, `false` | `true` | Removes the ROM's draw-distance reductions: the per-mode scenery-layer skip and the trimmed per-segment visibility lists, with reach then governed by `draw_distance` instead of the N64 fill-rate budgets. `false` restores the N64-authored behaviour entirely. |
| `fog_scale` | `0.0`–`8.0` | `1.0` | Fog density multiplier. `1.0` = authored fog, `0.0` = no fog; values in between thin the fog uniformly without moving where it starts. |
| `fog_scale_circuit` | array of 6 numbers | `[1,1,1,1,1,1]` | Per-circuit fog multipliers (multiplied with `fog_scale`), e.g. clear a single hazy track by lowering its entry. |
| `draw_distance` | `0` or `0.1`–`100` | `1.5` | Multiplier on the authored per-circuit draw-distance radii (needs `no_lod`). `1.0` = the N64 distances, higher = see further, `0` = unlimited — note that unlimited draws distant track pieces the artists never meant to be visible (they float with nothing in between). |
| `draw_distance_circuit` | array of 6 numbers | `[1,1,1,1,1,1]` | Per-circuit draw-distance multipliers (multiplied with `draw_distance`), e.g. extend just one short-sighted city track. |
| `camera_fov_add` | `-20`–`60` degrees | `0` | Degrees added to each camera layout's authored field of view (sense-of-speed effect). The scene builder's view-cone cull widens to match, so higher values do not cause peripheral pop-in. Also settable live from the Enhancements menu. |
| `show_launcher` | `true`, `false` | `false` | When `false`, the game auto-boots directly into gameplay with the in-game configuration overlay available during play. When `true`, presents the standalone launcher shell at boot. Overridable via `LAMBO_LAUNCHER=1/0`. |

## Texture packs

The port supports native RT64 replacement packs as either a loose development directory
or a packaged `.rtz` file. Set `texture_pack` in `graphics.json` to the pack path and
restart the game. The pack is optional and layered over the original textures; removing
the setting restores the stock artwork.

Texture-pack support is deliberately separate from any particular replacement artwork.
This repository does not ship an HD or readable-text pack, so those packs can be created,
versioned, and distributed independently. `.o2r` and legacy Rice packs use different
resource identities and are not directly interchangeable with this port's RT64 packs.

Pack authors can dump the textures encountered during a run without changing the saved
configuration:

```powershell
$env:LAMBO_TEXTURE_DUMP = 'C:\path\to\dump'
.\lamborghini_modern.exe
```

On Linux, use `LAMBO_TEXTURE_DUMP=/path/to/dump ./lamborghini_modern`. Exercise every
menu, HUD, vehicle, and track that the pack should cover because dumping is runtime-driven.
See **[Texture packs](./docs/TEXTURES.md)** for decoding the dump, authoring replacements,
generating `rt64.json`, testing a loose pack, and packaging it as `.rtz`.

## In-Game Configuration & Controls

- **Configuration Overlay**: Press the **Menu / Back / Start / Guide** button on your controller, or press <kbd>Esc</kbd> / <kbd>F1</kbd> on your keyboard (or use the native window menu `Game -> Settings` / `Controls`) to open the in-game configuration overlay at any time.
- **Controls Remapping**: The **Controls Mapper** provides a 4-column N64 controller mapping interface for all digital buttons, triggers, C-buttons, D-Pad, and analog stick axes. Custom mappings persist per physical controller (by SDL GUID) in `%LOCALAPPDATA%\LamborghiniRecomp\controls.json` (or `~/.config/LamborghiniRecomp/controls.json`).

## Troubleshooting

**Black screen / `vkQueueSubmit failed` spam on Intel graphics.** Intel drivers
older than 31.0.101.2115 trip an RT64 workaround that avoids Direct3D 12; on the
6th-gen HD Graphics parts it was written for, D3D12 removes the device, but on newer
Intel GPUs (Iris Xe, Arc) stuck on an old driver it is the Vulkan fallback that loses
the device. The game now keeps those modern Intel GPUs on Direct3D 12 automatically,
so this should no longer happen out of the box — but the real fix is still to update
the Intel graphics driver (Windows Update or
[intel.com/download-center](https://www.intel.com/content/www/us/en/download-center/home.html)).

**Still a black screen, or a different GPU?** Force a specific backend by setting
`"api_option"` in `graphics.json` to `"D3D12"` or `"Vulkan"`. On Windows the game also
retries the other backend automatically if your chosen one fails to initialise, so a
bad `api_option` no longer strands you on a black screen.

## Developer warp (race-track warp)

For development it is useful to jump straight into a race without driving the menus
(the same pattern as the debug warp menus in other N64Recomp ports):

- **F1–F6** at any time after boot warps to that circuit as a 1-player single race
  (3 laps, first car).
- **`LAMBO_WARP=circuit[:laps[:car[:players]]]`** (environment variable, circuit `1`–`6`)
  performs the warp automatically at boot — handy for headless/scripted runs.

The warp performs the same stores the game's own menu makes when you confirm RACE
(selection cursors + audio quiesce + game-state 7), so the race it starts is a normal
single race. Each warp is logged to stderr as `[warp] CIRCUIT N: ...`.

## Building

See **[BUILDING.md](./BUILDING.md)**. In brief: clone with submodules, supply your ROM, run the recompile step, then configure and build with CMake.

## Acknowledgements

- **Wiseguy** and contributors — [N64Recomp](https://github.com/N64Recomp/N64Recomp) and [N64ModernRuntime](https://github.com/N64Recomp/N64ModernRuntime).
- The **RT64** team — [RT64](https://github.com/rt64/rt64) renderer.
- The **Zelda64Recomp** project, whose CMake wiring served as the template for this one.

## License

The code original to this repository is released under the [GNU General Public License v3.0](./LICENSE), matching the wider N64Recomp port ecosystem (e.g. Zelda 64: Recompiled and Snowboard Kids 2: Recompiled). The vendored submodules (`lib/N64ModernRuntime`, `lib/rt64`) and any patched dependencies retain their own respective licenses.

automobililamborghini-recomp

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

automobililamborghini-recomp

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README