Table of Contents

Version/Platform Questions
Installation Instructions
Controller Questions
Display Questions
General Game Questions
Save Questions
Windows Specific Questions
Linux Specific Questions
Android Specific Questions
Customization Questions
Multitroid Questions

Version/Platform Questions

What is the latest available version?

The current version is 1.5.5 and can be installed with the AM2RLauncher.

Do different platforms have different versions or content?

The latest available version is released on all supported platforms (see next question) and can be installed via the AM2RLauncher. Main game content differs between versions (1.3 versus 1.5, for example), but not between different platforms within the same version - with the exception of platform-specific limitations like custom file loading on Android.

What are the currently supported platforms?

Windows, Android, and Linux (x86).

What are the minimum specifications to play AM2R on a PC?

An AMD E-300 APU with Radeon HD Graphics and 3GB of RAM should give you fullspeed for the whole game assuming you play on 4:3 and have custom palettes disabled, with some slight stuttering for X Parasite morphing.
If you have perfomance problems on Windows, be sure to check out the question “AM2R runs slow on Windows!”.
Chromebooks will need higher requirements if you’re using Linux (Beta)/Crostini.

What are the minimum specifications for Android?

  • Quad-core 1.2Ghz CPU
  • Dedicated GPU
  • 2GB RAM

These specs will provide full-speed gameplay almost everywhere, with some slowdowns in non-critial areas with a large amount of objects, such as the main caverns of Area 2, Area 3, and Area 5. Weaker GPUs may slow down in Fusion difficulty during X Parasite morphing.

Where can I stay up-to-date on AM2R?

  • DoctorM64’s AM2R blog - Original AM2R blog by DoctorM64. DoctorM64 and the rest of the original AM2R development team have no association with the Community Updates.
  • Reddit - The official AM2R Subreddit.
  • Discord and Matrix - The official AM2R Server/Space, both of which are bridged together.
  • YouTube - The official AM2R Community Updates YouTube channel.

Can I play AM2R on a Mac?

Macs are not officially supported. There is however, an unofficial port available here: https://github.com/Miepee/AM2R-Autopatcher-Mac

If you’re unable to use that, M1 and x64-based Macs are reportedly able to run AM2R via Crossover, and for older Macs an x86-based system may be able to run AM2R via Wine/Wineskin or through a VM. Keep in mind however, that those solutions will be significantly slower than running it natively.
Alternatively, you can also use Bootcamp on x64-based Macs in order to run the Windows version of AM2R.

Can I play AM2R on iOS?

AM2R cannot be run on iOS.

Can I play AM2R on a Chromebook?

You have four options:

  • Use a VM. This is NOT recommended, as Chromebooks are notoriously weak/slow devices.
  • Install the Android version of AM2R on your Chromebook. This requires a controller in order to play. Keyboard controls will not currently work.
  • Install the Linux version of AM2R on your Chromebook via Crostini. This requires an x86 based Chromebook and you need to have Crostini/Linux (Beta) enabled on your device. For more details, check the Linux Installation Guide further down.
  • Install a Linux distro onto your Chromebook, and use the native Linux version. This will lead to better performance, should you struggle with the option above, but only works with select Chromebooks. See this for more details: https://wiki.galliumos.org/Hardware_Compatibility

Can I play AM2R on the Switch/PlayStation Vita?

The Switch and PlayStation Vita are not supported platforms. Ports of the Community Updates for these platforms have been made by third parties, but they were created with pirated development tools and violated SDK NDAs; as such every support question regarding them will be deleted, and may result in a ban from our communication channels.

GameMaker: Studio 1.4 has a PlayStation Vita export module. Why can’t you make a build?

That module was discontinued before any of the developers on our team could legitimately obtain a copy. Somebody else who already has the module could export the game, but we can’t officially support it as we don’t have firsthand access and are unsure of the legal concerns surrounding the Sony developer agreement.

Can I play AM2R on [third-party handheld emulation device]?

If it is running Android or x86-based Linux, you can probably install the respective version of AM2R. However, these devices are not officially supported as they often use highly specialized versions of Android and Linux.

