BUILD OR UPDATE

Run python apply.py in a terminal (Windows: py -3.13 apply.py).
Choose Build or update, then select your media and available outputs.
Settings are remembered; intact outputs can be reused safely.
Check requirements is optional. Change settings saves without building.
Enter q at any prompt to quit. Run apply.py --help for the existing
command-line options and specialized workflows described below.

ROM INPUT UPDATE

Merged, split, complete ZIP/7z archives and extracted ROM folders are accepted.
Use --rompath DIR (repeatable) to search a collection, or keep the existing archive argument.
Names may differ; required source contents are verified by size and strong hashes.
Use --check to verify arcade build inputs before reconstruction.
QSound is optional for game builds. Valid embedded firmware is preserved in complete game outputs.
Use --include-devices on CPS-2 kits to require and include firmware from separate archives.
Compact HBMAME outputs retain their stock-game and device dependencies.
7z input requires an installed 7-Zip executable; ZIP needs no extra archive software.
Original archives are never modified by collection discovery.

Street Fighter Zero 2 Alpha · English restoration
=================================================

Version:  rc2 (2026-10-11)
Target:   MAME set 'sfz2al' (Street Fighter Zero 2 Alpha (Asia 960826))
Hardware: Capcom CPS-2
Patch by: Steve Gordon (https://x.com/strygo)
Website:  https://arcadepatches.com/sfz2al-restoration/

ABOUT THIS PROJECT

Street Fighter Zero 2 Alpha is the updated Alpha 2, and its Asian version
plays in English. But that English script was a shortened one. Story scenes
lost pages, Evil Ryu borrowed Ryu's ending, and each fighter picked from four
random win quotes instead of the hundreds the Japanese game has.

The English Restoration is the Japanese script, in English. Every story and
ending page is back, in the Japanese order. Evil Ryu has his own ending again,
and his scene with Akuma. All 452 win quotes are here, picked by who you beat
and how much health you had left, just like in Japan. Where Capcom's English
said the same thing as the Japanese it's kept; everything else is newly
translated.

A few smaller things come along: red blood on hits, as in Japan; Birdie's
third victory pose, which the export version swapped out; English place names
on the next-stage map; and the Manual guard panel on the select screen now
explains itself.

The fighting follows the Japanese version, and the ROM sizes and key stay
stock, so it drops in over the Asian set in MAME, HBMAME, on MiSTer or on
original CPS-2 hardware. The same restoration is in the English builds of
Street Fighter Alpha 2 Gold.

This is a release candidate.

WHAT'S CHANGED

  - Every story page from the Japanese game, in the Japanese order, including
    the scenes the English script cut short
  - Evil Ryu's own ending, with his narration, instead of Ryu's
  - Evil Ryu's scene with Akuma, back in
  - All 452 win quotes from the Japanese game, in English, picked by opponent
    and remaining health, and centered on screen
  - Every ending in full, in English
  - Story, ending and quote text translated from the Japanese, keeping
    Capcom's English wherever it matched
  - Red blood on hits, as in Japan
  - English place names on the next-stage map, as in Japan
  - Win-quote pick by holding buttons, as in Japan
  - A REGULATION setting for white blood (off by default)
  - Birdie's third victory pose, back
  - The Manual guard panel explains itself
  - Computer opponents and two-player damage as in the Japanese version

HOW TO APPLY (recommended)

    python3 apply.py /path/to/sfz2al.zip --out-dir out

This checks every file against the original, applies the patches, checks
the result, and writes everything you need for each platform:

  MAME:                     out/mame/sfz2al.zip
  HBMAME:                   out/hbmame/sfz2alr.zip
  MiSTer:                   out/mister/_Arcade/_Arcade Patches/_Restorations/_Asia/Street Fighter Zero 2 Alpha (Asia) [English Restoration].mra

Merged, split and complete sets work, including nested or renamed ROMs.
Use --rompath DIR (repeatable) to search a collection instead of naming the
zip, and --check to check inputs before building. ZIPs and extracted folders
need no extra software; 7z archives use installed 7-Zip or a verified download.
QSound can stay in your emulator's ROM path; valid firmware already
in a source set is kept in complete outputs.

MAME: put sfz2al.zip from out/mame/ ahead of the stock set in your MAME
rompath.
MAME's game menu won't start a set with patched ROMs, so start it from the
command line: mame sfz2al. MAME shows checksum warnings for the patched
ROMs; that's expected and the game runs normally.
To start it from a menu, use the HBMAME build.

HBMAME: this restoration is an official HBMAME set (sfz2alr),
so full HBMAME collections may already carry it.
Put the zip in HBMAME's roms/ folder next to your stock sfz2al.zip.

MiSTer: copy the _Arcade folder from out/mister/ to the root of your SD card
and keep the stock, unmodified romset at games/mame/sfz2al.zip (split MAME
sets also need qsound.zip). The MRA applies the restoration in memory as the
game loads, so nothing on the card is modified. You need Jotego's jtcps2
core, which update_all installs. The MRAs are also a separate download.

HOW TO APPLY (any IPS patcher)

Extract sfz2al.zip, apply each file in ips/ to the ROM file of the
same name (Flips, Lunar IPS, or any IPS tool), then re-zip everything
as sfz2al.zip.

CHANGED FILES

    sza.13m  (4.0 MB)  CRC32 4d1f1f22 -> 7a8a6c11
    sza.15m  (4.0 MB)  CRC32 19cea680 -> dac13be5
    sza.17m  (4.0 MB)  CRC32 e01b4588 -> c6c58a06
    sza.19m  (4.0 MB)  CRC32 0feeda64 -> b98a7216
    szaa.03  (512 KB)  CRC32 88e7023e -> 8d841750
    szaa.04  (512 KB)  CRC32 ae8ec36e -> f64c40a7
    szaa.05  (512 KB)  CRC32 f053a55e -> f132bb74
    szaa.07  (512 KB)  CRC32 5feb8b20 -> 305b6fe0
    szaa.08  (512 KB)  CRC32 6eb6d412 -> 2b5e2337

All other files in the set are unmodified.

LEGAL

This is a free, unofficial fan patch. It is not affiliated with or endorsed
by Capcom. All game titles, characters, and artwork remain the property of
their respective owners. You must own the game to use this patch. Do not
sell this patch or distribute it applied to a ROM image.

DARKSOFT OUTPUT

Use --platform darksoft --out-dir out, or --platform all.
Copy the game folder from out/darksoft/games to the card games folder.
Expanded hardware and streamed audio are not supported.

PYTHON PACKAGES

When a build needs NumPy or Pillow and it is not already installed, the kit
downloads its pinned prebuilt package from PyPI into your user cache. No pip,
compiler, administrator rights or changes to system Python are needed.
Patch-only builds and --help do not download Python packages.

Automatic package installation is qualified for CPython 3.12 on Apple Silicon
Macs and CPython 3.13 x64 on Windows (including x64 Python on Windows ARM).
Other interpreters can still use manually installed NumPy/Pillow. There is
no automatic source compilation or selection of an unqualified package.

Cache: ~/Library/Caches/ArcadePatches/python on Mac, or
%LOCALAPPDATA%/ArcadePatches/python on Windows. You can choose another location
with --python-cache PATH (or ARCADE_PYTHON_CACHE). --tools-cache PATH places
the Python cache under PATH/python unless --python-cache is also supplied.
You may delete this cache when no installer is running; it is recreated later.

Offline: add --python-wheels PATH --offline. PATH may name the matching
python-wheels-v1-*.zip, a folder of unzipped wheels, or a folder containing
the wheel ZIPs. The existing wheel bundles work without modification.
You can also supply --tools-bundle for the other helpers in the same command.
ARCADE_PYTHON_WHEELS is the equivalent environment variable. A warm cache
works offline without a bundle. --offline prohibits package downloads too.
Every wheel is checked against the kit's hash; cached extracted files are
verified before use. Existing manually installed packages remain supported.

The installer and its Python subprocesses share the cache. Your shell profile,
global site-packages and unrelated Python applications are not changed.

FBNEO OUTPUT

Use --platform fbneo --out-dir out, or --platform all.
The default all-platform build also includes these complete game sets:
  default: out/fbneo/sfz2alre.zip
The ZIPs preserve the existing FBNeo ROM member names and contain complete game sets.
Copy the ZIPs to your FBNeo ROM folder without renaming their members.
Use an FBNeo version with definitions matching this game release.
Older definitions may reject these checksums.
