Skip to content

TMB_Recomp 0.5.0

Latest

Choose a tag to compare

@github-actions github-actions released this 09 Nov 16:56
404738f

TMB_Recomp 0.5.0

Twisted Metal: Black (USA) as a native PC game, built on your PC from your own disc: nothing of the game is in this download.

What's new

Changed

  • The game's 3D math runs natively. Every inventoried coordinate transform (269 forward and 134 inverse uses)
    now runs as native C++. So do the hierarchy, collision, terrain, particle, camera, weapon and HUD calculations
    built on them; none of them goes through the recompiled vector-unit helper any more. Generated tests compare
    every one against the original arithmetic. Recorded one-player and four-player replays match the previous build
    on every frame's calls, draws, sound and timing. The only differences found were in unused scratch memory.
  • More of the graphics path is native: HUD and menu image builders, mesh shader parameters, screen and weather
    projection, texture inputs and upload completion. The game no longer emits per-object shader packets.
  • BozoEngine is updated to 4a8f70a.

Fixed

  • Rare hang when leaving a menu movie (seen once on vehicle select): a movie could freeze after a long frame, and
    the next menu choice then waited for its decoder forever. The movie player's vblank handler now runs natively.

Developer changes

  • The native-math caller suite covers about 191,000 generated sequences (9,952 whole-memory comparisons). They span
    four rounding modes, denormal flushing, RAM aliases and arbitrary W payloads, with full-owner entries for each
    call site.
  • docs/HANDOFF.md links one qualification document per batch: test coverage, replay comparison and window runs.

Known limits

  • Only the USA disc is supported. Windows is the validated player target; the migrated Linux player build is not yet validated.
  • Full campaign endings, a fresh standard-user Windows installation and four physical controllers still need player/hardware acceptance.
    Widescreen is not implemented; presentation above 60 Hz remains experimental for effects that update at game rate.

Download

  1. TMB_Recomp-0.5.0-bozo.zip below. Check its SHA-256 before running anything:
    Get-FileHash .\TMB_Recomp-0.5.0-bozo.zip (PowerShell) must print

    C1615F5472FF9DDCCAFC3400DA0477AA5FD182A395EB337C5852180EE24BE68C
    

Requires Windows 10 version 1903 or newer (or Windows 11), an AVX2 and FMA capable CPU, and OpenGL 3.3.

  1. Unzip it anywhere you like except Program Files, with about 10 GB free, and double-click TMB Launcher.exe. It is not signed: on Windows protected your PC, click More info, then Run anyway.
  2. Select your USA disc image (SCUS-97101), Prepare the game (a few minutes, once), Play.

For a new/separate installation, use TMB_Recomp-0.5.0-bozo.zip (TMB_Recomp_Bozo/). For an existing v0.3.2 installation, use the launcher's Update, or extract TMB_Recomp-0.5.0.zip over its TMB_Recomp/ installation. Both ZIPs contain the same BozoEngine payload; neither retains the old runtime.
Then Rebuild now when the launcher offers it. Saves and settings stay in %APPDATA%\TMB_Recomp. Subsequent BozoEngine updates use -bozo.zip with either installation folder name.

Build information

  • Code: TheBozos/TMB_Recomp (404738f5908131f8062babcf4e7403abeac070be), BozoEngine 4a8f70a5021cbb3429800a02259ae7b816581ee0
  • Build kit: GCC 16.2.0-6, CMake 4.4.4-3, Ninja 1.13.2-1 (MSYS2 UCRT64), FFmpeg 9.0.2 (LGPL, static), Python 3.14.10
  • TMB_Recomp-0.5.0-bozo.zip: 141.5 MB, SHA-256 c1615f5472ff9ddccafc3400da0477aa5fd182a395eb337c5852180ee24be68c
  • TMB_Recomp-0.5.0.zip: the same BozoEngine build in TMB_Recomp/, for the previous launcher's in-place update; SHA-256 c3fdb56fb8365db9558994fcd7bbeb05d171849edf445f9a7f9df9900b786afe
  • TMB_Recomp-0.5.0-bozo-sources.zip: 452.3 MB, SHA-256 0942b8079767d789ca74759055d5b414db079fa8b8f43f2a2fc60b868b984712

Source code and licences

The code is in the zip (source\) and at the commit above: our own code and BozoEngine (the recompiler and runtime it is built on) under the MIT licence. The build kit redistributes unmodified GPL / LGPL programs (GCC, binutils, mingw-w64, the DLLs CMake loads) and FFmpeg (LGPL-2.1+): LICENSES\ in the zip has their licences, and LICENSES\SOURCES.txt lists each package with its exact source on repo.msys2.org. Their corresponding source is attached to this release as TMB_Recomp-0.5.0-bozo-sources.zip. For three years from this release we also provide it on request (GitHub issues).

Twisted Metal: Black © Sony Interactive Entertainment, developed by Incognito Entertainment. An unofficial fan project by The Bozos (boubou666 & Arzaroth), not affiliated with or endorsed by them.