Can I play AM2R on ARM Linux devices?

ARM Linux is officially unsupported, as the Game Maker: Studio version we use does not have ARM Linux Support.
However, there is a community made tool that allows you to run Android Games on ARM Linux, which you can check out here: https://github.com/JohnnyonFlame/droidports
A guide on how to use it can be found in this Reddit post, along with some answered FAQ in the comments: https://www.reddit.com/r/AM2R/comments/pgp2x7/am2r_raspberry_pi_take_4/

How is AM2R still being updated? Didn’t the developers get a DMCA?

After the DMCA back in 2016 the original team ceased development. However, a talented programmer named YellowAfterlife reconstructed the source code in about 4 months.
That source was eventually released to the public and a few members of the community took it upon themselves to release a “community patch” to fix some major bugs in the game. Eventually that one update became multiple bug fix patches, until eventually it started to add some content that was planned by the original devs before the DMCA.
Things like New Game+ and Random Game+ modes were added, along with the planned secret ending, widescreen and eventually Fusion Difficulty!
For almost 5 years now we’ve been adding content like some of the creatures that didn’t make it from the original Metroid II, fixing bugs from the initial release, and working towards the final 2.0 update - a full graphical overhaul with some other unannounced content.
To limit liability and respect the DMCA, we only distribute patches that are applied to AM2R 1.1 like a ROMhack. Our AM2RLauncher application automates this process for easy installation and updates.

Installation Instructions

How do I install the latest version on Windows?

  1. Head to the AM2RLauncher download page, download the Windows version, and unzip the file to its own folder: https://github.com/AM2R-Community-Developers/AM2RLauncher/releases/latest
  2. Make sure that you have .NET Framework 4.8 installed. Chances are that you probably do, but if not the official download from Microsoft can be found here: https://dotnet.microsoft.com/download/dotnet-framework/net48
  3. Locate your copy of AM2R 1.1.
  4. Open the Launcher by double-clicking on the AM2RLauncher.
  5. Click on the Download button and let it download the necessary patch files.
  6. Click on the Select 1.1 button, select your copy of AM2R 1.1, and let the AM2RLauncher verify it/prepare for installation.
  7. Click on the Install button.

How do I install the latest version on Linux?

Flatpak / Steam Deck

For a universal Linux install without the need to install any dependencies, or for Steam Deck users, you can choose to use the Flatpak version of the AM2RLauncher.

  1. Follow the instructions for your Distro to install Flatpak if don’t have it installed already. Steam Deck users can skip this step.
  2. Install the AM2RLauncher Flatpak. This may be from the linked site, or your software center, such as Discover on the Steam Deck.
  3. Launch the AM2RLauncher, and follow the instructions from “Install Community Updates” further down.
Native install

First you need to download the right dependencies: .NET Runtime (6.0 or higher), xdelta3, gtk3, libappindicator3, webkitgtk, openssl and fuse2. In addition, you also need the following dependencies for AM2R itself: Multilib / 32-Bit architecture added, and the 32-Bit version of libpulse.
A detailed installation for each distribution with commands is available on the GitHub Wiki page.

After that, you need to download and start the AM2RLauncher:

  1. Head to the AM2RLauncher download page, download the Linux version and unzip the file to its own folder: https://github.com/AM2R-Community-Developers/AM2RLauncher/releases/latest
  2. Make sure that you have the following dependencies for the AM2RLauncher installed:
  3. Mark AM2RLauncher.Gtk as an executable, and then run it. This can be done like this: chmod +x AM2RLauncher.Gtk and ./AM2RLauncher. Alternatively, if your desktop environment supports it, you can also double-click on the file after it has been marked as an executable.
  4. Follow the instructions from “Install Community Updates” further down.
Install Community Updates
  1. Click on the Download button and let it download the necessary patch files.
  2. Click on the Select 1.1 button and select your copy of AM2R 1.1 and let the AM2RLauncher verify it.
  3. Click on the Install button.

How do I make sure the AM2RLauncher will update my copy of AM2R 1.1?

The AM2RLauncher will make sure that your copy is legitimate.

