Street Fighter Alpha 2 Gold / Zero 2 Dash — reconstruction kit
==============================================================

Version:      rc9 (2026-11-14)
Language:     Approved English restoration; Japan retains Japanese text
Hardware:     Capcom CPS-2
Target:       MAME and HBMAME sets, and MiSTer (jtcps2) — 4 regions
Backport by:  Steve Gordon (https://x.com/strygo)
Website:      https://arcadepatches.com/sfa2-gold/

This kit builds the CPS-2 arcade backport of Street Fighter Alpha 2 Gold /
Zero 2 Dash from your own PlayStation 2 disc image and arcade romset. Original
game ROMs are not included.

WHAT YOU NEED
-------------

  1. Your PlayStation 2 anthology disc image:
       - USA / Asia : "Street Fighter Alpha Anthology" (USA)
       - Japan      : "Street Fighter Zero - Fighter's Generation" (Japan)
       - Europe     : "Street Fighter Alpha Anthology" (Europe)
  2. Your arcade Street Fighter Zero 2 Alpha romset:
       - sfz2al.zip  for the USA / Europe / Asia sets
       - sfz2alj.zip for the Japan set
  3. Python 3.10 or newer. Nothing else — no emulator, no assembler.

The PS2 input may be an ISO or a DVD CHD. Use --disc (or the existing --iso
option) for either; the correct game and region are still verified. DVD CHDs
are decoded temporarily with chdman, using an installed copy or a verified
download. Override it with --chdman <executable-or-folder>. Allow enough extra
temporary storage for the uncompressed DVD. --offline requires chdman to be
installed, cached, or supplied in your offline tools bundle.

USAGE (recommended — build every platform for one region)
----------------------------------------------------------

    python3 apply.py --iso <anthology.iso> --romset <sfz2al.zip> \
                     --region <jp|us|eu|asia> --out-dir out

This creates:

    out/mame/<region>/<set>.zip  4MB — stock MAME or real CPS-2 hardware
    out/darksoft/games/<game>/   8MB — best native samples, Darksoft flash format
    out/hbmame/<set>.zip         8MB — HBMAME, with every sound uncompressed
    out/mister/                  8MB — ready to copy to a MiSTer SD card

Run apply.py without arguments for guided selection, multiple regions and repeat
builds; it safely reuses one output folder. The command above needs a fresh
output folder for each run. Each region needs the matching disc listed above.

REGIONS
-------

    us    Street Fighter Alpha 2 Gold
    eu    Street Fighter Alpha 2 Dash
    jp    Street Fighter Zero 2 Dash (Japan)
    asia  Street Fighter Zero 2 Dash (English)

USAGE (single file)
-------------------

    python3 apply.py --iso ... --romset ... --region us --size 8mb --out sfa2g.zip

The kit verifies the finished files automatically. It stops with an error if
the supplied disc or romset does not match the selected region.

MAME and HBMAME will show checksum warnings because this is an unofficial
build. Those warnings are expected.

ON MISTER
---------

Copy the contents of out/mister/ to the root of the MiSTer SD card:

    _Arcade/_Arcade Patches/_Restorations/<name>.mra          the USA MRA
    _Arcade/_Arcade Patches/_Restorations/_Europe/<name>.mra  the other
    _Arcade/_Arcade Patches/_Restorations/_Asia/<name>.mra    regions, each
    _Arcade/_Arcade Patches/_Restorations/_Japan/<name>.mra   in its folder
    games/hbmame/<set>.zip                                    the 8MB sets

Earlier releases put these MRAs in _Arcade/_Arcade Patches/_Enhanced Versions
or _Arcade/_Backports; delete them from there when you copy the new ones over.

The standard Jotego jtCPS2 core is required. If QSound was absent from your input, keep qsound.zip or qsound_hle.zip in
games/mame on MiSTer. MAME/HBMAME can find it in their normal ROM paths.

LEGAL
-----

Unofficial fan reconstruction. Not affiliated with or endorsed by Capcom. All
game titles, characters, and artwork remain the property of their owners. You
must own the disc and romset used as inputs. The recipes carry one piece of
Capcom data: about 4 KB of Cammy's theme score from X-Men vs. Street Fighter
(Capcom, 1996), which her stage music is built from. Do not sell this kit or distribute
it applied to game images.

ROM COLLECTIONS
---------------
Merged, split and complete ZIP/7z sets and extracted folders are accepted.
Use --rompath DIR (repeatable) to search a collection. Names may differ;
required contents are verified by strong hashes. 7z needs installed 7-Zip.
Use --check to preflight arcade inputs without supplying the disc.
--out-dir builds all supported platforms; --platform selects just one.
Use --platform darksoft --out-dir out for Darksoft only. Copy the selected
game folder to the card games folder. This uses the best 8 MiB sample version,
matching HBMAME. No duplicate 4 MiB alternative or streamed audio is exported.
Source archives are never modified.
QSound is optional when building. Valid embedded firmware is preserved.
--include-devices requires and includes firmware from any supplied archive.

FBNEO OUTPUT

The default build also writes complete game ZIPs under out/fbneo/, preserving FBNeo set and ROM member names.
Use --platform fbneo --out-dir out to build only those sets. Use an FBNeo version with matching game definitions.
