# MaaGumballs

**Repository Path**: Qilf/MaaGumballs

## Basic Information

- **Project Name**: MaaGumballs
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-11
- **Last Updated**: 2026-03-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<!-- markdownlint-disable MD033 MD041 -->
<p align="center">
  <img alt="LOGO" src="logo.ico" width="256" height="256" />
</p>

<div align="center">

# MaaGumballs

基于全新架构的 不思议迷宫 小助手。图像技术 + 模拟控制，解放双手！
由 [MaaFramework](https://github.com/MaaXYZ/MaaFramework) 强力驱动！  
<a href="https://maagb.xyz/" target="_blank" style="font-weight: bold;">🔗 本项目 文档站 仓库</a>  
<a href="https://github.com/KhazixW2/MaaGumballs" target="_blank" style="font-weight: bold;">🔗 本项目 GitHub 仓库</a>

</div>
<p align="center">
  <img alt="license" src="https://img.shields.io/github/license/KhazixW2/MaaGumballs">
  <img alt="Python" src="https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white">
  <img alt="platform" src="https://img.shields.io/badge/platform-Windows-blueviolet">
  <img alt="commit" src="https://img.shields.io/github/commit-activity/m/KhazixW2/MaaGumballs">
  <a href="https://mirrorchyan.com/zh/projects?rid=MaaGB" target="_blank"><img alt="mirrorc" src="https://img.shields.io/badge/Mirror%E9%85%B1-%239af3f6?logo=countingworkspro&logoColor=4f46e5"></a>
</p>

## 功能列表

- 启动/关闭游戏
- 每日签到
- 炼金招牌
- 派遣魔蜥
- 每日扫荡
- 天空探索
- 遗迹探索
- 荒野探索
- 马戏团任务
- 旅游、佣兵和天空商店
- 联盟任务、联盟礼包
- 好友礼物
- 养狗速刷竞技场101层
- 仿生人Mars神殿
- 时空域
- 黑永恒（9,19）
- 神锻系列：日光、水池、测序、融序

## 使用说明

- [新手上路](./docs/zh_cn/manual/新手上路.md)(**使用前必看**)
- [功能介绍](./docs/zh_cn/manual/功能介绍.md)
- [MaaPiCli使用说明](./docs/zh_cn/manual/MaaPiCli.md)
- [外部通知](./docs/zh_cn/manual/外部通知.md)
- [连接设置](./docs/zh_cn/manual/连接设置.md)
- [常见问题](./docs/zh_cn/manual/常见问题.md)
- [外部通知](./docs/zh_cn/manual/外部通知.md)
- [Mirror酱使用说明](./docs/zh_cn/manual/Mirror酱.md)

## 开发相关

- [开发前须知](./docs/zh_cn/develop/开发前须知.md)
- [项目结构](./docs/zh_cn/develop/项目结构.md)
- [interface.json编写](./docs/zh_cn/develop/interface.json编写.md)
- [Pipeline编写](./docs/zh_cn/develop/Pipeline编写.md)
- [Custom编写](./docs/zh_cn/develop/Custom编写.md)
- [项目重构](./docs/zh_cn/develop/项目重构.md)
- [外服适配](./docs/zh_cn/develop/外服适配.md)
- [文档编写](./docs/zh_cn/develop/文档编写.md)
- [🎞️ 视频教程](https://www.bilibili.com/video/BV1yr421E7MW)
- [⭐项目模板](https://github.com/MaaXYZ/MaaPracticeBoilerplate), 建议新的开发者参考项目模版的readme文档

更多文档请前往 [MaaFramework](https://github.com/MaaXYZ/MaaFramework) 主仓库查看

## 免责声明

本软件开源、免费，仅供学习交流使用。若您遇到商家使用本软件进行代练并收费，可能是分发、设备或时间等费用，产生的费用、问题及后果与本软件无关。

在使用过程中，MaaGB 可能存在任何意想不到的 Bug，因 MaaGB 自身漏洞、文本理解有歧义、异常操作导致的账号问题等开发组不承担任何责任，请在确保在阅读完用户手册、自行尝试运行效果后谨慎使用！

## 常用工具

1. 调试：[MaaDebugger](https://github.com/MaaXYZ/MaaDebugger) 进行调试json节点.
2. 截图、取色、取区域: [MFATools](https://github.com/SweetSmellFox/MFATools)

## Star History

<a href="https://www.star-history.com/#KhazixW2/MaaGumballs&Date">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=KhazixW2/MaaGumballs&type=Date&theme=dark" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=KhazixW2/MaaGumballs&type=Date" />
   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=KhazixW2/MaaGumballs&type=Date" />
 </picture>
</a>

## 鸣谢

本项目由 **[MaaFramework](https://github.com/MaaXYZ/MaaFramework)** 强力驱动！
UI 由 [MFAAvalonia](https://github.com/SweetSmellFox/MFAAvalonia)
开发支持工具 由 [MaaDebugger](https://github.com/MaaXYZ/MaaDebugger)、[MFATools](https://github.com/SweetSmellFox/MFATools)、[MaaSupport](https://github.com/neko-para/maa-support-extension)强力支持。
感谢以下开发者对本项目作出的贡献:

[![Contributors](https://contrib.rocks/image?repo=KhazixW2/MaaGumballs)](https://github.com/KhazixW2/MaaGumballs/graphs/contributors)

## Join us

- MaaGB 交流群 QQ 群：853222152

## 赞助

<!-- markdownlint-disable MD045 -->
<a href="https://afdian.com/a/shanshanzi">
  <img width="200" src="https://pic1.afdiancdn.com/static/img/welcome/button-sponsorme.png">
</a>