Help! The AM2RLauncher gave me an error code when putting in 1.1!

There are a series of return codes the AM2RLauncher will give you if your copy of 1.1 is incorrect. Here’s what they mean:

  • MissingOrInvalidAM2RExe: AM2R.exe is not from 1.1.
  • MissingOrInvalidD3DX9_43Dll: D3DX9_43.dll is not from 1.1.
  • MissingOrInvalidDataWin: data.win is not from 1.1.
    Note: If you got one of the above codes, you may be trying to give the AM2RLauncher 1.0 or one of the newer Community Updates. These will not work.
  • GameIsInASubfolder: The zip is improperly packaged. The game files should be in the root of the zip, not within a subfolder.

How do I install the latest version on Android?

The AM2RLauncher cannot be run on Android. Instead, you must use the Windows or Linux AM2RLauncher to create an Android APK to install.
After following the installation instructions for Windows or Linux, ensure that you have the latest Java runtime installed and then click the Create APK button.
The resulting file can be transferred onto your Android device however you desire, and can then be installed like any other APK.
There is a way to create the APK on your Android device without the AM2RLauncher, but please only do this if you absolutely have no access to any PC.

I have no access to any PC, how do I install the latest version on Android?

  1. Place your copy of AM2R 1.1 into your Downloads folder and make sure it’s named like this: AM2R_11.zip (case sensitive).
  2. Download and install Termux (preferably from F-Droid, not the Google Play Store as those builds are not official). You can find download links for that here: https://f-droid.org/packages/com.termux/
    Just scroll down, you don’t need to download the F-Droid Store. Download and install the Termux APK for the latest version.
  3. Open Termux, let it set up, and then paste this command in there:
    pkg install wget && wget -O patcher.sh https://github.com/AM2R-Community-Developers/AM2R-Autopatcher-Android/raw/main/patcher.sh && chmod +x patcher.sh && ./patcher.sh
  4. In the middle of the patching process, it will ask you once if you want the high quality music or not. It is generally recommeneded to not download it, as it is ~230MB big and can cause mobile devices to lag, but if you really wish to have it the option is there for you.
  5. Wait for the patching process to complete.
  6. When it’s done, it will save the APK to your Downloads folder and automatically prompt you to open the APK. Simply choose your system’s APK/package installer for this.

The AM2RLauncher takes a long time to download the update files. Is this normal?

Yes. Depending on your internet speed and your download mirror’s speed, this may take a while. You can try changing your mirror by going to the Download Mirror dropdown in the Options tab and seeing if that gets you a better speed.

I’ve encountered an issue with the AM2RLauncher. What do I do?

You can ask for support in the communication channels listed above. Please provide relevant system information, steps you took, and the AM2RLauncher.log file which can be found in the Logs folder.
On Linux, the Logs folder will be found in ~/.local/share/AM2RLauncher instead, or for Flatpak/Steam Deck users in ~/.var/app/io.github.am2r_community_developers.AM2RLauncher/data/AM2RLauncher.
If you encountered a bug with the Launcher itself or something where support cannot help you, open an issue at the AM2RLauncher GitHub page.

I am on Windows and launching the AM2RLauncher says I need .NET Framework 4.8. What do I do?

You click on the Please lead me to the download button. Alternatively, if you already closed it, visit this link:
https://dotnet.microsoft.com/download/dotnet-framework/net48

I am on Windows 8 and AM2R doesn’t run or has other issues when I click on “Play”, what do I do?

  1. Navigate into Profiles/Community Updates (Latest).
  2. Create a shortcut of AM2R.exe.
  3. Right-Click the created shortcut and navigate to properties.
  4. On the Target text box, add -software at the end.

If you have mods installed, this needs to be done for every one of them individually.

Additionally, we cannot guarantee future support for Windows 8, as official support for the operating system ended in 2016.

How do I install mods?

  1. Download the .zip file of the mod you want to play.
  2. Open the AM2RLauncher and click on the Mod Settings Tab.
  3. Click on the Add New Mod button.
  4. Go back to the Play tab and select the mod from the dropdown menu.
  5. Click on the Install button - or if the mod is supported on Android and you want to create an apk for it, the Create APK button.

