第一次启动#

打开并配置模拟器#

在解压文件后，首先不要着急打开 MNMA，请优先打开模拟器。

对于模拟器的支持情况，请参考 模拟器和设备支持。

虽然 MaaFramework 框架支持大多数模拟器，但 MNMA 仍然推荐使用 mumu12 作为游戏载体。MNMA 在测试时使用 mumu12 官方版，使用其他模拟器环境遇到的问题开发组将不会被解决。

在打开模拟器后，请在模拟器设置界面正确设置分辨率。模拟器分辨率应为 16:9 比例（mumu12 的平板预设均为此比例），最低分辨率为 1280x720，最低帧率为 30hz，不符合要求造成的运行报错将不会被解决。

启动 MNMA#

Windows 用户#

本节为 MaaNewMoonAccompany-win-x86_64-vx.x.x.zip 文件相关说明，mac 用户请跳过此部分。

在配置好模拟器后，返回解压的文件夹，可以在文件夹内找到如下两个文件：

其中：

• MaaPiCli.exe 为控制台应用
• MNMA.exe 为 GUI 应用

如果您不是特别钟情于控制台应用，请直接双击运行 GUI，控制台仅作 Debug 时的工具使用。

如果在双击应用后弹出安装.NET 运行库，按照提示一步步安装即可，中间选项全部不需要修改。

如果在双击应用后弹出报错，请参考 问题排查-程序运行类

MacOS 用户#

本节为 MaaNewMoonAccompany-macos-aarch64-vx.x.x.zip 文件相关说明，windows 用户请跳过此部分。

首先在 .NET 官网 下载 .NET 8.0

下载完成后安装压缩包内的 pkg 文件，所有选项默认即可。

在配置好模拟器后，返回解压的文件夹，打开命令行窗口，并将工作目录 cd 至 MNMA 根目录，依次执行：

pip install maafw==4.2.0
sudo chmod 777 MFAAvalonia
sudo chmod +x ./MFAAvalonia
sudo ./MFAAvalonia

若程序未打开，请双击运行 MNMA 目录下 MFAAvalonia 文件。

第二次及之后运行 MNMA 无需再执行上述命令，直接双击运行即可。

如果在双击应用后弹出报错或无法运行，请加入 交流群 请求帮助。

连接模拟器#

在 MNMA 启动后，MNMA 需要连接模拟器，以获取模拟器 ADB 支持。

打开 MNMA 后，面板右侧日志将会提示目前的状态：

加载 Agent#

第一次启动 MNMA 时，Agent 将会调用程序自带的 Python 环境与 pip 下载 MNMA 运行所需的依赖库，因此等待时间可能较久。（但要是超过 5 分钟没动静那估计就是寄了）

待启动 Agent 完毕并没有出现报错后，系统会提示任务已全部完成，此时您可以开始使用 MNMA 了。

如果没问题，恭喜你已经可以愉快的使用 MNMA 了！接下来，您可以查看手册的 功能说明 并尝试使用 MNMA 提供的功能，或自行探索。