问题排查

问题自检

如果您在使用 MNMA 时遇到了问题,请先按如下步骤进行自检:

  1. 确保模拟器使用 mumu12,模拟器设置开启本地 ADB分辨率比例为 16:9
  2. 确保电脑没有启用火绒或电脑管家等防火墙,或已将 MNMA 添加至所有杀毒软件的信任文件中
  3. 确保没有其他游戏脚本类软件在操作运行新月的模拟器
  4. 确保 MNMA 为最新版本,或尝试重装最新版 MNMA
  5. 尝试右键并使用管理员权限打开 MNMA
  6. 关闭 MNMA、模拟器后,在任务管理器中强制结束 adb.exe 运行,然后重新尝试。
  7. 重启电脑可以解决 99%的问题!

若以上操作后问题仍未解决,请继续阅读。

反馈问题

如果本节后续收录内容没有解决您的问题,您可以在 Github 提交 issue,或在 QQ 群 内礼貌请教群友,但请确保已经查看过手册对应部分的说明

TIP

本节会持续收录各位组长遇到的问题,所以您的反馈将会有助于其他组长解决问题

在回答其他群友问题时,您可以直接引用本页面连接,方便群友查看。

若是群友没法解决您的问题,您需要做以下准备:

  1. 在可能的情况下,复现问题情况,并截图或录制视频
  2. 运行 MNMA 根目录下 反馈打包小工具.exe
  3. 将打包好的 反馈日志.zip 同视频与截图发送至群内,并描述问题情况
  4. 若群友无法帮忙解决,在群内@群主或私聊群主

远程协助

若您需要远程协助,请按如下方式进行准备:

  1. 下载并安装 ToDesk 远程控制软件普通版(若您已有其他远程软件可提前说明,若您在国外请直接邀请 QQ 远程)
  2. 关闭您电脑不希望被看到的程序或文件
  3. 打开 MNMA 文件夹根目录与模拟器,若在游戏内可以先完成当前事情
  4. 准备好被远控后,将 ToDesk 设备码与临时密码复制粘贴文字私聊发送,等待连接

图片加载中,请稍等...

下载安装类

Github 页面打不开/下载缓慢

国内对于 Github 的防火墙时有时无,且速度非常不稳定。如果条件允许,请使用网络代理或加速器访问。

如果您无法通过其他途径进入 Github 页面,或下载速度被限制,可以在 QQ 群 群文件内获取您需要的资源,包括 MNMA 压缩包、更新包等。

或者,您可以使用 Mirror 酱 作为国内镜像源下载。(需要自备 CDK)

更新失败/速度缓慢

若您的下载源为 Github,国内对于 Github 的防火墙时有时无,且速度非常不稳定。如果条件允许,请在网络代理或加速器环境下更新。

或者,您可以在设置页面切换 Mirror 酱 作为国内镜像源更新。(需要自备 CDK)

如果您不希望通过其他途径更新,您可以在QQ 群 群文件内下载最新版本的 MNMA 压缩包并重新安装,此时您需要按全量更新方法更新,而不是直接覆盖

获取最新版本信息失败

若描述为 CDK 无效,请在设置内将下载源调整为 Github,或关闭自动检查/更新。

也可以输入 Mirror 酱 CDK,详情请参考 Mirror 酱支持

程序运行类

SSL Error

大多数情况下并不影响正常使用,关闭弹窗即可。若不希望再次弹出可以关闭代理/梯子

TIP

此问题并非由于 MNMA 或 MFAA 导致,出现了此提示代表您可能使用了未配置安全凭证的梯子,或代理通道识别异常。

模拟器连接失败

请先确保您的模拟器正常启动,得先开着模拟器才能连接到模拟器。

如果模拟器已经启动,请检查模拟器是否已经开启本地 ADB:

图片加载中,请稍等...

如果您的模拟器没有此选项,请在 mumu12 官网重新下载最新版模拟器。

资源加载失败

若报错中含有“资源加载失败”并伴随“模拟器连接失败”,则可能由于文件占用或部分软件版本的更新器 bug 导致,请直接重新下载安装包解压在新路径后使用

或者,您可能进行过覆盖更新,这是错误的行为,手动更新请参考 全量更新

缺少 xxx.dll/运行库

对于 Windows/MacOS 用户,需要在运行前安装运行库。

MNMA 需要 VCRedist x64 (CliGui 都需要) 和 .NET 8 (使用 GUI 时需要)。

点击 vc_redist.x64 下载安装 VCRedist x64,点击 dotnet-sdk-8.0.5-win-x64.exe 下载安装 .NET 8

若您已经存在运行库,请尝试选择修改/重装。

也可以右键开始按钮打开终端,在终端内粘贴以下命令回车以进行安装:

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

在安装时,依次点下一步即可,建议不要随意更改环境运行库的安装路径。

程序瞬间闪退或无法运行

先尝试重新安装上述依赖,并确保自身系统满足运行要求

检查您的 MNMA 是否存在如下情况:

  • MNMA 所有文件应该在一个独立的文件夹中,而不是解压在磁盘根目录或与其他软件/多个文件夹共用一个目录
  • MNMA 目录路径不应该包含中文,如创建文件夹时的“新建文件夹”

若仍无法使用,请进群请求全程协助。

Agent 加载失败

基本是 Python 环境的问题。

Python 包的默认下载源是国内,如果您配置了代理或加速器,可能是由于被拦截导致的,请关闭 MNMA 后关闭代理或加速器,再重新启动 MNMA 尝试。

如果仍然无法解决,请进群询问。

目标计算机积极拒绝

若非上述几种,可以尝试在重启后使用管理员权限打开 MNMA

若仍然弹出,情况很多,在群里问吧(