I am on Linux and I don’t want to use the AM2RLauncher. What do I do instead?

This is not recommended, due to you missing out on automatic release updates, mod support, and easier use. However, the legacy installer can be found here:
https://github.com/AM2R-Community-Developers/AM2R-Autopatcher-Linux
Again, it is not recommended to use the manual installation. For help, please use our GitHub issues page or our communication channels.

I am using Manjaro, and AM2R doesn’t run. How do I fix this?

Unfortunately, we have been unable to figure out why AM2R will not run on Manjaro. Insights are greatly appreciated at our GitHub issues page or our communication channels.

Controller Questions

Which controllers does AM2R support?

Every controller that your operating system natively supports should work. Bluetooth support is not guaranteed; if you are having issues after checking the rest of this section, please try using a wired connection.

I am on Windows and have trouble getting my Switch Pro Controller to work, what do I do?

The Switch Pro Controller is not natively supported by Windows. You need to use a separate program in order to get it recognized, like BetterJoy or Steam.

The D-Pad on my Dualshock 4 controller is not working!

The Dualshock 4’s D-Pad won’t work with AM2R, due to Sony making it act as an analogue stick internally and the DS4 not being natively supported by Windows. You need to use a seperate program that converts DInput to XInput, like DS4Windows or Steam - or you can just play without the D-Pad.

I am on Linux and my controllers don’t work!

  1. Check first if enabling Compatibility Mode in the Control options and restarting AM2R fixes the issue.
  2. GameMaker: Studio 1.4 recommends the following dependencies, try to see if installing them fixes it: jstest-gtk and joystick.
  3. If all fails, ask in our communication channels for more help.

How do I get a controller connected to my Android device?

Either connect the controller via Bluetooth (check the manual for your phone and controller) or plug it in via a cable (if your controller/phone supports it). Bluetooth is not recommended for the DS4, as it is known to lag on some Android installations.

Display Questions

What’s AM2R’s native resolution?

AM2R’s native resolution is 320x240 in 4:3 or 426x240 in 16:9.

How do you change the game’s resolution?

You can change the game resolution by going into Options -> Display Options and changing the Window Scale option.

How do you change the aspect ratio?

In 1.5.1 and above, the aspect ratio can be toggled between 4:3 and 16:9 by going into Options -> Display Options and toggling the Widescreen option. If you are in-game, this setting will require a room transition to take effect.

I am on Linux and the display gets stuck/corrupted if I boot from fullscreen!

Due to GameMaker: Studio 1.4 shenanigans, this can’t be fixed at the boot screen. From 1.5.3 and onwards it should be fixed once you reach the “A controller is recommended” screen.

How do I use the GameBoy filters?

The GameBoy color filters can be cycled in the Options -> Extras menu or if you’re on a PC you can use F9.

How do I use filters like CRT, scanlines, or XBRZ?

Except for the GameBoy filters, AM2R does not provide any in-game filters. On Windows you can use an application called ReShade to use custom filters (the game uses D3DX9), but it is not officially supported and we can’t answer any support questions you have about it.

General Game Questions

How many difficulties are there, and what are the differences between them?

There are 4 difficulties in AM2R: Easy, Normal, Hard and Fusion. Their features are as follows:

  • Normal is the difficulty the game is primarily balanced around. It is recommended for first-time players.
  • In Easy, you take half of Normal damage.
  • In Hard, some enemies have enhanced behavior, you take 2x Normal damage, and have reduced ammo pickup counts (2 Missiles/1 Super Missile/1 Power Bomb per tank instead of 5/2/2).
  • In Fusion, all Hard changes apply with 4x Normal damage, Fusion Suit graphics, X Parasites spawning instead of health/ammo pickups from organic enemies, and Core-X spawning as a final phase for organic or semi-organic bosses.

I don’t see the Fusion difficulty. How do I unlock it?

In order to unlock Fusion difficulty you need to beat the game once with a 100% item completion or use the cheat code described below.

I already beat the game once and/or want to jump straight into the other gamemodes. How can I unlock the other gamemodes?

