Konami Viper Recomp

Konami Viper Recomp is a native PC port of Konami's Thrill Drive 2 and GTI Club 2 arcade games with enhanced graphics and multiplayer.

README

Konami Viper — static recompilation

Native PC ports of Konami's Viper arcade games: Thrill Drive 2 and GTI Club 2 (GTI Club: Corso Italiano / Driving Party: Racing in Italy).

The original PowerPC code is statically recompiled into C, so the game runs as native code on your machine. A small shared runtime reimplements the arcade board: Voodoo3 graphics, sound, I/O, CF card and timekeeper. This is not an emulator.

No game files are included. You build the ports from your own dumps of the game and of the board BIOS (see Required files).

Download and play

The releases have packages for Windows x86-64, Linux x86-64 and macOS on Apple Silicon, with nothing else to install. They hold no game code: they build the ports on your computer from your own dumps, in about a minute, the first time only.

  1. Extract the package and copy your files into its roms/ folder, in any layout: loose files or MAME's zips, and the CHD folders.
  2. Run the setup, which checks your files and builds every game it can:
    • Windows: double-click viper-setup.exe. It is not signed, so Windows may show "Windows protected your PC": "More info", then "Run anyway".
    • Linux and macOS: open a terminal in the package's folder (where viper-setup is) and run ./viper-setup (or ./viper-setup --roms /path/to/your/roms). On macOS, once before: xattr -dr com.apple.quarantine . (the package is not signed by Apple, and macOS blocks its programs until then).
  3. Play: td2.exe, gticlub2.exe, ... on Windows (a double-click is enough), ./td2, ./gticlub2, ... on Linux and macOS. After an update, or on another computer, run the setup again.

RecompLauncher can do all of this for you: pick your folder of MAME files, and it builds the games and starts them, with one tile each. You can also build from the sources.

Two ways to play

Enhanced: like a PC game
./td2

The default, also when you double-click the executable. Menus, options and pause instead of coins and operator menus: resolution up to 4X (1440p), widescreen up to 21:9, graphics drawn by the GPU, course difficulty, language, extra modes with new rules, and multiplayer over the Internet.

Thrill Drive 2, enhanced mode at 16:9: main menu with START GAME, EXTRA, MULTIPLAYER, OPTIONS, CREDITS, QUIT over the attract mode Thrill Drive 2, enhanced mode at 16:9: DISPLAY options with window mode, 2X resolution, 16:9 aspect ratio, texture filter, renderer and fps counter Thrill Drive 2, enhanced mode at 16:9: pause menu during a race in London
GTI Club 2, enhanced mode at 16:9: main menu over a demo race GTI Club 2, enhanced mode at 16:9: EXTRA page with GRAVITY, SPEED, PASS THE BOMB and ELIMINATION GTI Club 2, enhanced mode at 16:9: pause menu during a race

Thrill Drive 2 (top) and GTI Club 2 (bottom) in enhanced mode, 2X resolution, 16:9.

Classic: the arcade cabinet
./td2 --classic

The game as on the original cabinet: insert coins and press START; the original attract mode, rankings and TEST MODE; 30 fps and the original sound.

Thrill Drive 2 racing across a bridge in London GTI Club 2 attract mode in an Italian coastal town

On first launch the game calibrates the steering wheel and pedals by itself, as an operator would, in a few seconds. The two modes keep separate saves. The options, the comparison of the two modes and the saves are described in the guide.

Games

GameVersionMAME setExecutableStatus
Thrill Drive 2 (2001)EBB (Europe)thrild2./td2Playable
Thrill Drive 2JAA (Japan)thrild2j./td2jBoots and races
Thrill Drive 2AAA (Asia)thrild2a./td2aBoots and races
GTI Club: Corso Italiano (2000)JAB (Japan)gticlub2./gticlub2Playable
Driving Party: Racing in Italy (2000)EAA (Europe)gticlub2ea./gticlub2eaBoots and races

"Boots and races" means tested with scripted inputs but not yet played by hand. Notes on each version are in the guide.

Required files

The MAME sets: the Viper BIOS kviper plus the games you want.

kviper/        941b01.u25, ds2430.u3             Viper BIOS, shared by every game
thrild2/       a41b02.chd, a41ebb_nvram.u39      Thrill Drive 2 (ver EBB)
thrild2j/      a41a02.chd, a41jaa_nvram.u39      Thrill Drive 2 (ver JAA)
thrild2a/      a41a02.chd, a41aaa_nvram.u39      Thrill Drive 2 (ver AAA)
gticlub2/      941b02.chd, 941jab_nvram.u39      GTI Club: Corso Italiano (ver JAB)
gticlub2ea/    941a02.chd, 941eaa_nvram.u39      Driving Party: Racing in Italy (ver EAA)

The files are checked by their SHA1 before the build; the list is in the guide.

Controls

