Skip to content

HSFA v0.1.9 (pre-release, en test)

Pre-release
Pre-release

Choose a tag to compare

@Rickow Rickow released this 12 Nov 08:23
· 6 commits to main since this release

HSFA v0.1.9 (pre-release)

Pre-release, being tested. This version changes the translator of all three games (v161), the cores (save
states, 16:9 default) and the build on Windows: please report anything odd in the
Issues. The stable version stays v0.1.7.

Pré-version, en cours de test : merci de signaler tout souci dans les Issues ; la version stable reste la v0.1.7.

Rebuild your games. Most fixes below are in the games themselves: zips built by an older version do not have
them. Build again from your ISO with this version (builder or hsfa-v0.1.9-construction.zip), and use the v0.1.9
cores.

What's new since v0.1.8

Games

  • Translator v161 (SFA3, Upper, Hyper; Upper MAX and Hyper + Arcade too). A critical review of the translator found code that was
    dropped silently; it is now translated and checked against the arcade:

    • the ×1.5 damage bonus of MAZI mode was never applied;
    • the combo score bonus was always 0 (now as on the arcade, e.g. $1200 for a 5-hit super);
    • the hit character's ±1 px shake was missing (SFA3);
    • high-score initials: the 2nd letter was written over the 4th (SFA3, Upper);
    • nine other lost comparisons or byte accesses: custom combo freeze, scrolling text, the 2nd player's colour in a
      mirror match (Upper, Hyper)…

    The build now counts these losses and stops on a comparison or a recompiler helper it cannot translate, instead
    of producing a silently wrong game.

  • Hyper and Hyper + Arcade: 21 sounds of the PS2 port were silent (their commands are empty in the arcade sound
    programs): the parry in Mazi S-ISM (issue #1), the custom combo activation of ZERO 2 / ALPHA, Birdie, Sagat in
    Saikyo S-ISM, Cammy ALPHA (×14), Dee Jay's taunt, and one more. The build adds them to Hyper's sound ROM from
    your own ISO, at the PS2 pitch and loudness. Nothing else in the sound changes.

  • Ground shadow with the ISO alone (Hyper, Hyper + Arcade, ZERO / ZERO 2 characters): solid instead of
    transparent, because its tiles got other codes than the ones the core recognises. They are now placed at the core's
    codes: the ISO-only build matches the arcade-ROM build pixel for pixel. Only the shadow changes on screen.

  • Hyper + Arcade (experimental), state ro9a37: the graft now uses translator v161 (MAZI damage bonus, combo
    score bonus, 2nd player's colour in a mirror match), and the build no longer counts any untranslated comparison or
    helper in it. Also fixed since v0.1.8 (ro9a36): the CONTINUE screen (stray square), Sodom's stage (moon), Ryu's
    stage (sky, castle), Ken's ending (black square on Bison) and Cammy's stage (flicker). Checked: 85/85 Arcade runs to
    the credits, VERSUS identical to ro9a36 apart from the v161 fixes.

  • Upper MAX (experimental): follows translator v161; the integration of the MAX characters no longer relies on any
    hard-coded image address; the ending actors of Maki and Yun call the right routine; the MAX characters' round
    behaviour matches the PSP.

  • Chun-Li: the Kikosho arcs and the Kikoken wave were not missing (they flicker at 30 Hz, as on the arcade): removed
    from the known limits.

Build

  • Windows (issue #2, fixed): Upper MAX no longer needs the right to create symbolic links (WinError 1314); three
    other Windows-only problems further down its build are fixed too (home folder, paths in generated code, text
    encoding). The zips built on Windows are byte-identical to the Linux ones. The Windows parts were checked on a
    real Windows runner without Developer Mode.
  • Output formats: --cible (also an output format menu in the builder). fbneo-hsfa stays the default, with
    the same zips. fbneo-autonome (standalone FinalBurn Neo HSFA for Windows, test build) states its limit (RetroArch
    save states do not load there), asks for confirmation, then builds the same zips. mister and cps2-banques do
    not exist yet: the build lists, game by game, what that format would give up and the measured budgets, asks for
    confirmation, then stops without building anything. Messages in English or French (HSFA_LANGUE, otherwise the
    system language).

Cores (core set of 2026-11-12b: patches 0001-0027, 0029-0032, 0007b)

  • Save states are complete and deterministic (patch 0029): after loading a state, picture and sound are exactly
    those of the original game, so RetroArch's run-ahead, rewind and netplay work as intended. States are a
    little bigger and stay compatible both ways with older cores.
  • Damaged or incomplete save states load safely (patch 0032): the HSFA part at the end of a state is now checked
    before it is applied (some front-ends pad states with zeros; a state can be damaged or come from a future version).
    Before, such a state could leave the game silent with a black first frame, or crash the core. Now that part is
    ignored with a message in the log, and the state loads like a pre-v0.1.9 one, with sound. Normal states are
    unchanged, byte for byte.
  • 16:9: "Widescreen edges" = Raw by default; an option you already saved stays as it is (patch 0031): the picture the game draws, a free PSP-like view,
    as before v0.1.5. With the stage-locked view (the default of v0.1.5-v0.1.8), near the ends of an arena the ground
    froze while distant layers slid the other way, up to three times faster than on the arcade, and some background
    tiles arrived late. Stage-locked view, Mirror, Repeat and Black stay in the options. RetroArch keeps a
    value you saved before: pick Raw in the core options
    (or reset them). The 4:3 core is unchanged.
  • Linux x86_64 cores need glibc 2.27 only (Ubuntu 18.04+, Debian 10+, Batocera 43…); those of v0.1.7 / v0.1.8
    needed glibc 2.43 and were refused by most distributions. Same output.
  • Batocera 42 / 43: new hsfa-v0.1.9-cores-batocera.zip with an installer (a service puts the cores back at
    every boot, so they survive Batocera updates; retirer uninstalls), an hsfa system and a guide (English and
    French). Tried on the official Batocera 43.1 PC image (virtual machine): the five games up to the fights, 4:3 and
    16:9, with sound. ARM 64-bit: library versions checked, not tried; ARM 32-bit: not supported. RetroBat: an
    install note is in the repository (tools/retrobat/, untried).
  • Standalone FinalBurn Neo HSFA for Windows x64, test build: FinalBurn Neo without RetroArch, with the HSFA drivers
    and options (in the DIP switches; 16:9 in the Video menu), two programs (4:3 and 16:9), patches W01-W06.
    Rewind (Game → Rewind) and run-ahead (Video → RunAhead) restore the whole HSFA state, like file save
    states (patch W06; before: sound out of step after rewinding or with run-ahead); damaged states load safely
    (0032). Tried under Wine only: same pictures, game states and sound as the RetroArch core, with and without
    run-ahead and after rewinding. Not tried on a real Windows yet: your reports are welcome. Sources:
    patches/fbneo-autonome/.

Documentation

  • The repository's documentation is now in English by default (README, guides, architecture, methods, READMEs of
    patches/, tools/, scripts/, re/); the French versions are kept as .fr.md.

What you get

File Content
hsfa-v0.1.9-cores-android-arm64.zip RetroArch cores for Android (arm64-v8a): 4:3 and 16:9
hsfa-v0.1.9-cores-rocknix-aarch64.zip ROCKNIX cores (RK3326: RGB10X, RGB10, R36S…): 4:3 and 16:9, .info files
hsfa-v0.1.9-cores-windows-x64.zip RetroArch cores for Windows 64-bit: 4:3 and 16:9, .info files
hsfa-v0.1.9-cores-linux-x86_64.zip RetroArch cores for Linux x86_64 (glibc 2.27+): 4:3 and 16:9, .info files
hsfa-v0.1.9-cores-recalbox.zip Recalbox 10 cores: armhf/ (Raspberry Pi 3, Zero 2) and aarch64/ (Pi 4 / 400 / 5), install script, guide
hsfa-v0.1.9-cores-batocera.zip Batocera 42 / 43 (PC x86_64, ARM 64-bit): folder hsfa-batocera/, installer, guide
hsfa-v0.1.9-fbneo-standalone-windows-x64-test.zip Standalone FinalBurn Neo HSFA for Windows x64, test build (fbneo64.exe 4:3, fbneo64ws.exe 16:9), guide, sources
hsfa-constructeur-<system>.zip The all-in-one builder (attached automatically a few minutes after publication)
hsfa-v0.1.9-construction.zip The repository at this release, with the one-step build launchers
SHA256SUMS.txt SHA-256 of the archives

Each core archive holds fbneo_hsfa ("FinalBurn Neo HSFA", 4:3, 384×224), fbneo_hsfaws ("FinalBurn Neo HSFA
Widescreen", 16:9, 512×224, with the "Widescreen edges" and "Screen format" options), the FinalBurn Neo licence
(verbatim) and the third-party notices. The cores are libretro/FBNeo af5d3f3 with the patches 0001-0027,
0029-0032 and 0007b of patches/fbneo/ (core set of 2026-11-12b).

Which core? RetroArch on Android, Windows, Linux: the archive of your platform. ROCKNIX handhelds: rocknix.
Recalbox 10: recalbox. Batocera: batocera only (on PC, its x86_64/ cores are the Linux ones; do not use older
Linux cores, they need glibc 2.43). Windows without RetroArch: the standalone test build.

Play in 3 steps

  1. Download the core archive of your platform and install the cores (RetroArch: its cores folder; Recalbox and
    Batocera: the guide inside the archive). Using the 16:9 core already? Set Widescreen edges to Raw.
  2. Build the games again with v0.1.9. Easiest: the all-in-one builder hsfa-constructeur-<system>.zip (Windows,
    Linux, macOS). Or download hsfa-v0.1.9-construction.zip, unzip it, run construire.sh (Linux, macOS, WSL) or
    double-click construire.bat (Windows, experimental) and give it your ISO. By hand: pip install -r requirements.txt, then
    python3 scripts/construction/hsfa_build.py --anthology <your USA ISO> --sortie hsfa_out (Python 3.8+; add
    --arcade sfa3.zip to take the SFA3 graphics ROM from your own arcade set; --jeux uppermax --psp-iso <PSP ISO>
    for Upper MAX, --jeux hyperarcade for Hyper + Arcade). You get sfa3hsfa.zip (SFA3), sfa3uhsfa.zip (Upper)
    and sfa3hhsfa.zip (Hyper) in hsfa_out/archives/.
  3. Copy the zips into your ROM folder (keep their names) and load them with one of the cores.

Expected fingerprints

hsfa_build.py checks your ISO by game group, then prints the MD5 of the program ROM sz3ud.03c of each game. With
v0.1.9 (translator v161), from the ISO alone (project's control build of this release):

Game Zip sz3ud.03c (MD5)
Street Fighter Alpha 3 sfa3hsfa.zip a569c36191731f9d8bbbc7fc7fb12b07
SFA3 Upper sfa3uhsfa.zip ac053140cb7558a3c86c8a9af59fe829
Hyper Street Fighter Alpha sfa3hhsfa.zip ffc5eac1b97d084089870a305c3ba0b8 (see Known limits)
Upper MAX (experimental) sfa3umhsfa.zip 5e1430eedf429966c0f76207ea688f11
Hyper + Arcade (experimental) sfa3hahsfa.zip 627c98c4a204fbb6acf2fa6e240fef5a

They differ from v0.1.8 (translator v160) because of the fixes above. Two builds give byte-identical zips, on Linux,
Windows and macOS alike.

Known limits

  • Upper MAX and Hyper + Arcade are experimental. A few of Hyper + Arcade's stage objects differ from Upper.
  • Hyper's per-version voices (SFA1 voices for the ZERO versions, SFA2 voices for ZERO 2 / ALPHA) need a QSound
    replay table recorded from the SFA1 / SFA2 sound drivers, which is game-derived and therefore not distributed:
    without it, Hyper uses the SFA3 voices for every version. Planned for v0.2: the build will regenerate it from your
    own ISO.
  • 16:9 in Raw (the new default): at the ends of an arena the sides can show black or stale columns, as on the PSP
    and in the 16:9 core before v0.1.5; Stage-locked view (option) shows the arcade art up to its edge instead.
  • Standalone FinalBurn Neo for Windows: test build, tried under Wine only; RetroArch save states do not load in it.
  • "Sheared" picture (standalone FinalBurn Neo HSFA, Windows, test build). Reported on one machine with an earlier
    test build in Stage-locked view. Not reproduced: our tests run under Wine, not on a real Windows; the cause is
    not established
    and this is not announced as fixed.
    • What we know: the game draws every frame straight (correct line pitch in every format); the only effect of this
      kind seen in our captures (background layers sliding against each other near the ends of the stage, in
      Stage-locked view) is gone with the current default, Raw.
    • Real tearing is only plausible in one case: DirectX 9 blitter (Experimental or Alt) in full screen with VSync
      off
      . With the default blitter (DirectDraw SoftFX) or in a window, the display is already synchronised.
    • If you see it: pick Video → Select blitter → DirectDraw SoftFX (the default), or tick Video → Enable VSync;
      and tell us: window or full screen, blitter, format (Video → HSFA widescreen), display refresh rate, with a
      photo of the screen.
  • Batocera on ARM 64-bit is untried; ARM 32-bit is not supported. RetroBat: untried note only.
  • Upper keeps its hybrid sound ROM: Dee Jay's taunt is probably silent there too (not checked yet).
  • One Hyper music stream (Y27) stays in ADX inside the zip.
  • The 16:9 PS2 patcher is validated on Upper and Hyper; a few non-fight screens are offset. It changes the PCSX2 CRC
    (72CE7A78 → 72CE7A38).
  • The ISO must be a 2,048-byte-per-sector .iso (convert .chd with chdman extractdvd). Only the USA version is
    supported.

Licences

HSFA's own code: MIT. Cores and standalone programs: FinalBurn Neo licence (no sale, no donations; sources of
every change in patches/fbneo/ and patches/fbneo-autonome/). stb_vorbis: public domain or MIT. QSound HLE (qs_c,
DL-1425): BSD-3-Clause. MAME fork patches: MAME licence (GPL-2.0-or-later). Details: NOTICE.md.

Street Fighter and Street Fighter Alpha are trademarks of Capcom. This project is not affiliated with or endorsed
by Capcom.

Thanks to everyone who reported issues: issue #1 (silent parry in Hyper) and issue #2 (Windows build) are fixed in
this version.


Résumé en français

Reconstruisez vos jeux avec la v0.1.9 (constructeur ou hsfa-v0.1.9-construction.zip) et prenez les cœurs de la
v0.1.9 : la plupart des correctifs sont dans les jeux eux-mêmes. Pré-version en test ; la stable reste la v0.1.7.

  • Traducteur v161 (SFA3, Upper, Hyper, Upper MAX) : code perdu sans message, retrouvé par une revue critique et
    vérifié contre l'arcade : bonus de dégâts ×1,5 du mode MAZI, bonus de score des enchaînements, tremblement du
    perso touché (SFA3), 2e lettre des initiales (SFA3, Upper), couleur du 2e joueur en match miroir, gel du custom
    combo, texte défilant… La construction s'arrête désormais sur toute comparaison qu'elle ne sait pas traduire.
  • Hyper et Hyper + Arcade : 21 sons propres à la PS2 rendus (parade en Mazi S-ISM du ticket #1, custom combo de
    ZERO 2 / ALPHA, Cammy ALPHA, provocation de Dee Jay…), tirés de votre ISO pendant la construction.
  • Ombre au sol transparente aussi avec l'ISO seule (Hyper, Hyper + Arcade).
  • Hyper + Arcade (ro9a37) : passe au traducteur v161 (bonus Mazi, enchaînements, couleur en match miroir) ;
    CONTINUE, décors de Ryu, Sodom et Cammy, fin de Ken corrigés (ro9a36) ; 85/85 parties Arcade jusqu'au générique.
  • Upper MAX : en v161, sans adresse écrite en dur ; fins de Maki et Yun ; fin de manche des MAX comme sur PSP.
  • Windows (ticket #2) : Upper MAX se construit sans droit de lien symbolique ; trois autres pannes corrigées ;
    mêmes zips que sous Linux.
  • --cible : fbneo-hsfa par défaut (zips inchangés), fbneo-autonome en essai ; mister et cps2-banques
    annoncent leurs concessions sans rien construire.
  • Cœurs du 12/11 b : sauvegardes d'état complètes (run-ahead, rembobinage, jeu en ligne, 0029) et robustes
    (états abîmés chargés sans dégât, 0032) ; 16:9 en Raw par défaut, une option déjà enregistrée reste (choisir
    Raw) ; cœur Linux pour glibc 2.27 ; paquet Batocera (installeur, guide) ; FinalBurn Neo HSFA autonome pour
    Windows
    en version d'essai (essayé sous Wine seulement ; rembobinage et run-ahead complets, W06).
  • Image « cisaillée » (autonome) : non reproduite, cause non établie, pas annoncée comme corrigée ; si vous la
    voyez : blitter DirectDraw SoftFX (le défaut) ou VSync, et dites-nous fenêtre / plein écran, blitter, format,
    fréquence de l'écran, avec une photo.
  • Documentation du dépôt désormais en anglais (versions françaises gardées en .fr.md).
  • Empreintes de sz3ud.03c (ISO seule) : SFA3 a569c361…, Upper ac053140…, Hyper ffc5eac1…, Upper MAX
    5e1430ee…, Hyper + Arcade 627c98c4… (construction de contrôle).
  • Limites : Upper MAX et Hyper + Arcade expérimentaux ; voix d'Hyper par version absentes sans la table du rejeu
    (prévu en v0.2) ; en Raw, côtés noirs ou périmés aux bouts de l'arène ; autonome pas encore essayé sur un vrai
    Windows ; Batocera ARM non essayé ; flux Y27 en ADX ; patcheur 16:9 validé sur Upper et Hyper seulement.