AM2R-Autopatcher-Linux/README.md

AM2R Autopatcher for Linux

This utility patches the official AM2R 1.1 release (Windows) to the fan-made Community Update (Linux).

Dependencies

The patcher and the installer only require a small amount of dependencies:

Arch (including Manjaro, EndeavourOS, RebornOS, etc.)

Make sure that multilib is enabled, as lib32-libpulse is a 32-bit library, and Arch does not enable 32-bit support by default.
To enable it, go to /etc/pacman.conf, search for [multilib], and make sure that the next two lines are uncommented:

[multilib]
Include = /etc/pacman.d/mirrorlist

Then install the following dependencies:
sudo pacman -S --needed unzip sed xdelta3 jre8-openjdk lib32-libpulse

Debian (including Ubuntu, Mint, PopOS, etc.)

Make sure that the i386 architecture is enabled for you, as libopenal1 requires the 32-bit version, and Ubuntu does not enable 32-bit support by default.
To enable it, do the following:

sudo dpkg --add-architecture i386
sudo apt update && sudo apt install libc6:i386 libncurses5:i386 libstdc++6:i386

Then install the following dependencies:
sudo apt install unzip sed xdelta3 openjdk-8-jre libopenal1:i386

Red Hat (including Fedora)

sudo yum unzip sed xdelta java-1.8.0-openjdk

Suse

sudo zypper unzip sed xdelta3 java-1_8_0-openjdk

Controllers

In order to be able to use a controller, you need the two following packages as well:

• jstest-gtk
• joystick

Linux and Android patching process

To patch your copy of (Windows) AM2R v1.1, place the AM2R_11.zip (case-sensitive) file in the same folder as patcher.sh. After installing the required dependencies for the version you would like to patch to, execute the patching script via ./patcher.sh. During the installation you will be asked, if you want to patch it for Linux or Android. Press the corresponding number for that.

If no arguments are applied, the patching script will run as interactive mode. For a list of all arguments for headless mode, run ./patcher.sh --help.

After patching

Navigate to the newly created folder.

If you have other questions/issues, please open an issue, post to r/AM2R, join the Official AM2R Discord Server or join the Official AM2R Matrix Space.

Android installation instructions

You will need an Android device with a file explorer application installed, and a USB cable to connect said device to your computer.

1. Enable installation of apps from third party sources on your Android device. The location of this setting varies from device to device; our example device has it under the Security Settings, but some may place it under Application Settings or another location. The option is usually called "Unknown Sources" and may need to be searched for.
2. Connect your phone to your computer with the USB cable. Select "Media Transfer" on the popup window displayed on your Android device.
3. Mount your phone (either via a file manager or via a terminal), and go to where it's mounted. Move AndroidM2R_1X_X-signed.apk to a location such as the Downloads folder of the Android device.
4. Disconnect the Android device, and open the device's file explorer app. Locate and open AndroidM2R_1X_X-signed.apk. This should prompt you to install the application; after this point it should behave like any other app.

If for some reason, you are not able to access your phone, you can use the adb (android-debug-bridge) instead:

1. On your phone, make sure, that developer options are enabled. If they aren't move to the About Phone section, search for your build number, and click on it 7 times.
2. Plug in your phone via a USB-cable, go to the developer settings, enable the USB Debugging option and trust your Computer.
3. Install the adb package. The name is different from distro to distro, so search your local package manager for adb or android-tools.
4. Open a terminal and type adb devices. This should show your phone. If it does, type adb install [path-to-apk].

Manual installation

This section, is if you don't like appimages, or want to run the game natively. Unless you have a very good reason for it, please use the AppImage instead!

Dependencies

As said above, these dependencies are only needed if you want to run the game natively.

Arch (including Manjaro, EndeavourOS, RebornOS, etc.)

Make sure that multilib is enabled, as this is a 32-bit application and Arch does not do so by default. To enable it, go to /etc/pacman.conf, search for [multilib], and make sure that both this and the next line are uncommented. After that, install the following packages:
sudo pacman -S --needed unzip sed xdelta3 lib32-openal lib32-openssl-1.0 lib32-libcurl-compat lib32-libpulse lib32-gcc-libs lib32-libxxf86vm lib32-libglvnd lib32-libxrandr lib32-glu

Debian (including Ubuntu, Mint, PopOS, etc.)

sudo apt install unzip sed xdelta3 libc6:i386 libstdc++6:i386 zlib1g-dev:i386 libxxf86vm1:i386 libcurl3:i386 libssl1.0:i386 libopenal1:i386 libxrandr2:i386 libglu1:i386

On newer versions (Debian 10+ or Ubuntu 18+) you may have to do the below command instead. Please make sure first, that you neither have libcurl3 nor libcurl4 installed.
sudo apt install unzip sed xdelta3 libc6:i386 libstdc++6:i386 zlib1g-dev:i386 libxxf86vm1:i386 libopenal1:i386 libxrandr2:i386 libglu1:i386 && wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl1.0/libssl1.0.0_1.0.2n-1ubuntu5.5_i386.deb && sudo dpkg -i libssl1.0.0_1.0.2n-1ubuntu5.5_i386.deb && wget http://archive.ubuntu.com/ubuntu/pool/universe/c/curl3/libcurl3_7.58.0-2ubuntu2_i386.deb && sudo dpkg -i libcurl3_7.58.0-2ubuntu2_i386.deb && rm libssl1.0.0_1.0.2n-1ubuntu5.5_i386.deb libcurl3_7.58.0-2ubuntu2_i386.deb && sudo apt install -f

Red Hat (including Fedora)

sudo yum install unzip sed xdelta openal-soft compat-openssl10

If you cannot run AM2R after installing the packages, use ldd in order to find out which packages are missing.
After patching, if you want to launch AM2R via command line, make sure to do it like this: env "LD_PRELOAD=libcurl.so.3" ./AM2R.
However, there is also a .desktop file with the above command included (this one has the AM2R logo). You can just double click on that in order to start the game.

Some distributions don't give you any way to install libcurl3 anymore. Should that be the case, try to generate an empty library like so:

touch empty.c
gcc -c empty.c empty.c -fPIC
gcc -fPIC -shared -Wl,-soname,libcurl.so.4 empty.o -o libcurl.so.4

And then launch AM2R with LD_LIBRARY_PATH pointing to where your generated .so file is. For example LD_LIBRARY_PATH=/home/me/libcurl-lib ./AM2R