Getting Started

Prerequisites

1. Confirm System Version

M9A on Windows only supports Windows 10 and 11. For older Windows versions, please refer to the system issues section in the FAQ (Note: Original link points to MAA docs, adapt if needed).

Warning

The following content originates from MAA and differs from M9A, so it’s for reference only. PlayCover is temporarily not supported.

If you are using MacBook with Apple Silicon, please go to this page (Note: Original link points to MAA docs). M9A also supports Macs with Intel chips (Note: Original link points to MAA docs), but we would rather recommend you to install Windows on your Mac and use the Windows version of M9A.

If you wish to use M9A on Android devices, please go to this page (Note: Original link points to MAA docs).

2. Install Runtime Environment

Windows

For Windows users:

  1. VCRedist x64 must be installed: This is the basic requirement for running M9A (whether it is the command line version or the graphical interface version MFAAvalonia).

  2. If you use the graphical interface (MFAAvalonia), you need to install .NET 8:

    • It is recommended to visit the .NET official download page and download and install the .NET Desktop Runtime 8 that is suitable for your system (usually the x64 version).

Installation via winget (recommended): You can also right-click the Windows Start button, select “Command Prompt” or “PowerShell (Administrator)”, and then paste the following command in the terminal and press Enter to conveniently install VCRedist x64 and .NET 8 Desktop Runtime at the same time:

winget install Microsoft.VCRedist.2017.x64 Microsoft.DotNet.DesktopRuntime.8

Other Systems (Linux, macOS)

Linux

Python Version Dependency:

macOS

Python environment: The macOS version of M9A has a built-in embedded Python environment, so you do not need to install or configure Python separately. The program will automatically use this embedded environment and manage its dependencies.

Additional dependencies for the graphical user interface (MFAAvalonia) (applicable to Linux and macOS)

If you plan to use the graphical user interface (MFAAvalonia) on Linux or macOS, you also need to install the .NET 8 runtime.

3. Download the Correct Version

Download from the M9A Releases page.

Chinese Mainland users can also download it at high speed through MirrorChyan.

Windows

Usually, download the M9A-win-x64-<version>.zip file.

macOS

Linux

Same as MacOS. Download and grant execute permissions to use MaaPiCli or MFAAvalonia.

Android

This version is not recommended for general users and has been removed from the release version. If you are very familiar with mobile phone operation, you can refer to the Usage Method and the Development Documentation to install it yourself.

4. Extract Correctly

Extract the entire contents of the downloaded .zip file to a folder path that does not contain any non-English characters or spaces. For example, D:\M9A is good, but D:\游戏 工具\M9A is bad.

5. Confirm Emulator Support

M9A relies on emulators. Supported emulators are generally listed in the List of Supported Emulators and Devices documentation. Common choices include MuMu Player 12, LDPlayer 9, BlueStacks 5, NoxPlayer. Ensure your emulator is supported and properly configured.

6. Set Emulator Resolution Correctly

The game must run at 1280x720 resolution inside the emulator. Configure this in the emulator’s display settings. Incorrect resolution is a common cause of recognition failures.

Warning

Note that after changing the resolution, the simulator homepage should be horizontal (tablet version), do not select vertical (mobile version)!

7. Pip settings (Windows)

Content in config/pip_config.json :

{
    "enable_pip_update": true, # Whether to enable update pip, default true, recommended to enable
    "enable_pip_install": true, # Whether to enable pip installation, default true, recommended to enable
    "last_version": "v3.2.0", # Read the version of interface.json when pip is installed, compare it with the version when it is started, and try to install it if it is different
    "mirror": "https://mirrors.ustc.edu.cn/pypi/simple", # Mirror source. The parameters after pip install -i can be filled in according to personal needs. Note that users outside the mainland should modify the value to ""
    "backup_mirrors": [
     "https://pypi.tuna.tsinghua.edu.cn/simple",
     "https://mirrors.cloud.tencent.com/pypi/simple/",
     "https://pypi.org/simple"
    ]  ## Backup mirror source
}