MaaEnd多端适配完整指南Win32、ADB、PlayCover、云ADB与macOS控制器详解【免费下载链接】MaaEndMaaEnd 终末地小助手基于视觉 AI 的「明日方舟终末地」自动化工具项目地址: https://gitcode.com/gh_mirrors/maa/MaaEndMaaEnd 是面向《明日方舟终末地》的开源视觉 AI 自动化工具MAA 终末地小助手支持Win32 电脑端、安卓 ADB、PlayCover、云ADB、macOS 与 Linux 控制器无论你用 PC、手机、平板还是 Mac 玩游戏都能让自动化任务跑起来。本文详解 6 类控制器的适用场景、配置方法与资源加载机制帮助你 5 分钟选对方案。1 分钟看懂MaaEnd 的 6 类控制器怎么选MaaEnd 通过「控制器Controller」与游戏交互负责截屏看屏幕和输入点鼠标、按键、触摸。不同系统需要不同的控制器。所有控制器的声明都集中在 assets/interface.json 中。控制器适用平台截图/输入方式特点Win32-FrontWindows前台截图 抢占鼠标稳定性最好游戏窗口需保持最前ADB安卓模拟器/实体机ADB 协议最通用的移动端方案CloudADB云终末地客户端ADB 协议云游戏测试版自动叠加云资源PlayCovermacOS (Apple Silicon)类似 ADB需在 PlayCover 中启用 MaaTools 绕过Linux 三件套LinuxGamescope / Wlroots / 屏幕捕获适配不同合成器MacOS-Front / BackgroundmacOS 原生ScreenCaptureKit 全局/后台输入测试版需系统权限选择建议新手速查️Windows PC 端→ 直接选Win32-Front省心稳定安卓模拟器 / 真机→ 选ADB☁️云终末地云游戏→ 选CloudADBMac 上玩终末地→ 推荐PlayCover原生窗口控制器为测试版Win32 电脑端前台控制器稳定性首选Windows 用户的首选是Win32-Front控制器。它在 assets/interface.json 中的配置为按窗口类名UnityWndClass和标题Endfield定位游戏窗口截图方式ScreenDC鼠标与键盘均为Seize完全抢占鼠标使用注意事项游戏窗口需保持在最前且不被遮挡被遮挡时截图会失效运行任务期间鼠标会被程序占用避免手动操作游戏需要授予屏幕录制 / 权限permission_required: true⚠️ 早期的Win32-Window-Background后台控制器因游戏更新已弃用请在连接设置中选择「电脑端-前台」。安卓 ADB 控制器模拟器与真机通用ADB 控制器是移动端自动化的标准方案支持安卓模拟器和实体安卓设备标签安卓端。模拟器如 MuMu、夜神等开启 ADB 调试后在连接设置中选择ADB填入地址即可实体设备通过 USB 连接或无线 ADB 连接连接成功后MaaEnd 会自动叠加加载 assets/resource_adb/ 下的 ADB 专用图片模板与流程覆盖基础资源相关流程文件可参考 assets/resource_adb/pipeline/。云ADB控制器云终末地专用测试版玩云终末地客户端的用户请选择CloudADB云终末地(ADB)(测试版)。它本质上仍是 ADB 连接但额外加载了一层云游戏专属资源 assets/resource_cloud_adb/覆盖云端 UI 差异例如assets/resource_cloud_adb/pipeline/SceneManager/SceneCommon.json云客户端的场景切换流程云端专属的 DailyRewards、DijiangRewards、VisitFriends 流程它带有ClientVersionCloudLocked选项用于锁定云客户端版本。该控制器仍处于测试阶段遇到识别异常可回退到本地 ADB 流程排查。macOS PlayCover 控制器Mac 用户的最佳实践macOS 上运行终末地的推荐路线是PlayCover仅支持 Apple Silicon Mac。完整图文步骤见官方文档 docs/zh_cn/users/playcover.md核心流程如下安装支持 MaaTools 的 PlayCover 分支导入脱壳 IPA图像设置机型选iPad Pro (13-inch) (7th gen) | M4 | 8GB分辨率自定义1280×720缩放1.0开启「禁用显示器息屏」绕过设置开启MaaTools可自定义端口、PlayChain、越狱检测绕过、插入内省库、强制插入 iOS 框架、防止频繁调用 usleep启动游戏后标题栏应显示为明日方舟终末地 [localhost:端口号]在 MaaEnd 连接设置中选择PlayCover地址填入方括号中的内容进入游戏内设置把帧率改为60 帧 游戏版本更新后需重新导入 IPA 并核对上述设置。当前 PlayCover 路线建议用于不涉及大世界移动的任务大世界移动类任务尚不稳定。macOS 原生窗口控制器测试版如果 Mac 上直接运行原生客户端可选两个测试版控制器定义见 assets/interface.jsonMacOS-FrontmacOS 前台窗口ScreenCaptureKit 截图 GlobalEvent 全局输入游戏窗口需在前台MacOS-BackgroundmacOS 后台窗口ScreenCaptureKit 截图 PostToPid 后台输入可边玩边干别的两者都需要授予屏幕录制与辅助功能权限且目前暂不支持依赖自动寻路或相对视角移动的任务。需要跑寻路类任务时请改用 PlayCover 方案。macOS 键位映射参考 assets/resource_macos/pipeline/MacOSKeyMap.json。Linux 控制器三选一适配你的合成器Linux 用户可按自己的桌面环境三选一控制器截图 / 输入适用场景Linux-GamescopePipeWire / Libei使用 Gamescope 运行游戏Linux-WlrootsWlr / Wlrwlroots 系嵌套合成器如 labwc游戏需在其内全屏Linux-ScreenCastPipeWire / UInput兜底方案游戏需在显示器上全屏运行需 input 权限三者共用 assets/resource_linux/ 资源含 AutoEcoFarm、Common 等 Linux 适配流程。进阶控制器资源分层是如何工作的MaaEnd 的资源加载采用分层覆盖机制先加载基础resource再把控制器专属目录叠上去同名图片以控制器层为准。各控制器对应的资源目录PlayCover → assets/resource_playcover/ assets/resource_adb/ADB / 云ADB → assets/resource_adb/云ADB 额外叠加 assets/resource_cloud_adb/Linux → assets/resource_linux/macOS → assets/resource_macos/这套分层逻辑在 agent/cpp-algo/source/MapNavigator/controller_type_utils.h 中有清晰实现控制器类型与环境变量的协议解析则见 agent/go-service/pkg/pienv/pienv.go。常见问题排查FAQQ1Win32-Front 识别不到窗口确认游戏窗口标题包含Endfield、未被遮挡且处于最前检查是否已授予屏幕录制权限。Q2ADB 连接上但任务点歪了确认模拟器分辨率与 ADB 资源模板匹配检查是否开启了ClientVersion相关的版本锁定选项。Q3PlayCover 标题栏没有[localhost:端口]回到 PlayCover 设置确认已开启 MaaTools 并重启游戏端口号需与连接设置中填写的一致。Q4macOS 原生控制器提示截图失败到「系统设置 → 隐私与安全性」中为 MaaEnd 开启屏幕录制与辅助功能权限然后重启 MaaEnd。Q5云ADB 与 ADB 有什么区别云ADB 会在 ADB 基础上自动叠加云游戏专属资源与版本锁定选项专用于云终末地客户端本地安卓设备请继续使用ADB。选对控制器是跑通 MaaEnd 的第一步。按上面对照表选择对应平台方案绝大多数任务即可开箱即用遇到识别问题可参考 docs/zh_cn/users/troubleshooting.md 继续排查。【免费下载链接】MaaEndMaaEnd 终末地小助手基于视觉 AI 的「明日方舟终末地」自动化工具项目地址: https://gitcode.com/gh_mirrors/maa/MaaEnd创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 MaaEnd多端适配完整指南：Win32、ADB、PlayCover、云ADB与macOS控制器详解
MaaEnd多端适配完整指南Win32、ADB、PlayCover、云ADB与macOS控制器详解【免费下载链接】MaaEndMaaEnd 终末地小助手基于视觉 AI 的「明日方舟终末地」自动化工具项目地址: https://gitcode.com/gh_mirrors/maa/MaaEndMaaEnd 是面向《明日方舟终末地》的开源视觉 AI 自动化工具MAA 终末地小助手支持Win32 电脑端、安卓 ADB、PlayCover、云ADB、macOS 与 Linux 控制器无论你用 PC、手机、平板还是 Mac 玩游戏都能让自动化任务跑起来。本文详解 6 类控制器的适用场景、配置方法与资源加载机制帮助你 5 分钟选对方案。1 分钟看懂MaaEnd 的 6 类控制器怎么选MaaEnd 通过「控制器Controller」与游戏交互负责截屏看屏幕和输入点鼠标、按键、触摸。不同系统需要不同的控制器。所有控制器的声明都集中在 assets/interface.json 中。控制器适用平台截图/输入方式特点Win32-FrontWindows前台截图 抢占鼠标稳定性最好游戏窗口需保持最前ADB安卓模拟器/实体机ADB 协议最通用的移动端方案CloudADB云终末地客户端ADB 协议云游戏测试版自动叠加云资源PlayCovermacOS (Apple Silicon)类似 ADB需在 PlayCover 中启用 MaaTools 绕过Linux 三件套LinuxGamescope / Wlroots / 屏幕捕获适配不同合成器MacOS-Front / BackgroundmacOS 原生ScreenCaptureKit 全局/后台输入测试版需系统权限选择建议新手速查️Windows PC 端→ 直接选Win32-Front省心稳定安卓模拟器 / 真机→ 选ADB☁️云终末地云游戏→ 选CloudADBMac 上玩终末地→ 推荐PlayCover原生窗口控制器为测试版Win32 电脑端前台控制器稳定性首选Windows 用户的首选是Win32-Front控制器。它在 assets/interface.json 中的配置为按窗口类名UnityWndClass和标题Endfield定位游戏窗口截图方式ScreenDC鼠标与键盘均为Seize完全抢占鼠标使用注意事项游戏窗口需保持在最前且不被遮挡被遮挡时截图会失效运行任务期间鼠标会被程序占用避免手动操作游戏需要授予屏幕录制 / 权限permission_required: true⚠️ 早期的Win32-Window-Background后台控制器因游戏更新已弃用请在连接设置中选择「电脑端-前台」。安卓 ADB 控制器模拟器与真机通用ADB 控制器是移动端自动化的标准方案支持安卓模拟器和实体安卓设备标签安卓端。模拟器如 MuMu、夜神等开启 ADB 调试后在连接设置中选择ADB填入地址即可实体设备通过 USB 连接或无线 ADB 连接连接成功后MaaEnd 会自动叠加加载 assets/resource_adb/ 下的 ADB 专用图片模板与流程覆盖基础资源相关流程文件可参考 assets/resource_adb/pipeline/。云ADB控制器云终末地专用测试版玩云终末地客户端的用户请选择CloudADB云终末地(ADB)(测试版)。它本质上仍是 ADB 连接但额外加载了一层云游戏专属资源 assets/resource_cloud_adb/覆盖云端 UI 差异例如assets/resource_cloud_adb/pipeline/SceneManager/SceneCommon.json云客户端的场景切换流程云端专属的 DailyRewards、DijiangRewards、VisitFriends 流程它带有ClientVersionCloudLocked选项用于锁定云客户端版本。该控制器仍处于测试阶段遇到识别异常可回退到本地 ADB 流程排查。macOS PlayCover 控制器Mac 用户的最佳实践macOS 上运行终末地的推荐路线是PlayCover仅支持 Apple Silicon Mac。完整图文步骤见官方文档 docs/zh_cn/users/playcover.md核心流程如下安装支持 MaaTools 的 PlayCover 分支导入脱壳 IPA图像设置机型选iPad Pro (13-inch) (7th gen) | M4 | 8GB分辨率自定义1280×720缩放1.0开启「禁用显示器息屏」绕过设置开启MaaTools可自定义端口、PlayChain、越狱检测绕过、插入内省库、强制插入 iOS 框架、防止频繁调用 usleep启动游戏后标题栏应显示为明日方舟终末地 [localhost:端口号]在 MaaEnd 连接设置中选择PlayCover地址填入方括号中的内容进入游戏内设置把帧率改为60 帧 游戏版本更新后需重新导入 IPA 并核对上述设置。当前 PlayCover 路线建议用于不涉及大世界移动的任务大世界移动类任务尚不稳定。macOS 原生窗口控制器测试版如果 Mac 上直接运行原生客户端可选两个测试版控制器定义见 assets/interface.jsonMacOS-FrontmacOS 前台窗口ScreenCaptureKit 截图 GlobalEvent 全局输入游戏窗口需在前台MacOS-BackgroundmacOS 后台窗口ScreenCaptureKit 截图 PostToPid 后台输入可边玩边干别的两者都需要授予屏幕录制与辅助功能权限且目前暂不支持依赖自动寻路或相对视角移动的任务。需要跑寻路类任务时请改用 PlayCover 方案。macOS 键位映射参考 assets/resource_macos/pipeline/MacOSKeyMap.json。Linux 控制器三选一适配你的合成器Linux 用户可按自己的桌面环境三选一控制器截图 / 输入适用场景Linux-GamescopePipeWire / Libei使用 Gamescope 运行游戏Linux-WlrootsWlr / Wlrwlroots 系嵌套合成器如 labwc游戏需在其内全屏Linux-ScreenCastPipeWire / UInput兜底方案游戏需在显示器上全屏运行需 input 权限三者共用 assets/resource_linux/ 资源含 AutoEcoFarm、Common 等 Linux 适配流程。进阶控制器资源分层是如何工作的MaaEnd 的资源加载采用分层覆盖机制先加载基础resource再把控制器专属目录叠上去同名图片以控制器层为准。各控制器对应的资源目录PlayCover → assets/resource_playcover/ assets/resource_adb/ADB / 云ADB → assets/resource_adb/云ADB 额外叠加 assets/resource_cloud_adb/Linux → assets/resource_linux/macOS → assets/resource_macos/这套分层逻辑在 agent/cpp-algo/source/MapNavigator/controller_type_utils.h 中有清晰实现控制器类型与环境变量的协议解析则见 agent/go-service/pkg/pienv/pienv.go。常见问题排查FAQQ1Win32-Front 识别不到窗口确认游戏窗口标题包含Endfield、未被遮挡且处于最前检查是否已授予屏幕录制权限。Q2ADB 连接上但任务点歪了确认模拟器分辨率与 ADB 资源模板匹配检查是否开启了ClientVersion相关的版本锁定选项。Q3PlayCover 标题栏没有[localhost:端口]回到 PlayCover 设置确认已开启 MaaTools 并重启游戏端口号需与连接设置中填写的一致。Q4macOS 原生控制器提示截图失败到「系统设置 → 隐私与安全性」中为 MaaEnd 开启屏幕录制与辅助功能权限然后重启 MaaEnd。Q5云ADB 与 ADB 有什么区别云ADB 会在 ADB 基础上自动叠加云游戏专属资源与版本锁定选项专用于云终末地客户端本地安卓设备请继续使用ADB。选对控制器是跑通 MaaEnd 的第一步。按上面对照表选择对应平台方案绝大多数任务即可开箱即用遇到识别问题可参考 docs/zh_cn/users/troubleshooting.md 继续排查。【免费下载链接】MaaEndMaaEnd 终末地小助手基于视觉 AI 的「明日方舟终末地」自动化工具项目地址: https://gitcode.com/gh_mirrors/maa/MaaEnd创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考