MaaGC

MaaGC 是一款基于 MaaFramework 开发的诸神皇冠/百年骑士团游戏自动化助手工具，致力于为玩家提供便捷、高效的游戏自动化体验。

📋 功能特性

基础功能

• 游戏启动/关闭 - 自动化启动和关闭游戏客户端
• 任务管理 - 灵活配置和执行自动化任务

任务自动化

• 推月 - 自动化处理每月例行任务
• 推年 - 自动化处理每年例行任务
• 每日任务 - 综合处理每日礼包、市场折扣、商城礼包和悬赏令

市场与商城

• 市场折扣 - 自动识别和购买市场折扣物品
• 商城免费礼包 - 自动领取商城免费礼包
• 悬赏令 - 自动领取悬赏令奖励

角色系统

• 孩子信息识别 - 自动识别子女属性、血脉和特性
• 智能命名 - 根据子女属性和血脉自动生成合适的名字
• 相亲匹配 - 智能识别相亲对象并匹配高血统姓名
• 婚礼系统 - 根据角色爵位自动选择合适的宴会档位

🚀 快速开始

下载方式

方式一：GitHub Releases（推荐）

前往 Releases 页面 下载最新版本：

• MFAA 版本 - 基于 Avalonia UI 的图形界面版本，适合普通用户
• MXU 版本 - 基于 Tauri + React 的现代化界面版本，推荐使用
• PiCLI 版本 - 命令行版本，适合高级用户和服务器环境

方式二：Mirror 酱高速下载

使用 Mirror 酱可以快速下载和自动更新 MaaGC。

安装步骤

1. 下载文件 - 从上述渠道下载适合您的版本
2. 解压文件 - 将下载的压缩包解压到任意目录
3. 安装依赖 -
   • Windows 用户：如果运行时提示缺少依赖，请安装 Visual C++ 运行库
   • 确保已安装最新版本的 MaaFramework

首次使用

1. 连接配置

模拟器连接：

• 支持主流安卓模拟器（雷电、夜神、MuMu 等）
• 确保模拟器已开启 ADB 调试模式
• 分辨率建议设置为 1280x720 或更高
• 默认 ADB 端口为 5555，可在设置中自定义

PC 端连接：

• 支持 Windows 平台 PC 端游戏
• 需要游戏窗口处于前台运行状态
• 分辨率建议设置为 1280x720 或更高

2. 运行程序

• MFAA/MXU 版本：双击运行 maagc.exe
• PiCLI 版本：在命令行中运行 MaaPiCli.exe

3. 配置任务

1. 在界面中选择需要执行的任务
2. 根据需要调整任务参数
3. 点击开始按钮启动自动化流程

4. 查看日志

• 程序运行日志会保存在 debug/maa.log 文件中
• 可在界面中实时查看任务执行状态

📱 版本说明

MFAA 版本

• 基于 Avalonia UI 构建的跨平台图形界面
• 提供直观的任务配置和操作界面
• 适合大多数普通用户使用
• 支持 Windows、macOS、Linux 系统

MXU 版本

• 基于 Tauri + React + TypeScript 构建的现代化界面
• 更流畅的用户体验和更美观的界面设计
• 资源占用低，启动速度快
• 推荐使用此版本获得最佳体验

PiCLI 版本

• 命令行版本，无图形界面
• 适合服务器环境或高级用户
• 资源占用最低，可通过脚本自动化调用
• 支持更多高级配置选项

🛠️ 开发相关

环境要求

• Python 3.8+
• Git
• MaaFramework
• Visual Studio 2019+（Windows 平台开发）

本地开发

1. 克隆项目

   git clone https://github.com/KhazixW2/MAAGC.git
   cd MAAGC

2. 初始化子模块

   git submodule update --init --recursive

3. 下载依赖

   • 下载 MaaFramework 到 deps 目录

   • 下载 OCR 资源文件到 assets/resource/model/ocr/ 目录，需要包含：

     • det.onnx
     • rec.onnx
     • keys.txt

   • 安装 Python 依赖：

     pip install -r requirements.txt

