FAQs
FAQs
Warning
MAA has been updated to .NET 8 in version 5.0. For end users, the impact is as follows:
- MAA now requires the .NET 8 runtime library, which will automatically prompt the user to install it when starting. If the installation fails, please read the following and download the installation package to install manually.
- MAA will no longer be falsely reported by Windows Defender.
- .NET 8 does not support Windows 7/8/8.1Src, so MAA is also no longer supported. The last available .NET 8 version is
v5.4.0-beta.1.d035.gd2e5001e7
; the last available .NET 4.8 version isv4.28.8
. The feasibility of self-compilation has not yet been determined. - When running .NET 8 applications on Windows 7, an abnormal memory usage problem will occur. Please refer to the Windows 7 section below to implement mitigation measures. Windows 8/8.1 has not been tested. If you have the same problem, please send an Issue to remind us to supplement the documentation.
The program crashes immediately when I try to run it
Incomplete file downloaded
- If you don't have a complete package of this software already, please DO NOT download the zip files marked with
OTA
in the file name, which are for incremental updates and shall not be used alone. In most cases, Windows users should downloadMAA-vX.X.X-win-x64.zip
. - In most cases, you need x64 operating system and x64 variant of MAA, i.e.
MAA-*-win-x64.zip
. There is no support for 32-bit (x86) operating systems. - If the application does not run properly after an automatic update, it may be due to some bugs within the auto-updater. Please try reinstalling the application and migrating
config
directory from the old install to the new install.
Missing runtime libraries
Only official sources are listed here. We can't guarantee whether some random third-party all-in-one pack can work.
Please try installing Visual C++ Redistributable and .NET Desktop Runtime 8, then restart computer.
Windows 10 or 11 users can also install using Winget by running the following command in the terminal.winget install Microsoft.VCRedist.2015+.x64 Microsoft.DotNet.DesktopRuntime.8
If MAA cannot run after an update, it may be caused by the runtime too. You can also try to install or update the runtime again.
Notes on Windows N/KN
- If you are using Windows 8/8.1/10/11 N/KN (Europe/Korea)editions, you also need Media Feature Pack。
Notes on Windows 7
If you are using Windows 7, you need to check the following updates before installing runtime libraries:
Mitigation measures for .NET 8 applications running abnormally on Windows 7 #8238
- Open
Computer
, right-click a blank space, click Properties, clickAdvanced System Settings
on the left, and clickEnvironment Variables
. - Create a new system variable with variable name
DOTNET_EnableWriteXorExecute
and variable value0
. - Restart the computer.
We cannot guarantee compatibility of future versions with Windows 7, it's all Microsoft's fault.
System broken
Installation of runtime libraries above requires the Component-Based Servicing (CBS) infrastructure (i.e. TrustedInstaller/TiWorker, WinSxS). Installation may fail if CBS is broken.
We have no suggestion other than reinstalling Windows. Please avoid using so-called "lite" editions, or some old versions of Windows from thousands of years ago (e.g. 1809).
Connection Error
- Tips: please refer to the List of the Supported Emulators section to ensure that the emulator you are using is officially supported and that your configuration is correct.
- If you are using software such as a game accelerator, please close the software, RESTART your computer and try again.
- Please check your decompression software - in some cases, using uncommon software such as
7z
or other niche decompression software may cause errors in Minitouch-related files.
Make sure ADB and address are correct
Check Connection
Change emulator
Change to another emulator, such as Bluestacks international version Nougat 64 bit.
After installation of Bluestack, you need to enable Android Debug Bridge
in the settings.
Close extra adb processes
- Close MAA and check for any adb processes in the task manager. If there are any, please close them and retry.
Restart computer
Try restarting your computer.
Connected successfully, then stuck, not operating at all
The adb version packaged with some emulators is too old and does not support minitouch. Please open MAA with administrator privileges and navigate to Settings
- Connection Settings
- Forced Replace ADB
. (It is recommended to close the emulator and restart MAA before proceeding, otherwise, the replacement may not be successful.)
The emulator will reset the ADB version after updating. If the problems occur again, please repeat the above steps. Or you can try to use the custom connection method to solve it once and for all.
If it still doesn't work, please retry after switching to MaaTouch
from Minitouch
in Settings
- Connection Settings
.
Connected successfully, but actions are slow or errors are frequent
- The auto-battle requires you to go to the screen with the
Start
button. Please confirm they are not related. - If you are using a non-CN client, please go to MAA Settings - Start-Up Settings - Select your client version. Not all features are currently supported for non-CN clients, please refer to docs.
- If you are running the auto-I.S. function, please PIN UP the IS theme you want in the game, and select I.S. theme in MAA
Task Settings
-Auto I.S.
. - The input method
Adb Input
is naturally slow. It is recommended to useMaaTouch
orMinitouch
instead.
Prompt that the screenshot takes a long time / is too long
- MAA currently supports 3 screenshot methods:
RawByNc
,RawWithGzip
, andEncode
. When the average screenshot time of executing a task is >400 / >800, a prompt message will be output (a single task will only be output once) Settings - Connection Settings
will display the minimum/average/maximum time taken for the last 30 screenshots, refreshed every 10 screenshots- Automatic combat functions (such as I.S.) are greatly affected by the time taken to take screenshots
- This time consumption is unrelated to MAA, but related to computer performance, current usage, or emulator. You can try cleaning up background processes, changing emulators, or upgrading computer configurations.
The download speed is slow and the mirror site is not accessible
- Go to Download to get the link (non-mirror) you want to download.
- Find the link to the file you need to download.
- Right-click it and select
Copy link address
. - Paste the link into your browser.
- Replace the
github.com
in the link withdownload.fastgit.org
. - Press
Enter
to download.
Download halfway and prompt "login"/"authentication"
Please use a browser / IDM / FDM and other regular downloaders to download files, Do NOT fucking use Thunder!