ActionKeyboardGamepad
Steer← / → or A / DLeft stick or D-pad
Accelerator↑ or WR2 (or A)
Brake↓ or SL2 (or X)
Handbrake (classic: only GTI Club 2 JAB, TD2 JAA/AAA)SpaceB
Shift up / downE / QR1 / L1
Start1Start
Change view (in a race, as on the cabinet)1 (Start)Start
Menus (enhanced)Arrows or WASD, Enter or 1, BackspaceD-pad, A or Start, B
Pause (enhanced)EscBack or Guide
Ranking name (enhanced)Type it; Backspace, Enter ends; ← / → browseD-pad ← / →, then R2
Insert coin (classic)5Back
Test / Service (classic)F2 / 9—
FullscreenF11—
QuitEsc (enhanced: Esc in the main menu, or QUIT)Guide, as Esc

Extra modes

EXTRA in the main menu (enhanced mode) starts a race with different rules, in every version:

ModeGameRules
GravityGTI Club 2Every 10 seconds the gravity turns light or heavy (0.1 to 4 G), with moments at zero G where the cars float off the road.
SpeedBothA bomb arms itself at 50 km/h (30 mph) and goes off after 2 seconds below it. In Thrill Drive 2 you drive the bus.
Pass the bombGTI Club 2A car carries a bomb: touch another car to pass it on. When it explodes, that car burns and stops for 4 seconds.
EliminationGTI Club 2Every 45 seconds the last car is out. The goal is only a checkpoint until one car is left; the winner goes on to the next course.
PoliceThrill Drive 2You drive the police car and the CPU cars are on the run: stay right on one for 3 seconds to arrest it.

More in the guide.

Multiplayer

Up to four players race together over the Internet, as linked cabinets did (enhanced mode).

  • Host: MULTIPLAYER → HOST A GAME, then send the 7-character session code to the others.
  • Join: MULTIPLAYER → JOIN A GAME, then type or paste the code.
  • Same version for everyone: all players run the same executable (for example ./td2 with ./td2, not with ./td2j) from the same release of the port. Different versions do not race together.

No server and nothing to install: the host's game opens its port on the router by itself. If the router does not allow it, the lobby says so: open UDP port 24700 by hand to host. More in the guide.

Build from the sources

On macOS and Linux. On Windows, use the package.

  1. Install the tools: a C/C++ compiler, make, Python 3 and SDL2.

    • macOS, with Homebrew and Xcode's command-line tools: brew install sdl2
    • Debian/Ubuntu: sudo apt install build-essential python3 libsdl2-dev
  2. Add your files: the BIOS into roms/kviper/, each game into the folder of its MAME set, for example roms/thrild2/. Each folder has a README.txt with the files it expects.

  3. Build (extract, recompile and compile, about a minute):

    make -j8 game GAME=thrild2
    

    This makes ./td2, the executable named in the Games table.

The separate steps, several games side by side and cleaning up are in the guide.

Documentation

  • docs/GUIDE.md: the enhanced mode's options, saves and command-line options, notes on each version, the files and their SHA1, the build in detail, the repository layout.
  • docs/ARCHITECTURE.md: boot chain, file formats, recompiler and runtime design, reverse-engineering notes.
  • CHANGELOG.md: the changes between versions.

Support the project

If you enjoy the ports and want to support the work on the recompiler, the runtime and the fixes sent back to MAME, you can sponsor me on GitHub (also from SUPPORT in the enhanced mode's main menu). It is entirely optional: it supports the development work only, buys no game or game file, and gives no access to builds or features. The project stays free, and the same for everyone.

Legal

  • This is an unofficial, non-commercial fan project for preservation and research. It is not affiliated with, endorsed by, or sponsored by Konami.
  • Voluntary sponsorships support the development of this project's own code. Nothing is sold, and no game, game file or build is offered in exchange.
  • "Konami", "Thrill Drive", "GTI Club" and "Driving Party" are trademarks of Konami Group Corporation. All other trademarks belong to their owners.
  • This repository contains no copyrighted game code, ROM, BIOS, CHD or NVRAM data. The build extracts the game from files you supply (that must be dumped from your own hardware) and translates it locally. The screenshots in docs/images/ were captured from the ports and are included only to illustrate the project.
  • You may use this project only with dumps you are legally entitled to use, for example dumps of hardware you own. Do not ask for game files in this project's issues or discussions, and do not link to them.
  • Do not redistribute anything the build produces from the game data: work/, generated/, the executables (td2, td2j, gticlub2, …) and the *_nvram.bin files. The release packages follow the same rule: they contain only this project's code, the third-party code below and a C compiler, and the games are built on the player's computer.
  • License: the original code in this repository is released under the BSD-3-Clause license. The license covers only this project's code. It grants no rights to the games.
  • Third-party code: runtime/voodoo/ contains the 3dfx Voodoo emulation core, poly.h and rgbutil from MAME, under the BSD-3-Clause license, with its copyright belonging to its original authors (see the header of each file). Some device logic in runtime/hw.c follows MAME's implementations (the M48T58 timekeeper, the Konami K056230 LANC and konami/viper.cpp), also under BSD-3-Clause; MAME is used here as a hardware reference. The libraries in third_party/ are listed, with their licenses, in third_party/README.md.
  • The software is provided "as is", without warranty of any kind.