Skip to content
MaaYuan
Main Navigation

更新渠道 ✨公测版✨

v2.2.1-beta.1

👩🏻‍💻 请递交简历

  • 自动导航+自动筛选简历+面试全通过。直通后5关的成功结局,搬砖办成功结局需要楼主亲自面试。

🥂 华堂夜宴

  • 支持自动推故事关卡、扫荡故事,自动领取奖励、每日免费体力以及逐猎扫荡(需先领取射决开启逐猎)。
  • P.S. 之前在大鸟活动时发布过。主理人进度有限,还未测试逐猎相关内容是否完全适用于小鸟。

🏯 据点情报支持快速扫荡

快速开始
关于MaaYuan
功能介绍
任务介绍
常见问题
MaaYuan零基础开发指南
开发工具介绍
MaaYuan开发规范
节点信息输出
interface字段配置
日常行动通用模块
其它通用模块
Maa
biubiu
Mirror酱
MaaLYSK
代号鸢BWiki

切换主题

快速开始关于MaaYuan功能介绍任务介绍常见问题开发手册
Sidebar Navigation

💫 常见问题

问题排查

下载安装

连接错误

任务运行

目录

问题排查必读 ​

打不开 ​

  • 若MaaYuan在电脑某次更新/蓝屏/死机后无法运行,或者单纯是从报错窗口来到这的,那八成是由于运行库未更新导致的问题。请先阅读下载与安装。
  • 如果MaaYuan无法正常启动、ADB 被占用,或提示应用受系统限制,mac系统可尝试解除隔离,强制关闭所有MaaYuan和ADB进程:
  1. 按Cmd+Option+Esc强制退出MaaYuan,
  2. 打开终端(Terminal)依次执行:
pkill -f hd-adb
pkill -f adb
  1. 如果仍无法启动,可能是macOS的Gatekeeper隔离属性导致。执行以下命令解隔离,将<MAA应用路径>替换为MaaYuan的实际路径:
xattr -dr com.apple.quarantine <MAA应用路径>

懒得查 ​

  • 可以先尝试让deepseek(或其他AI软件)来解决
  • 文件位置:/debug/maa.log
  • 提问格式:根据以上日志信息,帮我分析可能是什么方面的问题,并告诉我如何解决
  • 文件如果太大,AI会拒绝分析,可以尝试删除log文件,复现问题,再上传到AI询问。

不干活 ​

  • 更新软件:确保MaaYuan为最新版本。
  • 关闭模拟器后台保活:
    • 例如 MuMu 模拟器:右上角菜单 → 设置中心 → 其他 → 取消勾选“后台挂机时保活运行”。
  • 检查分辨率:首次启动-模拟器适配。
  • 重装软件:重新安装MaaYuan和模拟器。
  • 更换触控方式:尝试在MaaYuan设置-连接设置-触控方式中切换成其他触控方式。
  • 游戏简繁体:常见问题

管理员权限说明 ​

通常无需管理员权限即可运行,但以下情况除外:

  • 目标模拟器以管理员运行:自动检测连接或关闭模拟器时需管理员权限。
  • 安装路径无写入权限:如解压到C:\或C:\Program Files\等受保护目录。

⚠️ 注意:若关闭UAC后出现意外提权(未手动选择管理员仍以高权限启动),建议开启UAC以增强安全性。

在 GitHub 上编辑此页

Last updated:

Pager
下一篇下载安装

MaaYuan Docs 为免费开源项目,欢迎前往 GitHub 关注文档更新。
苏ICP备2026055688号-1

MaaYuan Docs · Built with VitePress