MaaBD2 - 棕色尘埃2自动化助手
基于 MaaFramework 构建的《棕色尘埃2》全流程自动化助手。解放“日常15分钟”的双手，无感替您代跑每日近50分钟的全量日常、周常及活动任务。拒绝枯燥重复，奖励“我全都要”，精力只留给享受游戏。
图标、原有素材权利及项目身份说明见 项目标识声明；本声明不改变项目的开源许可证。
获取 & 安装
🛠️ 版本通道
⚠️ 切回提示（公测、内测均适用）：切换更新通道不会自动降级。从公测切回正式版，或从内测切回公测／正式版时，需留意以下区别。
桌面版：公测、内测的补丁号分别在同一正式版基线上 +1、+2，目标版本较低时不会收到更新推送。可先备份配置与存档，手动下载目标通道的完整包并解压到新目录使用。
安卓 APK：以安装编号（系统判断应用新旧的数字）为准，不只看显示版本或通道。较小编号的包不能直接覆盖安装；如需降级，须卸载后重装，卸载会清除应用数据，请先备份需要保留的配置与存档。也可以等待目标通道发布安装编号更高的新包，详见安卓更新说明。
- Windows：下载对应平台解压 → MuMu 设置 1920×1080 → 游戏切简体中文 → 启动 UI 运行。
- 安卓手机：从发布页下载
MFABD2-<版本>-android-arm64.apk，直接安装，无需解压或模拟器。需要 Android 9 及以上的 ARM64（64 位 ARM 处理器）手机，通过 Shizuku（为应用提供系统操作授权的工具）或 root（系统最高权限）授权，游戏语言设为简体中文。安装与运行说明见 安卓使用指引。
桌面版 UI 内可直接获取更新推送、下载，由提供支持。安卓 APK 当前使用 GitHub 更新源。
通道版本差距约为几次 Bug/新功能/等验证 的轮回。
配置指引
运行提示：Windows 用安卓模拟器；Apple Silicon Mac 可用 PlayCover 免模拟器运行（见下方「Mac 使用指引」）。请务必在良好的网络下运行，连通性波动导致的“重连转圈”易吞掉操作并引发失误。
反馈指南：遇到卡点欢迎提交 Issue。为了快速定位问题，请附带：出错前后几秒的录屏/截图 + 一键导出的打包日志（按钮在UI日志墙上方）。
第一步 · 模拟器
推荐使用 MuMu 模拟器 12 运行游戏。（需自行配置 Google 环境。省事直接用国际版，亦可参考笔记 Google-Play-Store）。
显示必须设置为 平板版 1920×1080 (DPI ≈ 270 或 280)。
多开，在UI(MFAA)中，顶部新建选项卡可实现多实例。项目有存档功能，多开请注意开启并填入多存档存档号。
adb.exe 以 Windows 服务形式运行，默认服务端口 5037，各模拟器实例为其客户端。MuMu 多开器按编号分配 ADB 端口：0 号默认 16384，1 号为 16416，以此类推；国际版后启动的端口号在前者基础上 +1（如 16385）。
通常启动一个 ADB 服务即可控制多个实例，不建议多版本 ADB 并行运行。如有需要，可自定义 ADB 路径与端口加以区分。
第二步 · 游戏内设置
当前已支持自动配置，但需先将游戏语言切换为简体中文且分辨率正确，之后运行中可完成自动设定。
若自动配置失败，可参照下方手动调整：（均在默认基础上修改）：
| 分类 | 设置项 | 值 |
|---|
| 操作 | 选择操作方式 | 点击地面 |
| 图像 | 分辨率 | FHD |
| 图像 | 游戏开始画面 | 主界面 |
| 通知 | 黄色圆点 | 不使用 |
画面质量异常时，请检查渲染方式。新机器通常 Vulkan 表现较好，旧机器推荐 DirectX。可关闭技能动画以提升运行速度。
第三步 · 人物技能与装备
按下图设置技能位置与装备分解选项（此设置保存在模拟器本地，不影响其他端）。配置一次即可，强化目标等级与金币消耗限额请按个人情况手动设定。
装备备注：请保留至少一件 SR/UR +9 装备用于精炼。
关于任务复位
箱庭地图状态识别、技能传送阵自动生成、绝大多数中断场景均已实现自动复位。
推荐在剧情主线地图或传送阵上结束游戏。
软件本体部署：配置流程略复杂，可参考 M9A 文档站（同框架，软件部署部分通用）。Mac 版 Agent 功能在根目录提供一键修复环境脚本，遇到环境问题时可使用。
控制方式：Apple Silicon Mac 推荐用 PlayCover 直接控制 iOS 版，无需安卓模拟器，详见 PlayCover 适配指南。
⚠️ 需使用带 MaaTools 的 hguandl fork 版 PlayCover，官方主线版没有 MaaTools、连不上。
PlayCover 支持由 @KoujiMinamoto 贡献与维护，相关问题欢迎在 issue 中 @他。
无需模拟器，直接控制 Windows 上的《棕色尘埃2》PC 客户端（Win32）。目前处于 公测（Beta 通道），功能仍在适配完善，具体可用任务以所选版本为准。遇到问题欢迎提 Issue（运行平台请选「PC 客户端」），作者会跟进修复。
获取方式：查看 公测版发布中的适配说明，或在 Mirror 酱选择公测通道。
PC 客户端适配由 @BebopSpikeSpiegel 主力推进，感谢贡献。
功能一览
帮你打理游戏里的每一天，从启动到收工，近 50 分钟日常无人值守。
🌅 每日开局 启动 & 更新游戏 · 自动前置配置
⚔️ 战斗刷取 狩猎场 · 圣石洞穴 · 肉鸽塔 · PVP · 赛季活动（普通 / 挑战 / 魔兽 / 场域）
🎰 白嫖抽卡 每日免费 · 优惠档 · 多卡池保底保留
💰 资源 & 奖励 全图吸取 · 宠物派遣 · 餐馆结算 · 任务 / 活动 / 通行证 / 邮件一键清收
📅 周常挂机 末日之书 · 自动钓鱼 · 小屋点赞
⭐ 跑商套利 · 自动识别最高价，搓料理，批量进出货，可自定义商品列表
🎣 接管钓鱼 · 检测收杆时机，全自动循环，挂机刷级
🌅启动游戏
- 启动 & 更新游戏 —— 更新游戏程序与数据版本
- 自动前置配置 —— 游戏内设置 / 技能放置 / PVP · 装备 的子菜单
- 多开存档号 —— 记录刷取进度，日常续刷、周常按需刷。
⚔️ 战斗刷取
- 狩猎场 · 冒险航线 —— 选资源 / 选图 / 米饭分配
- 圣石洞穴 —— 按属性 / 均衡 / 短板
- 肉鸽塔快速战斗
- PVP 镜中之战 —— 倍率调整
- 赛季活动 —— 普通 / 挑战关卡、魔兽（自配队补刀 或 摆烂全自动）、场域小游戏
🔧 装备
- 制作 / 强化 / 分解 / 精炼 — 全任务覆盖自动 / 精炼队列
🎰 白嫖抽卡
- 每日免费抽 —— 速抽 / 策略抽
- 每日 90 钻优惠档（指定卡池）
- 保底保留 —— 临近必出时自动停抽
💰 资源 & 奖励
- 地图资源吸取 —— 全卡带 / 每日用尽技能 / 周常存档续吸 / 卡带屏蔽
- 宠物自动派遣
- 餐馆自动结算 —— 收粉 / 升级 / 常客圣石 / 装饰币
- 一键清收 — 公会签到 / 小屋访问 / 广场祈求 / 日常任务 / 版本活动 / 通行证 / 普通邮件 & 商品邮件
📅 周常
- 末日之书一轮 · 自动钓鱼 · 小屋点赞 · 浏览街机界面
⭐ 特色
- 跑商套利 — 自动识别当日最高价，批量进出货（可自定义商品列表） / 搓利润料理
- 接管钓鱼 — 检测收杆时机，全自动循环
📥 半自动
- 爬塔刷层数 / 末日之书刷分数
- 生活技能刷级（完善中）
参与开发
长期是一人填战壕,很欢迎友军。无论你想改 Pipeline、写 Agent、补资源，还是只是反馈个带日志的 Bug——
👉 完整参与指南见 CONTRIBUTING.md：要什么 / 不要什么、提交后会经历什么、怎么搭环境、怎么进开发群，都在里面。
致谢
