Breakers - Windows x64
======================

Native static recompilation of Breakers (Neo Geo MVS, MAME set "breakers",
NGM-230).  The game's 68000 code was translated to C ahead of time by
NeoGeoRecomp and is compiled into this executable; it is not an emulator
wrapper.  Musashi is the fallback for any address without a recompiled
entry and the oracle used by --verify.

No game or BIOS data is included.  Supply your own legally obtained dump.

Quick start
-----------
1. Unzip the MAME "breakers" set and the "neogeo" system set into a folder,
   for example:

       roms\
         230-p1.p1  230-c1.c1 .. 230-c4.c4  230-s1.s1
         230-m1.m1  230-v1.v1  230-v2.v2
         sp-s2.sp1  sfix.sfix  sm1.sm1  000-lo.lo

2. Run:

       Breakers.exe --rom-path roms

   or put the files in a "roms" folder beside Breakers.exe and just run it.

Options
-------
    --rom-path DIR   --bios-path DIR   --bios FILE
    --headless       --frames N        --scale N
    --fullscreen     --input FILE      --wav FILE
    --verify         --interp          --dump-misses FILE

Controls (keyboard)
-------------------
    Arrows      move
    Z X C V     Neo Geo A B C D
    5 / 6       coin 1 / coin 2
    1 / 2       start 1P / 2P
    3           select
    9           service
    F2          test switch
    F11         fullscreen toggle
    Esc         quit

Gamepad (Xbox layout through SDL2 GameController)
------------------------------------------------
    D-pad / left stick   move
    A B X Y              Neo Geo A B C D
    Start                start
    Back                 coin
    Left shoulder        select

Insert a coin before Start: this is an MVS board, as on the real cabinet.

Verification performed
----------------------
    Boot (real sp-s2.sp1 BIOS), title, HOW TO PLAY, character select,
    match: tested from the Release executable.
    --verify: 10,431,427 blocks, 0 mismatches (6,000 frames).
    Native coverage: 100.00%, 0 interpreted, 0 uncovered entries over
    20,000 frames after the profile pass (28,808 dispatch entries).
    Audio: continuous from boot through the match (waveform checked);
    YM2610 output compared with MAME 0.242 for boot/intro/title.

Not tested here: physical Steam Deck hardware, Gaming Mode and a physical
controller.  See the Linux AppImage README for those caveats.

Licensing
---------
Original project code: PolyForm Noncommercial 1.0.0 (LICENSES\LICENSE.txt),
confirmed by the repository owner on 2026-10-27.  NeoGeoRecomp is MIT;
Musashi and superzazu/z80 are MIT; ymfm is BSD-3-Clause; SDL2 is zlib.
Their notices are in LICENSES\.  Breakers and Neo Geo are trademarks of SNK
Corporation; this project is not affiliated with or endorsed by SNK.

No ROMs, BIOS images, recompiled C or entry-point lists are distributed.