If you’re at the file select screen, you can input this cheat code to unlock the extra gamemodes:
[UP][UP][DOWN][DOWN][LEFT][RIGHT][LEFT][RIGHT][ACCEPT][BACK]
A sound will play if you input the code successfully.

I want to start the game with the Hatchling. How do I unlock it?

If you’re at the file select screen, you can input this cheat code to unlock the Hatchling:
[UP][LEFT][DOWN][RIGHT][RIGHT][DOWN][LEFT][UP]
A sound will play if you input the code successfully.
This cheat does not affect gameplay and is purely cosmetic.

How many gamemodes are there and what is the difference between them?

There are 3 gamemodes: New Game, New Game+ and Random Game+. New Game+ and Random Game+ must be unlocked by beating the game once. The features are as follows:

  • New Game is the normal adventure.
  • New Game+ makes the game less linear by lowering the lava to just before the Nest, giving you immediate access to every area up until Area 5 (the Distribution Center). The bomb blocks between Area 1 and Area 2 have been removed to open early game progression further.
  • Random Game+ randomizes item locations. All New Game+ changes apply. More intermediate skills like Wall Jumping and Infinite Bomb Jumping are recommended, and sometimes necessary. In order to minimize softlocking, the first Super Missile and Power Bomb locations are not randomized, enemies will drop Power Bomb drops if you do not have Bombs yet, some passages have been cleared already, some block weaknesses have changed to normal Shoot Blocks, and Septoggs will help you reach greater heights. While this mode minimizes softlocks, they can still happen, so save often.
    There are also 3 different Random Game+ types, which are:
    • Classic Mode:
      • Power-ups Only: Only power-ups are randomized, with a guarantee of Bombs being present in Area 1.
      • Starting Paths: There are two different item pools, expansions and power-ups. The location for Bombs in Golden Temple will be either Bombs, Power Bombs or Screw Attack. The bomb blocks between Area 1 and Area 2 have been brought back for stricter path enforcement.
    • Split Random: There are two different item pools, expansions and power-ups. Expansions can be any expansion, and power-ups can be any power-up.
    • AM2Random: Expansions and power-ups are fully randomized together.

I’m stuck in Random Game+! How do I proceed?

Check first if you truly are stuck, you may have missed a path or an item somewhere.
Otherwise, post your seed, game mode and operating system into our communication channels for people to help you!

What is the rock-platform with wings and eyes, and what does it do?

The Septoggs were creatures found in the original M:II as platforms to help with Space Jumping. We wanted to include them along with the Blob Throwers to complete the enemy roster from the original game, but had to come up with another purpose for them to work besides simple floating platforms.
They do help the player, which is most noticeable in Random Game+, but they also act as environmental story telling akin to the Zebesian Roaches and Tatori from Super Metroid. This can be seen with the Baby Septoggs randomly appearing in certain areas with camouflage of that environment and more and more babies appearing by husks in the breeding grounds as the game progresses.

What is Insanity Mode?

A red save file indicates Insanity Mode. It can be toggled in the Gameplay menu, and changes the following:

  • Saving is disabled.
  • You get power bomb drops for the length of the game.
  • Reactor E-Tank is guaranteed.
  • No miniboss or spike plant drops in Hard and Fusion difficulties.
  • No easy helper Septoggs in Random Game+.

What is the maximum amount of pickups I can collect?

The maximum collection is 10 E-Tanks, 44 Missile Expansions, 10 Super Missile Expansions, and 10 Power Bomb Expansions. This leads to a total of 1099 health, 250 Missiles, 20 Super Missiles and 20 Power Bombs on Normal, and on Hard and higher to 1099 health, 118 Missiles, 10 Super Missiles and 10 Power Bombs.

How do I translate the last log?

It will be automatically translated before the game ends after you reach the surface.

How many ending images are there, and how do I unlock them?

There are 3 endings:

  • Ending 1: If you’re playing on Easy, or you’re playing on a higher difficulty but your completion time is over 4 hours.
  • Ending 2: If you’re playing on Normal or higher and your completion time is less than 4 hours.
  • Ending 3: If you’re playing on Normal or higher and your completion time is less than 2 hours.

