v0.4.0-beta.3

Unofficial native ports of Capcom's CPS-2 (and CPS-1) arcade games, in one download with one launcher. No game
is included: you need your own ROM sets (which ones).

Download

Your system	Download
macOS 13 or later, Apple silicon or Intel	CPS2Recomp-macOS.zip
Windows 10 or 11, 64-bit	CPS2Recomp-windows-x64.zip
Linux x86_64, Steam Deck, Steam Machine	CPS2Recomp-linux-x86_64.tar.gz

SHA256SUMS.txt has the downloads' checksums. The update-*.txt files are what the launcher reads to update
itself; you don't need them.

Install

macOS

1. Open the zip: it gives CPS-2 Recomp.app. Move it to your Applications folder (it updates itself, so it
   must be somewhere it can write, not left in Downloads' unzipped folder).
2. The app is not notarized by Apple, so the first time: right-click it and choose Open, then Open. If
   macOS only offers Done or Move to Trash, choose Done, then open System Settings → Privacy &
   Security, scroll down and press Open Anyway next to "CPS-2 Recomp".
3. On the Games page, press Choose folder… and pick the folder with your ROM sets. Press Play beside a
   game.

Windows

1. Right-click the zip, choose Extract All…, and extract it to a folder of your own (for example
   Documents\Games), not Program Files: the launcher updates itself and needs to write there.
2. In the CPS2Recomp folder, open cps2recomp-launcher.exe. The programs are not signed, so the first time
   Windows may say it protected your PC: press More info, then Run anyway.
3. On the Games page, press Choose folder… and pick the folder with your ROM sets. Press Play beside a
   game.

Linux

1. Unpack it where it can stay: tar xzf CPS2Recomp-linux-x86_64.tar.gz -C ~/Applications (any folder of your
   own works).
2. Run ~/Applications/CPS2Recomp/cps2recomp-launcher. It needs only an X11 or Wayland desktop and the usual
   sound libraries (SDL 3 is built in).
3. On the Games page, press Choose folder… and pick the folder with your ROM sets. Press Play beside a
   game.

Steam Deck and Steam Machine

1. Hold the power button and choose Switch to Desktop.
2. Download the Linux file. In the file manager (Dolphin), right-click it, choose Extract → Extract archive
   here, and move the CPS2Recomp folder where it can stay (for example a new Applications folder in your
   home folder).
3. Put your ROM sets in one folder on the device (from a USB stick or the SD card, say).
4. In the CPS2Recomp folder, open cps2recomp-launcher. On the Games page, press Choose folder… and
   pick that folder.
5. On each game's page, press Add to Steam. It adds the game to your library, and the first time also
   CPS-2 Recomp (the launcher).
6. Go back with Return to Gaming Mode on the desktop. The games are in your Library under Non-Steam.

In a game, Esc or F1 (on a gamepad, a click of the left stick, or Start and Select together) opens the in-game
menu. Its Quit game row ends the game.

Update

The launcher checks for a new version when it opens and offers it at the top of the Games page: Update
downloads it, checks it and starts the new version. Or download this release and put it in place of the old app
or folder. Your settings, save states and ROM sets are kept either way: they are in your own user folder.

What's new in 0.4.0-beta.3

• Another game: Street Fighter Alpha (games/sfa; ROM set sfa, Street Fighter Alpha: Warriors' Dreams,
  Europe 950727). Its 68000 program and its sound program (driver 1.05A) translated whole, checked block by block
  over the ladder and versus movies; with free play, straight to the title, the board's settings (Board page), cheats
  (no damage for each player, one-hit knockouts, infinite time), save states, run-ahead, arcade timing and a custom
  soundtrack (its songs named by number for now). Its sources are its own: Alpha 2 is not made from its program (the
  routines Alpha 2's sources hook are mostly not in this game), so no training mode, alternative modes, widescreen or
  custom colours yet.
• macOS: SDL 3.4.16 or later for a build from source (CMake asks for it; docs/BUILDING.md). SDL 3.4.14 (Homebrew's
  until recently) leaves every game's window black while the game runs and sounds: its Metal GPU device takes a
  frame's fence still being worked on for one signalled, so the swapchain's pictures after the first few are all
  skipped (SDL 3.4.16: "Fixed the SDL_QueryGPUFence() return value on Apple platforms"). Release builds compile 3.4.16
  themselves and were not affected. Linux and Windows are unchanged.
• A release has only its three downloads, their checksums and three small update lists (it had a file for
  every file of every download too, 46 more). The launcher's Update now downloads the system's download
  itself, checks it, and puts in place what changed (recomp-common 91b4e51; update-<system>.txt names the
  archive, tools/release/lib.sh). A launcher of 0.4.0-beta.2 can't update itself to this version (it reads
  only the old lists and says the list of files could not be read): download it by hand once, and later versions
  come through Update again.
• Each release's page says how to install it on macOS, Windows, Linux and the Steam Deck and Steam Machine,
  above its changes (tools/release/notes.sh, used by the release workflow).

v0.4.0-beta.2

Unofficial native ports of Capcom's CPS-2 (and CPS-1) arcade games, in one download with one launcher. No game
is included: you need your own ROM sets (which ones).

Download

Your system	Download
macOS 13 or later, Apple silicon or Intel	CPS2Recomp-macOS.zip
Windows 10 or 11, 64-bit	CPS2Recomp-windows-x64.zip
Linux x86_64, Steam Deck, Steam Machine	CPS2Recomp-linux-x86_64.tar.gz

SHA256SUMS.txt has the downloads' checksums. The update-*.txt files are what the launcher reads to update
itself; you don't need them.

Install

macOS

1. Open the zip: it gives CPS-2 Recomp.app. Move it to your Applications folder (it updates itself, so it
   must be somewhere it can write, not left in Downloads' unzipped folder).
2. The app is not notarized by Apple, so the first time: right-click it and choose Open, then Open. If
   macOS only offers Done or Move to Trash, choose Done, then open System Settings → Privacy &
   Security, scroll down and press Open Anyway next to "CPS-2 Recomp".
3. On the Games page, press Choose folder… and pick the folder with your ROM sets. Press Play beside a
   game.

Windows

1. Right-click the zip, choose Extract All…, and extract it to a folder of your own (for example
   Documents\Games), not Program Files: the launcher updates itself and needs to write there.
2. In the CPS2Recomp folder, open cps2recomp-launcher.exe. The programs are not signed, so the first time
   Windows may say it protected your PC: press More info, then Run anyway.
3. On the Games page, press Choose folder… and pick the folder with your ROM sets. Press Play beside a
   game.

Linux

1. Unpack it where it can stay: tar xzf CPS2Recomp-linux-x86_64.tar.gz -C ~/Applications (any folder of your
   own works).
2. Run ~/Applications/CPS2Recomp/cps2recomp-launcher. It needs only an X11 or Wayland desktop and the usual
   sound libraries (SDL 3 is built in).
3. On the Games page, press Choose folder… and pick the folder with your ROM sets. Press Play beside a
   game.

Steam Deck and Steam Machine

1. Hold the power button and choose Switch to Desktop.
2. Download the Linux file. In the file manager (Dolphin), right-click it, choose Extract → Extract archive
   here, and move the CPS2Recomp folder where it can stay (for example a new Applications folder in your
   home folder).
3. Put your ROM sets in one folder on the device (from a USB stick or the SD card, say).
4. In the CPS2Recomp folder, open cps2recomp-launcher. On the Games page, press Choose folder… and
   pick that folder.
5. On each game's page, press Add to Steam. It adds the game to your library, and the first time also
   CPS-2 Recomp (the launcher).
6. Go back with Return to Gaming Mode on the desktop. The games are in your Library under Non-Steam.

In a game, Esc or F1 (on a gamepad, a click of the left stick, or Start and Select together) opens the in-game
menu. Its Quit game row ends the game.

Update

The launcher checks for a new version when it opens and offers it at the top of the Games page: Update
downloads it, checks it and starts the new version. Or download this release and put it in place of the old app
or folder. Your settings, save states and ROM sets are kept either way: they are in your own user folder.

What's new in 0.4.0-beta.2

• Vampire Savior Definitive no longer sometimes draws a screen of wrong tiles: the scroll screens looked up
  whether a tile was the extra set's at the graphics' offset instead of the map's place, reading past the end of
  that list (video/video.cpp, DrawScroll; the CPS-1 games' tile offset had taken the map base's name).

• Ring out, in Street Fighter Alpha 2 and the Vampire Savior games: a fighter knocked over the end of the stage
  is thrown back with the game's own knock-down animation (and in Street Fighter Alpha 2 its cry), and falls
  through the floor and out of the picture (before, its picture slid down); it is out as soon as it is past where
  the board would have stopped it, while still in sight. The winner jumps off, and at the top of its jump goes on
  in the next match as it was (place, picture, speeds): the camera follows it down past the old stage to the next
  one's floor, the winner in front of both, and it lands as from any jump. (Vampire Savior's way down faded
  through black; it is the same as Street Fighter Alpha 2's now.) The winner no longer stands about waiting for the
  next match: each match and stage after the first is begun from a machine kept at the character choice (about 500
  frames to its round, not 2,000 from switching on), and made ready twice as fast while the one out falls. In Street
  Fighter Alpha 2 the player's colours stay the ones chosen from match to match (they went back to the first set). Each
  match begun from the character choice is given a random number of its own, so the computer's choices do not repeat
  from one match to the next.

• The fighting modes in the toolkit (fight/battle.h): survival, the endless battle and the ring out, one
  copy for every fighting game, which describes its memory and makes the ring out's two movements at its players'
  step (games/sfa2/src/player.cpp, PlayerFighting; games/vampire_savior/src/battle.cpp, RingOutStep from the
  player step hook). The camera may be held beyond a stage's ends (CameraWanted::beyondEnds).

• Updates in the launcher: it checks this repository's releases when it opens and offers a newer version at the
  top of the Games page; Update downloads only the files that changed (a new game: its program and the
  launcher), checks each against the release's SHA-256, puts them all in place or none, and starts the new launcher
  (recomp-common 1ea2766, launcher/src/update.h). The release scripts write what it reads: each system's
  update-<system>.txt and every file gzipped under its SHA-256 (tools/release/lib.sh, update_files;
  docs/RELEASING.md). The first release with them is the first a launcher can update to: a copy older than this
  feature is updated by hand once.

• Vampire Savior Definitive (beta; games/vsav_definitive; ROM sets vsavj and vsav2): Vampire Savior with
  Donovan, Phobos and Pyron taken from Vampire Savior 2 (its code, pictures and sounds), all eighteen characters
  by Vampire Savior's rules. At the character choice the three have places of their own, a row under the grid
  with their faces (and the Definitive page of the in-game menu);
  the training mode, the modes and the model viewer have them; the arcade goes to its end with them. The launcher
  gives it the vsav2 set chosen on Vampire Savior 2's page (recomp-common 568e39f, Launch::file_of; --rom2).
  How: an extra ROM set mapped from A00000 (game.cfg's extra_set), objects and scroll tiles drawn from its
  graphics, a second sound side with its sound program and samples (machine/sound_board.h), and tools/graft.py
  with the game's graft.cfg (tables by character, extend, mask, divert, ram, patch). Not yet: Donovan's
  stage and Vampire Savior 2's music.

• Hooks are numbered in 16 bits (from the 256th on they went to the wrong hooks).

• Two beat-'em-ups for three players: Alien vs. Predator and Cadillacs and Dinosaurs (games/avsp, ROM set
  avspu, USA 940520, a CPS-2 game; games/dino, ROM set dino, World 930201, a CPS-1 game with QSound). Each has
  three players at once, free play, a round or stage to start at, the board's settings on the Board page (Alien vs.
  Predator's Players setting lets the third join: on in Enhanced), infinite health, lives and time, straight to the
  title, and everything the port gives every game. Both translated whole and checked (make check).

• A CPS-1 board with QSound ("CPS-1.5") in the toolkit: board = cps1 and cps_b in a game.cfg; its memory map,
  inputs for three or four players, 12 MHz, the objects in video RAM placed among the scroll screens by the layer
  control (with the layer below them keeping its high pens in front), the settings memory as 128 bytes, no program
  cipher, and the sound CPU's Kabuki cipher deciphered with a key worked out from the player's own ROM in about a
  second (machine/kabuki.*; no key is in the repository). The Z80 reads opcodes through Z80Bus::ReadOpcode.

• Up to four players: game.cfg's players, the CPS-2's third and fourth players' wiring, movies with a column
  for each player who presses something, run-ahead and the spare machines keeping every player. recomp-common's
  bindings take up to four players; the Controllers page has a button for each.

• A game's own names for its buttons (game.cfg's buttons, "Attack | Jump | Shoot"): its launcher shows them and
  only them, laid out on a gamepad as a beat-'em-up's are; in the collection every game shares one table, a fighting
  game's six with the other games' names beside them.

• Rapid fire (rapid_fire, Game page, every game): a held button pressed for two frames and let go for two, for
  the first button or all of them; the first press is not held back.

• --dump-ram may be given more than once. The launcher's words fit a game with no key file or training mode.

• Arcade timing (the arcade_timing feature, Game page, off unless chosen): the 68000 runs as on the board,
  its acknowledge a clock late for every access outside 500000-7FFFFF and its bus taken by the CPS-A's DMA (the row
  scroll, the scroll layers' tile rows, the palette), so a game slows down where and as much as on the board
  (docs/TIMING.md). Measured with jtcps2 simulated as a reference: without it the port's 68000 did about 1.35 times
  the board's work in a frame; with it, Street Fighter Alpha 2's work RAM is the reference's at 5,639 of 5,671 frames
  ...

CPS-2 Recomp 0.4.0-beta.1

CPS-2 Recomp: the toolkit and its games in one repository, and one launcher for all of them.

• The games are here: Street Fighter Alpha 2 (games/sfa2), Super Puzzle Fighter II Turbo
  (games/puzzle_fighter) and Vampire Savior (games/vampire_savior), each with its README, docs, movies and
  checks. Each was its own repository with a copy of the toolkit; their histories until now are in their own
  changelogs (games/<id>/CHANGELOG.md). A toolkit change now reaches every game at once, and is checked with
  every game. tools/sync-toolkit.sh and the toolkit copies are gone.
• One launcher for every game (recomp-common's collection launcher; make collection): a Games page that
  finds each game's ROM set in a folder you choose (or one dropped on the window), a Features page with what the
  games share, set for all of them at once (a feature changed in one game's own menu is set for the others when
  it ends), the Controllers page for all of them, and a page for each game whose ROM set you have, with its
  Display switches, Play, and the features only it has. Each game keeps its own settings folder, as its own
  launcher did, and the ROM set chosen there is taken over.
• From a terminal: cps2recomp-launcher --play ID (straight into a game), --play ID -- ARGS (more arguments
  for the game, after the launcher's own), --page ID. A game's program still runs by itself, with all its
  arguments; --features may now be given more than once (later ones win). A game's program opened by itself
  starts the collection's launcher at its page when there is no launcher of its own beside it.
• The release is the collection: CPS2Recomp-macOS.zip, CPS2Recomp-linux-x86_64.tar.gz,
  CPS2Recomp-windows-x64.zip, each with the launcher and every game (tools/release/). CI builds and starts all
  of it, with no translated code, on all three systems.
• Build from the top: make GAME=<id> and its targets as before, make games, make collection,
  make collection-app; ROM sets in rom/<id>/.
• Settings: kFeatureOwn (OwnFeatures), a game's feature that the collection never sets for another game (the
  survival and ring out records, the animations' numbers).

cps2recomp 0.3.0

• recomp-common 0.5.0: in the in-game menu, Right on a page's row goes into that page; the
  launcher's Features page has a search box (Ctrl+F or Cmd+F; Esc empties it, a second Esc leaves it;
  a gamepad's A goes in and B leaves with what was typed kept).
• The in-game menu's first page has a "Test menu" row: it presses the board's test switch (as F2
  does), which opens the game's own operator menu, where its settings are (difficulty, rounds and the rest).
• Colour editor: random colours (the Random row: LK, left or right) only at a second press within a second and
  a half, and HK puts back the set from before them until the next change. The Line row goes to the
  animation that best shows the line when the game says which (Description::animationForLine).
  "Load colour files again" and "Write the game's colours" are on the editor's page, not Display.
• The game's program started with no arguments (a double click on it, not on the launcher) starts
  the launcher beside it instead: straight into the game (--play) once a ROM set has been chosen.
  A start that fails says why in a message box too, unless headless. On Windows the game is a
  windowed program (no console window beside it).
• recomp-common 394d613: the menu leaves room for a page's longest description (it ran over the hint),
  a value too long for its row is drawn small, and the panel is opaque.
• Display options for every game (the port's features, on the Display page of the launcher and the
  in-game menu): Scaling (Sharp, as before; Whole pixels; Smooth), Picture shape (4:3, as before;
  Square pixels; Fill) and Window size (3x, as before; 2x to 6x). A window takes the new shape or
  size at once. FitPicture and Presenter::SetScaling (present.h); --scale still goes before the
  setting, and --present-size WxH draws --present-test's picture in a window that size.
• SetSlowMotion: a game's sources can ask for the game to run slowly (a frame in every so many
  pictures); the slower of that and the menu's speed is used.
• The check of a rewrite compares video RAM too for a rewrite that names kChecksVideo (a routine
  that writes a scroll screen's map or the row scroll table).
• The code for three lines of 0.2.0's list, which was released without it: kFeatureFirstPage,
  Video::wide.rows and Video::objectsTaken; and the board's own picture drawn by a form of the
  renderer that knows its width.
• fight/: what a fighting game's training mode has in common (frame data, its meter and a log of
  every move, the input display in numpad notation, the combo readout, a dummy that guards, records
  and replays, boxes on the picture); docs/FIGHT.md. runtime/spare.*: machines kept as save
  states and run beside the port's, for a game's modes. SettingsPath().
• The dummy at random: what it does while guarding, the escape from a throw and the way up from a
  knock-down; "Answers now and then" (one time in two, with any slot that has a recording).
• Run-ahead for every game (the port's run_ahead feature: off, 1 or 2 frames): a press is seen a
  frame or two sooner and the game runs exactly as without it. Not while stopped, stepped or slowed,
  nor when the game says not (Game::noRunAhead); RunningAhead() for a game's sources. Listed in
  the launcher (RegisterPortFeatures). The 68000's wait is kept in a save state (state version 5).
• Video::wide.fillHoles, a game's choice: pixels of the added columns that nothing was drawn at
  take the line's own picture, mirrored at the nearest drawn pixel.
• A first-page switch changed in the in-game menu is changed in launcher.ini too; the window takes
  the widest picture's shape again when it changes.
• The launcher's Game page says how to open the in-game menu while playing.
• tools/at-once.sh: a game's checks run a few at a time, their outputs in order.
• Training aids work only in a training session: kFeatureTraining (a game's sources mark theirs with
  TrainingAids; the dummy's are marked by RegisterDummy) and Game::inTraining. Outside a session
  FeatureValue gives 0 for them, while the menu shows the player's setting (FeatureSetting) and
  settings.ini keeps it.
• Custom colours and a colour editor for a fighting game's characters (fight/colours.h): the
  custom_colours feature (text files a character and a PalMod-changed copy of the ROM file in
  palettes/ beside settings.ini, written over the ROM image's colours), "Write the game's colours"
  and "Load colour files again", and the editor (Alternative modes → Colour editor) in the game's
  model viewer, with a library of saved sets. A game describes where its colours are and supplies its
  viewer's hooks (colours::Description). From Vampire Savior's, with the same files and folders.

cps2recomp 0.2.0

• A wider picture for a game's sources to ask for (Video::wide): up to 64 more columns on each side
  of the board's 384 (512 is the whole raster: 16:9), each scroll screen and each object drawn moved
  sideways as the sources say, and a scroll screen's tiles outside the board's own columns taken
  from the sources where the game only keeps its map up for its own picture. The window, the menu,
  the readout, screenshots and --present-test take the picture at the width it has; the window
  starts in the shape Game::widestPicture gives. With nothing asked for, the picture and the
  state hashes are what they were.
• Machine::ObjectsToCome: the object list the next picture will be made from.
• CPS2RECOMP_WIDE=n: n more columns on each side whatever the sources ask, to see what a game has
  beyond its picture's edges.
• recomp-common 0.4.0: the launcher works with a gamepad, or the arrow keys, alone, and has a
  "Muted" switch (the game is started with --mute).
• The in-game menu's buttons are the same whatever the game's are set to: the arrows, the d-pad and
  the left stick; Space, Enter and a gamepad's A choose; Backspace and B go back (leave a page,
  close the menu from the first). A "Sound" row switches the sound off and on; --mute starts with
  it off (the sound device is opened all the same, so that the row can switch it on).