Skip to content

A3MX v0.65.1

Choose a tag to compare

@github-actions github-actions released this 13 Nov 11:55
· 120 commits to main since this release

No game is included. You build it from your own copy of the game: the US PSP disc, A3MX (ULUS-10062), as an ISO. Until the decomp is complete, the parts not yet decompiled are translated from your disc when you build, so a ready-made program cannot be offered.

Download the zip for your system below (a3mx-0.65.1-windows-x64.zip, -linux-x64.zip or -macos-arm64.zip) and unzip it. Then open a3mx-launcher in the unzipped folder, choose your ISO with Browse... (or put it in imports/psp/) and press Run. The launcher is prebuilt; it builds the game on your machine from your disc, with its progress in the console underneath.

System Once, before the first Run Notes
Windows (x64) nothing: Python and the build tools are downloaded into .tools\ the first time The launcher isn't signed: if Windows SmartScreen stops it, choose More info > Run anyway.
Linux (x64) sudo apt install cmake ninja-build clang python3 plus SDL's libraries (list) Built on Ubuntu 24.04. On an older system, build the launcher yourself with ./launcher.sh.
macOS (Apple Silicon) xcode-select --install (Apple's command line tools); CMake and Ninja are downloaded into .tools/ by the build If a release has no macOS zip (its build didn't finish), take Source code (zip) and run ./launcher.sh. Open A3MX Launcher.app (native on Apple silicon, macOS 11 or later; no Rosetta). It isn't notarised by Apple, so macOS blocks it the first time: open it once, then System Settings > Privacy & Security > Open Anyway (or right-click it and choose Open). Or skip the download's launcher: ./launcher.sh builds one on your Mac, which macOS doesn't block.

The first build extracts and checks your disc and compiles everything (a few minutes). After that, Run starts the game straight away (it rebuilds only what changed), or play with build/a3mx --work work (build\a3mx.exe on Windows). Prefer the command line? build.cmd --run / ./build.sh --run do the same. Source code (zip) is the same source without the launcher. Details: Building.

Building from the source (a clone, or Source code (zip)): launcher.cmd on Windows, ./launcher.sh on Linux and macOS, builds the launcher and opens it; its Dependencies tab lists everything the build downloads, with each SHA-256, and downloads nothing until you agree. Nothing compiled is committed to the repository (DEPENDENCIES.md).

What's new since v0.60.0

  • Linux: missing libraries named before the build (issue #2): the build and the launcher's Dependencies tab now check for pkg-config and the window (X11 or Wayland) and sound (ALSA, PulseAudio or PipeWire) development libraries, and say which are missing with the line that installs them, instead of stopping in SDL's configure with "SDL could not find X11 or Wayland development libraries".
  • Files dated in the future no longer break the build (issue #2): files unpacked on a PC whose clock or time zone is behind the one that made them are dated now before CMake runs, so Ninja no longer finds the build out of date every time. Your ISOs, assets/ and saves/ are never touched.
  • More of the game decompiled: 46 more functions are hand-written C: a fighter's input each frame (turned to face its opponent, with what was just pressed and released), the routine that runs a fighter's script, pushing the opponent back, the wall jump check, small adjustments made when a hit lands, more of the steps objects share, two more object lists, and the camera's choice of routine by which fighters it follows. Nothing changes in play.
  • More of the game decompiled: 25 more functions are hand-written C: how an object is queued for drawing and drawn, the step of its animation, the background layers following the camera, the span two fighters cover, making an object from a pool, the fade's dimming of colours, the fighters' trail each frame, the round clock's digits, and more of a fighter's frame (its distance from the opponent, how pressed it is, the punch-and-kick checks). Nothing changes in play.
  • More of the game decompiled: 22 more functions are hand-written C: the steps objects' routines share (moving by a speed towards a target, falling to the floor, scrolling round, waiting on a timer, following their owner, taking the stage's colour) and five small helpers. Nothing changes in play.
  • More of the game decompiled: 58 more functions are hand-written C: 38 more step dispatchers (most of them an object's whole frame: its step, then its animation and drawing), the camera's sideways steps, the start of an object's animation, the trail a fighter leaves, falling stage objects wrapping round the screen, and thirteen small steps and questions of a fighter's frame. Nothing changes in play.
  • New test scenario: arcade_other_fighter plays an Arcade fight as E. HONDA against DAN, so the tests cover fighter and stage code that RYU's first fight doesn't.
  • More of the game decompiled: 322 more functions are hand-written C: 268 step dispatchers (the small functions that run an object's, fighter's or screen's current step), the text queue every screen draws its text through, the draw depth table, what a fighter's player is holding, the questions the game asks about the network state, and 40 functions the game calls that do nothing. Nothing changes in play: every one is checked against the original by the tests.
  • Overall progress bar: the progress box in README.md and docs/ROADMAP.md now starts with one overall bar and percentage (the share of the program's instructions that is decompiled), above the functions, instructions and by-area bars.