Save Questions

I still have an old version of AM2R installed, will updating it delete my saves?

No, updating AM2R or switching to the AM2RLauncher will not delete your saves, those are kept completely seperate.
However, loading old saves in a new version may make it unsafe to load them in old versions of the game again! If you’re worried, make backups before updating.

Where can I find my saves on Windows?

Saves are located in:
C:\Users\[Your User Name]\AppData\Local\AM2R
If you use the AM2RLauncher, you can go to the Mod Settings tab, and click on Open Profile Save Folder to quickly open that directory.

Where can I find my saves on Linux?

Saves are located in:
~/.config/AM2R
If you use the AM2RLauncher, you can go to the Mod Settings tab, and click on Open Profile Save Folder to quickly open that directory.

Where can I find my saves on Android?

In order to access your saves on Android, you need to have root access. After that, you can find your saves in one of these locations depending on your version:
/data/data/com.companyname.AM2RWrapper/files
/data/data/com.lojical.AM2R/files/

Are saves cross-platform?

Yes, saves are cross-platform.

Can I use save files from earlier versions?

Yes, but compatibility is not guaranteed. See questions above to where saves are located.
1.0/1.1 saves use the filename savN.
1.5+ saves use the filename saveN.
Some older Community Update saves use the filename saveXN.
N is either 1, 2 or 3, depending on the save slot.

Windows Specific Questions

AM2R doesn’t show on the Taskbar!

This is an issue with GameMaker: Studio 1.4. To fix it, Alt-Tab out and back into the game.

I have trouble streaming AM2R in Discord!

Discord sometimes has trouble picking up other games - particularly if they’re fullscreen. You can try to:

  • Alt-Tab out and back in and see if Discord recognizes the game.
  • Add AM2R as a game manually, by going to your User Settings.
  • Disable fullscreen on AM2R.

AM2R runs slow on Windows! Way slower than previous versions!

YoYo Games made changes to some Windows-specific behavior that cause it to run slow on certain setups.
To fix this, you may need to change the SleepMargin value in options.ini - higher values will take up more CPU cycles but will be less prone to the slowdown.
If you are confused about this issue, please ask in our communication channels for help.

My custom palette / the 8-bit shader doesn’t appear!

AM2R requires DirectX9.0 installed and hardware shader support to properly display some palette changes in Fusion difficulty, allow the 8-bit shader to work, and enable custom palettes.
Until DirectX9.0 is installed and the shaders properly compile, the above mentioned features will not work properly.
The required DirectX version (June 2010) can be found on Microsoft’s website here:
https://download.microsoft.com/download/8/4/A/84A35BF1-DAFE-4AE8-82AF-AD2AE20B6B14/directx_Jun2010_redist.exe

Additionally, the repalette shader will not apply to the M:SR Fusion Suit variant. It will only recolor the Fusion Suit on the default setting. This can be accessed in the Extras menu.

A final note: some graphics cards simply will not support the repalette shader.

How can I make AM2R on Windows portable?

In order to make AM2R portable, create the following files in the asset folder (the folder containing AM2R.exe and data.win):

  • save1 through save3
  • config.ini
  • extras.sav

Please note that this is not officially supported, and is merely an exploitable quirk of GameMaker: Studio 1.4’s file detection.

Linux Specific Questions

The Launcher crashes with the message “The required library libhostfxr.so could not be found” on start!

  1. Make sure that you installed the .NET Core runtime. Open a terminal, and type in dotnet --info. If the command doesn’t error and you have Microsoft.NET.CORE.App with a version newer than 5.0 you installed it correctly.
  2. Make sure you don’t install the .NET Core runtime via Snap. If you did install it via Snap, uninstall it and install it following Microsoft’s instructions.

Microsoft’s instructions for installing .NET Core can be found here:
https://docs.microsoft.com/en-us/dotnet/core/install/linux
Scroll down to the distro you’re using, and then click on your installed distro version to get more detailed commands.

I have an Nvidia GPU with proprietary drivers and the game doesn’t launch!

