Quick Start

8/17/26About 4 min

AI Translation Notice

This document was translated using AI. Please refer to the Chinese documentation for the definitive version.

This guide will walk you through installing and using MAK (the 《雪松》 Assistant). Even if you know nothing about computers, you can succeed by following these steps one at a time!

Step 1: Check Your Computer

Before you begin, make sure your computer meets the following requirements:

Your computer runs Windows 10 or Windows 11 (see Which version of Windows operating system am I running?)
You have an Android emulator installed on your computer (software that lets you play mobile games on a computer)

What is an emulator?

An emulator is a program that lets you run mobile games on your computer. The following emulators are recommended:

MuMu 模拟器 (MuMu Player)
雷电模拟器 (LDPlayer)

In theory, any emulator that provides an ADB connection is also supported, as are physical devices.

If you have not installed an emulator yet, search for the relevant emulator, download and install it, and then continue.

Note

To use MAK with a physical device, refer to ADB Devices.

Step 2: Download MAK

Open your browser.
Enter the following URL in the address bar, then press Enter:
```
https://github.com/Hollow-YK/MaaAssistantKedrgame/releases
```

On the downloads page, find the latest version—the one listed at the top. MAK provides two user interfaces, MFAA and MXU, and each is available as an installer and an archive:

UI	Package type	Example filename	Recommendation
MXU	Installer	`MAK-win-x86_64-xxx-MXU-Setup.exe`	⭐ Recommended
MXU	Archive	`MAK-win-x86_64-xxx-MXU.zip`	For users who prefer not to install the application
MFAA	Installer	`MAK-win-x86_64-xxx-MFAA-Setup.exe`	Recommended
MFAA	Archive	`MAK-win-x86_64-xxx-MFAA.zip`	For users who prefer not to install the application

MFAA and MXU differ only in their user interfaces; they provide the same MAK tasks. Choose either one according to your preference. You do not need to download both.

Step 3: Install MAK

MXU Installer

This method is recommended for beginners.

Download MAK-win-x86_64-xxx-MXU-Setup.exe.
When the download finishes, double-click the file (quickly press the left mouse button twice).
If a blue warning dialog appears, click 仍要运行 (“Run anyway”), or click 更多信息 (“More info”) → 仍要运行 (“Run anyway”).
Follow the installation wizard to complete the installation.
Wait for the installation to finish.
Tip
Some antivirus software may block the installer. This is a false positive and is safe to ignore. If it is blocked, select 允许 (“Allow”) or 信任 (“Trust”) in your antivirus software.

MFAA Installer

This method is recommended for beginners.

Download MAK-win-x86_64-xxx-MFAA-Setup.exe.
When the download finishes, double-click the file (quickly press the left mouse button twice).
If a blue warning dialog appears, click 仍要运行 (“Run anyway”), or click 更多信息 (“More info”) → 仍要运行 (“Run anyway”).
Follow the installation wizard to complete the installation.
Wait for the installation to finish.
Tip
Some antivirus software may block the installer. This is a false positive and is safe to ignore. If it is blocked, select 允许 (“Allow”) or 信任 (“Trust”) in your antivirus software.

MXU Archive

Download MAK-win-x86_64-xxx-MXU.zip.
When the download finishes, extract it into a dedicated folder.
Warning
Use a path containing ASCII/English characters only, unless you are able to resolve the problems caused by other paths yourself.
For example, extracting to D:\MAK works, but extracting to D:\我的软件\MAK does not.
If you use a non-recommended directory, MAK and its developers reserve the right to decline support for any resulting issues.
After extraction, open the extracted folder, find MAK.exe, and double-click it to run MAK.

MFAA Archive

Download MAK-win-x86_64-xxx-MFAA.zip.
When the download finishes, extract it into a dedicated folder.
Warning
Use a path containing ASCII/English characters only, unless you are able to resolve the problems caused by other paths yourself.
For example, extracting to D:\MAK works, but extracting to D:\我的软件\MAK does not.
If you use a non-recommended directory, MAK and its developers reserve the right to decline support for any resulting issues.
After extraction, open the extracted folder, find MAK.exe, and double-click it to run MAK.

Step 4: Configure the Emulator and Game

Before using MAK, make sure your emulator and game are configured correctly.

Emulator Resolution

MAK operates the game by recognizing images on the screen, so the emulator resolution is very important:

Open your emulator.
Go to 设置 (“Settings”) → 显示 (“Display”) or 分辨率 (“Resolution”).
Set the resolution to a 16:9 aspect ratio (only 16:9 is currently supported; other aspect ratios will not work).
The following resolutions are supported:
Resolution Notes
1280×720 (720p) ⭐ Recommended
1920×1080 (1080p) ⭐ Recommended
Other 16:9 resolutions Not recommended; issues may occur

Resolution	Notes
`1280×720` (720p)	⭐ Recommended
`1920×1080` (1080p)	⭐ Recommended
Other 16:9 resolutions	Not recommended; issues may occur

Very Important

The resolution must be changed in the emulator's system settings, not in the in-game settings. MAK will not work correctly if the emulator resolution is not 16:9.

Step 5: Use MAK for the First Time

Launch MAK:
MXU Installer
Find the MAK icon on the desktop and double-click it.
MFAA Installer
Find the MAK icon on the desktop and double-click it.
MXU Archive
Open the extracted folder and double-click MAK.exe.
MFAA Archive
Open the extracted folder and double-click MAK.exe.
Add a task: Follow the instructions in the selected UI to add or select the tasks you want MAK to perform.
Connect to the emulator: Select your emulator in the device or connection settings. MAK will attempt to connect automatically.
Start running: Click the start button in the UI, and MAK will begin working!

Having Problems?

Do not worry! Check the FAQ first; the answer you need may already be there.

If the problem remains unresolved, join the QQ discussion group at 253843401 and report it there.