4. 运行测试

   python agent/main.py

5. 资源检查

   python check_resource.py

项目结构

MAAGC/
├── agent/                    # 自动化逻辑核心
│   ├── action/               # 具体游戏操作实现
│   │   ├── fight/            # 战斗相关处理
│   │   └── zshg/             # 诸神皇冠游戏逻辑
│   ├── utils/                # 通用工具模块
│   └── main.py               # 主入口文件
├── assets/                   # 游戏资源与配置
│   ├── MaaCommonAssets/      # MAA 通用资源
│   ├── table/                # 配置表格文件
│   ├── resource/             # 游戏资源
│   │   └── base/             # 基础资源
│   │       ├── image/        # 图片资源
│   │       ├── model/        # 模型文件
│   │       └── pipeline/     # OCR/Pipeline 配置
│   └── interface.json        # 接口配置
├── deps/                     # 依赖文件
├── docs/                     # 项目文档
│   ├── maafw_doc/            # MAAFW 协议文档
│   └── zh_cn/                # 中文文档
├── tools/                    # 工具脚本
└── check_resource.py         # 资源检查脚本

贡献指南

我们欢迎各种形式的贡献：

• 🐛 报告 Bug
• 💡 提出新功能建议
• 📝 改进文档
• 🔧 提交代码修复或新功能

请查看 开发文档 了解更多详情。

📚 文档资源

• 新手上路 - 使用前必看，快速配置和启动
• 功能介绍 - 详细的功能说明和使用技巧
• 连接设置 - 模拟器、PC 端连接配置
• 常见问题 - 遇到问题先看这里
• [MaaPiCli 使用说明](./docs/zh_cn/MaaPiCli 使用说明.md) - 命令行版使用指南
• 个性化配置 - 高级功能配置
• 战斗系统开发文档 - 战斗系统技术文档

❓ 常见问题

1. 运行时报错"应用程序无法正常启动"？

通常是缺少 Visual C++ 运行库，请安装 vc_redist.x64.exe。

2. OCR 识别失败，报错"Failed to load det or rec"？

请确保已正确下载 OCR 资源文件到 assets/resource/model/ocr/ 目录，需要包含：

• det.onnx
• rec.onnx
• keys.txt

3. 无法连接到游戏？

• 检查模拟器是否已开启 ADB 调试
• 确认 ADB 端口配置正确（默认 5555）
• 尝试重启模拟器或重新连接
• 确保游戏窗口处于前台（PC 端）

4. 任务执行异常？

• 检查游戏分辨率是否符合要求（建议 1280x720）
• 确保游戏界面语言为中文
• 查看日志文件 debug/maa.log 获取详细错误信息

5. 孩子信息识别不准确？

• 确保游戏界面清晰，无遮挡
• 尝试调整模拟器/游戏的分辨率
• 检查 OCR 资源文件是否完整

更多问题请查看 常见问题文档 或在 Issues 中提问。

📜 用户许可协议

使用本软件即表示您同意以下条款：

• 本软件按"现状"提供，不提供任何明示或暗示的保证
• 用户承诺已阅读并同意第三方应用（游戏）的用户协议
• 用户保证仅将本软件用于合法的测试目的
• 开发者不对用户使用本软件造成的任何损失承担责任

详细条款请查看 用户许可协议。

🙏 鸣谢

核心框架

• MaaFramework - 基于图像识别的自动化黑盒测试框架

UI 支持

• MFAAvalonia - 基于 Avalonia UI 构建的通用 GUI 解决方案
• MXU - 基于 Tauri + React + TypeScript 构建的现代化 GUI 客户端

感谢所有贡献者

📞 联系我们

• GitHub Issues: 问题反馈
• 讨论区: GitHub Discussions

📄 许可证

本项目采用 MIT 许可证 开源。

---

MaaGC | 让自动化变得更简单

Made with ❤️ by MaaGC Team