Update to the AM2RLauncher 2.2.0 or later, as this problem is fixed there!
Otherwise, make sure that you have the 32-bit version of your drivers installed first.
Then in the AM2RLauncher, go to the Options tab, and use the LD_PRELOAD environment variable that points to your OpenGL drivers.
If you’re on Ubuntu, this will probably look like this LD_PRELOAD=/usr/lib/i386-linux-gnu/libGL.so.1, if you’re on Arch, it’ll look like this LD_PRELOAD=/usr/lib32/libGL.so.
It may look different on other distros. If you have to use a different flag for a different distro, please let us know in our communication channels so we can include it here!

I have an AMD GPU and the game doesn’t launch!

Update to the AM2RLauncher 2.2.0 or later, as this problem is fixed there!
Otherwise, make sure that you have the 32-bit version of your drivers installed first.
Then in the AM2RLauncher, go to the Options tab, and use one of the following environment variables: radeonsi_sync_compile=true, R600_DEBUG=mono, R600_DEBUG=vs.ps, R600_DEBUG=check_vm.
It’s not a guarantee which one will work, so you’ll likely have to try them all.

I am on Ubuntu, have an Intel GPU and the game doesn’t launch!

Update to the AM2RLauncher 2.2.0 or later, as this problem is fixed there!
Otherwise, make sure that you have the 32-bit version of your drivers installed first.
Then in the AM2RLauncher, go to the Options tab, and use the following environment variable: LIBGL_DRI3_DISABLE=1.

How can I use custom palettes or change the modifiers file? I only see the AppImage!

  1. cd into directory where the AppImage is located.
  2. Run ./AM2R.AppImage --appimage-extract. This will create a new folder called squashfs-root.
  3. Navigate to squashfs-root/usr/bin/assets to see replacable assets.
  4. Do any modifications you like.
  5. Run the game by executing the AppRun file in the squashfs-root folder.
  6. OPTIONALLY: Repack it back into an AppImage by executing ARCH=x86_64 ~/.local/share/AM2RLauncher/PatchData/utilities/appimagetool-x86_64.AppImage -n ~/.local/share/AM2RLauncher/Profiles/[YOUR PROFILE HERE]/squashfs-root. This will create a new AppImage called AM2R-x86_64.AppImage with your changes.

I am on Gentoo and the AM2RLauncher doesn’t produce an executable for me!

You probaly missed the lzma USE flag for xdelta3. Add it and try again.

Android Specific Questions

Why are some spots slow on my Android device?

Huge rooms and X morphing have a few effects going on that most Android devices’ GPUs (or lack thereof) have difficulty rendering. This is completely normal, and there is nothing that can be done about it.
If you installed HQ music, that could also potentially lead to slowdown.

On my PC I can see custom Fusion palettes, but not on my Android device. Why can’t I see them?

Custom palettes have been disabled on Android due to drastic performance issues.

Customization Questions

What mods are available for AM2R?

A community-run repository listing avilable mods for AM2R can be found here:
https://gitlab.com/Miepee/AM2R-Mods
The AM2R Community Developers do not take responsibility for any of the third-party mods listed here; this is merely a collection of publicly available mods, not an endorsement.

How can I create my own mods?

Please check out the instructions here:
https://github.com/AM2R-Community-Developers/AM2R-Community-Updates
Alternatively, you can also use UndertaleModTool:
https://github.com/krzys-h/UndertaleModTool

How do I use custom title images?

Place your custom image within the /lang/titles/ folder. It must use the following name format: language_x000_y000.png.

  • Replace language with the same name as the language file you use.
  • Replace 000 after both x and y with the necessary coordinate offsets.
  • For example, a valid title file might be named english_x048_y032.png

How do I use custom title backgrounds?

Place your custom image in the assets folder (where all the music are). It must use the following name format: titlebackground_f00_s00.png.

  • Replace the 00 after f with the number of frames in the background image.
  • Replace the 00 after s with the frame-per-second speed of the animation.
  • For example, a valid background file might be named titlebackground_f01_s60.png

How do I use custom area intros?

