Get the repository at tag v1.6.2. A Git checkout and GitHub's source ZIP contain the same editable projects. For the ZIP, extract it and open the directory containing game, autopatcher and restoration. The commands below run from that directory.
| Project | Folder | Entry point |
|---|---|---|
| Android Standard | game/android/standard |
AM2R-project.yyp |
| Android Dual Screen | game/android/dual-screen |
AM2R-project.yyp |
| Linux Standard | game/linux/standard |
AM2RStandardLinux.yyp |
| Linux Dual Screen | game/linux/dual-screen |
AM2RDualLinux.yyp |
| Android Autopatcher | autopatcher/android |
app-android for the app, am2r_android_patcher.py for the PC utility |
| Linux Autopatcher | autopatcher/linux |
handheld_launch.py for handhelds, linux_patcher.py for desktop use |
Install Python 3.11 or newer and xdelta3 on your development computer. Keep your own original Windows AM2R_11.zip and the AM2ARM-Source-Restore-1.6.1.zip download. The 1.6.2 catalog is in this checkout. It reuses the same binary patches as 1.6.1. Place the checkout on a filesystem that supports hard links, such as NTFS or ext4. Once you have those inputs, the following commands work offline. Download the matching patch pack from v1.6.1.
-
Prepare the bundle once. Pass the downloaded ZIP itself.
python3 restoration/prepare_bundle.py "/path/to/AM2ARM-Source-Restore-1.6.1.zip"The helper verifies the whole ZIP's SHA-256, extracts the two verified patch sets, and builds the Project Restore Tool catalog for all six folders under
restoration/bundle. Keep the complete checkout together for this step. -
Restore and check the project you plan to edit. Substitute any folder from the table.
python3 restoration/restore_project.py --project game/android/standard --zip "/path/to/AM2R_11.zip" python3 restoration/restore_project.py --project game/android/standard --checkOn Windows, use
py -3in place ofpython3. PRT verifies the donor and every restored file. It preserves source edits, reports changes to a reference source file, and stops if existing media has different bytes. Keep eachasset-inputs.jsonunchanged. To prepare the bundle elsewhere, pass--output "/path/to/bundle"to the first command and--bundle "/path/to/bundle"to both PRT commands. -
Open the entry point for the selected project. Game projects use GameMaker Beta IDE 2026.100.0.1083 and runtime 2026.100.0.1046. Read that project's
BUILDING.txtfor its licensed toolchain and native inputs.
The report lists missing generated inputs separately. Linux builds need the haptics and save-transfer libraries. Dual Screen also needs the display extension. Build these from the matching source. The two Autopatchers restore interface media and require edition patch bundles from your privately built games. Android updates require the original signing identity. Use your own package ID and key for independent builds. Native build instructions · Android patcher build · Linux patcher build.
The common Linux launcher, display extensions, patched GL4ES source and save-transfer helpers live in native/linux. The unified card layout and menu adapters live in native/unified. The TrimUI native rumble bridge is in native/trimui. The corresponding-source index records the two unchanged dependency archives from the v1.6.1 tag, with original versions, URLs and hashes. Runtime dependency sources.
The game projects carry their own source terms in LICENSE.txt and THIRD-PARTY.txt. Autopatcher and PRT tooling and third-party components retain their respective notices. Keep restored media, saves, generated builds and signing material private. For a source contribution, include the affected platform and edition, the change, and the behavior you checked.