FAQs
FAQs
If this is your first time using MAA, please read Getting Started.
Warning
If MAA fails to run after an update, or if you've arrived here from MAA's error window, it's most likely due to outdated runtime libraries.
The most common issue is related to runtime libraries, and many people keep asking about it without reading the documentation, so we changed the pinned message to this. It's frustrating.
Please run DependencySetup_依赖库安装.bat
in the MAA directory, or execute the following command in terminal:
winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements && winget install "Microsoft.DotNet.DesktopRuntime.8" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
Or manually download and install these two runtime libraries to solve the problem:
Software won't run/crashes/shows errors
Download/Installation issues
- A complete MAA software package is named "MAA-
version
-platform
-architecture
.zip"; others are "components" that cannot be used independently. Please read carefully.
In most cases, you need the x64 architecture of MAA, meaning you should downloadMAA-*-win-x64.zip
, notMAA-*-win-arm64.zip
. - If you find missing or non-working features after an automatic update, the update process may have had issues. Please download and extract the complete installation package again. After extraction, drag the
config
folder from your oldMAA
folder into the newly extractedMAA
folder.
Runtime library issues
Find the up arrow ↑ at the bottom right of the webpage and click it.
System issues
- MAA doesn't support 32-bit operating systems or Windows 7/8/8.1.
- The runtime installations above require Component Store Service (CBS, TrustedInstaller/TiWorker, WinSxS).
If these services are damaged, installation will fail.
We cannot provide repair solutions other than reinstalling your system. Please avoid using "slimmed" system versions without clear documentation of what was removed, or extremely outdated systems.
Windows N/KN
For Windows N/KN (European/Korean versions), you also need to install the Media Feature Pack.
Windows 7
.NET 8 doesn't support Windows 7/8/8.1 systemssource, so MAA no longer supports them either. The last usable .NET 8 version is v5.4.0-beta.1.d035.gd2e5001e7
; the last usable .NET 4.8 version is v4.28.8
. Self-compilation feasibility remains undetermined.
For Windows 7, before installing the two runtime libraries mentioned above, check if these patches are installed:
- Windows 7 Service Pack 1
- SHA-2 code signing patches:
- KB4474419: Download link 1, Download link 2
- KB4490628: Download link 1, Download link 2
- Platform Update for Windows 7 (DXGI 1.2, Direct3D 11.1, KB2670838): Download link 1, Download link 2
Workaround for .NET 8 applications running abnormally on Windows 7 #8238
When running .NET 8 applications on Windows 7, abnormal memory usage can occur. Follow these steps to mitigate it. Windows 8/8.1 hasn't been tested; if similar issues occur, please open an Issue to remind us to update the documentation.
- Open
Computer
, right-click in empty space, click Properties, clickAdvanced system settings
on the left, and clickEnvironment Variables
. - Create a new system variable with name
DOTNET_EnableWriteXorExecute
and value0
. - Restart your computer.
Connection errors
Verify ADB and connection address are correct
See Connection Settings.
Close existing ADB processes
After closing MAA, check Task Manager
- Details
for processes containing adb
. If found, end them and retry connecting.
Properly use multiple ADB instances
When ADB versions differ, newly started processes will close older ones. If you need to run multiple ADB instances simultaneously (e.g., Android Studio, Alas, phone managers), ensure they use the same version.
Avoid game accelerators
Some accelerators require restarting MAA, ADB, and the emulator after enabling or disabling acceleration.
For using UU Accelerator with MuMu, refer to the official documentation.
Restart your computer
Restarting solves 97% of problems. (Trust me)
Try a different emulator
Please refer to Emulator and Device Support.
Connected but no operation
Some emulators come with outdated ADB versions that don't support Minitouch
or MaaTouch
.
Run MAA as administrator, close the emulator, restart MAA, and click MAA Settings
- Connection Settings
- Force Replace ADB
.
Emulator updates may overwrite the ADB file. If the issue returns after an update, try replacing again or use alternative ADB.
Connected but operations are laggy, abnormal, or error-prone
- If you've enabled
Notched Screen UI Adaptation
, set it to 0. - If using a non-CN client, first select your client version in
Settings
-Game Settings
-Client Type
. Some features may not be fully adapted for non-CN clients; refer to the corresponding documentation. - For Integrated Strategy automation, check the Auto Integrated Strategy documentation and correctly select the theme in
Auto Integrated Strategy
-Integrated Strategy Theme
. - If auto-combat frequently pauses without deploying operators, disable
Matchstick Mode
inSettings
-Operation Settings
. - If auto-squad formation can't recognize operators correctly, remove special focus from those operators.
Adb Input
touch mode is naturally slow; try switching to other modes for functions like auto-combat.
"Screenshot takes too long" message
- MAA currently supports three ADB-based screenshot methods:
RawByNc
,RawWithGzip
, andEncode
. When average screenshot time exceeds 400/800ms, a notification appears once per task. Settings - Connection Settings
displays min/avg/max times for the last 30 screenshots, refreshed every 10 screenshots.- Auto-combat features (like Integrated Strategy) are heavily affected by screenshot times.
- Screenshot performance is unrelated to MAA but depends on computer performance, background processes, or emulator. Try clearing background tasks, changing emulators, or upgrading your computer.
Administrator permissions issues
MAA shouldn't need Windows UAC administrator privileges for any functionality. Current admin-related functions include:
Auto-detect connection
: Administrator rights needed when the target emulator runs as administrator.Close emulator when done
: Administrator rights needed when the target emulator runs as administrator.Auto-start MAA at boot
: Cannot be set when running as administrator.- When MAA is incorrectly extracted to paths requiring admin rights for writing, like
C:\
orC:\Program Files\
.
Reports indicate that systems with disabled UAC may run applications as administrator even without explicitly selecting "Run as administrator." We recommend enabling UAC to prevent unexpected privilege escalation.
Download stops midway with "login"/"authentication" prompt
Please use a browser / IDM / FDM or other downloaders to download files, DO NOT use Thunder!