Place your custom sprite strip within the /lang/headers/ folder. It must use the following name format: language_a0_f00_b00_c00_d00_e00.png.

  • Replace the 0 after a with the area ID.
    • 1 - Golden Temple
    • 2 - Hydro Station
    • 3 - Industrial Complex
    • 4 - The Tower
    • 5 - Distribution Center
    • 6 - [has no intro]
    • 7 - Genetics Lab
    • 8 - GFS Thoth
  • Replace the 00 after f with the number of frames in your sprite.
  • Replace the 00 after b, c, d, and e with each of the 4 pause frame indices in the sprite.
  • See the example English A1 intro file for more context: english_a1_f24_b00_c03_d19_e21.png

How do I use custom suit palettes?

In the mods\palettes folder you will find folders containing editable palette files. The left column must stay untouched. Edit the right column with your desired colors.

How can I easily create my own suit palettes?

Electrix made an easy to use Suit Palette Creator! Check it out here!
https://electrixcodes.github.io/AM2RSuitEditor/

Where can I find custom suit palettes made by others?

A community-driven repository for custom suit palettes can be found here:
https://github.com/Miepee/AM2R-Custom-Palettes

How do I use custom fonts?

AM2R uses five different fonts; raw .ttf font files of the exact fonts used in AM2R have been included in the ‘lang/fonts’ folder. Two of these fonts (Glasstown NBP and uni 05_53) include nearly a thousand new glyphs that allow AM2R to be translated into many non-Latin languages, particularly for log messages and various descriptions.
The other three fonts (mainly used for GUI elements and titles) do not include as many glyphs but these font files can also be updated to include more characters; this will not be described here in detail, but the recommended process is to create the new letters in BitFontMaker2 and add the letters to the included .ttf files with FontForge. Both applications are free software.

How do I use custom music?

Simply go to the main game folder and replace the song of your choice with another .ogg file.

How do I use custom sound effects?

Replacing sound effects is not possible, unless you’re modding the game - in which case you should consult the GameMaker: Studio 1.4 or UndertaleModTool documentation.

How do I use custom sprites?

Replacing sprites is not possible, unless you’re modding the game - in which case you should consult the GameMaker: Studio 1.4 or UndertaleModTool documentation.

How can I change small game variables?

You can do that via the modifiers.ini file. Below is not a comprehensive list of what all resides in said file.

  • Various difficulty modifiers:
    • Depleted E-Tanks - You may change how much energy E-Tanks hold in modifiers.ini.
    • You may start with 0 through 30 missiles on game start.
    • You can change damage taken from plants and lava.
  • Randomizer seed - You may manually set the randomizer seed in modifiers.ini. This is also available in the Gameplay menu in-game.
  • Boss and some enemy health - You may manually set the health of bosses in modifiers.ini. You may only increase their health.
  • Boss and some enemy damage dealt - You may manually set the damage you receive from bosses in modifiers.ini. You may only increase this damage.

Multitroid Questions

Is Multitroid an official part of the Community Updates?

No, Multitroid is a mod made by MilesTheNerd. While we greatly enjoy the mod and Miles is part of our team, it is not officially supported at present due to the time and energy required to provide official multiplayer support.

How do I host on Multitroid?

  1. Download the corresponding AM2RServer version at https://github.com/lassiterm/AM2R-Server/releases/latest
  2. Either port forward, or use a VPN (like Hamachi, ZeroTier, Radmin etc.).
  3. Launch the AM2R Server.
  4. Give the other players your external IP address and port to connect with.
    Port forwarding is different on every router, consult your routers manual or the internet for more info. For VPNs, consult their documentation. We cannot answer questions about specific routers or VPNs.

How do I set up Multitroid?

  1. Install the mod (see “How do I install mods”).
  2. Launch Multitroid.
  3. Go to Options -> Multitroid.
  4. For the IP address, use the one provided by the host.
  5. For the port, use the one provided by the host.
  6. Choose anything you want for the display name.
  7. Choose Connect
  8. Choose a file to play on. The data from this file is synced with other players, so it’s best for everyone to start from a new file as well as everyone choosing the same mode.