Repository navigation
HSFA v0.1.9 (pre-release, en test)
Pre-releaseHSFA 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 orhsfa-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.
$1200for 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-hsfastays 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.misterandcps2-banquesdo
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.zipwith an installer (a service puts the cores back at
every boot, so they survive Batocera updates;retireruninstalls), anhsfasystem 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), patchesW01-W06.
Rewind (Game → Rewind) and run-ahead (Video → RunAhead) restore the whole HSFA state, like file save
states (patchW06; 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
- Download the core archive of your platform and install the cores (RetroArch: its
coresfolder; Recalbox and
Batocera: the guide inside the archive). Using the 16:9 core already? Set Widescreen edges to Raw. - Build the games again with v0.1.9. Easiest: the all-in-one builder
hsfa-constructeur-<system>.zip(Windows,
Linux, macOS). Or downloadhsfa-v0.1.9-construction.zip, unzip it, runconstruire.sh(Linux, macOS, WSL) or
double-clickconstruire.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.zipto take the SFA3 graphics ROM from your own arcade set;--jeux uppermax --psp-iso <PSP ISO>
for Upper MAX,--jeux hyperarcadefor Hyper + Arcade). You getsfa3hsfa.zip(SFA3),sfa3uhsfa.zip(Upper)
andsfa3hhsfa.zip(Hyper) inhsfa_out/archives/. - 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.
- What we know: the game draws every frame straight (correct line pitch in every format); the only effect of this
- 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.chdwithchdman 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-hsfapar défaut (zips inchangés),fbneo-autonomeen essai ;misteretcps2-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) : SFA3a569c361…, Upperac053140…, Hyperffc5eac1…, Upper MAX
5e1430ee…, Hyper + Arcade627c98c4…(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.