MaaGB 在 Windows 下仅支持 10 和 11，旧版 Windows 请参阅常见问题中的系统问题部分。
[!WARNING]
以下内容源自 MAA，与 MaaGB 有差异，故仅供参考 暂不支持 PlayCover。
若您正在使用 Apple Silicon MacBook，请前往此页面 MaaGB 同样支持搭载 Intel 芯片的 MacBook，但更推荐使用 Mac 自带的多系统安装 Windows，并使用 Windows 版 MaaGB。
若您希望使用 Android 实体设备，请前往此页面。 由于此方法涉及 adb 调试且仍需与电脑连接，不推荐入门玩家使用此方法。
对于 Windows 用户：
通过 winget 安装 (推荐):
您也可以右键 Windows 开始按钮，选择“命令提示符”或“PowerShell (管理员)”，然后在终端内粘贴以下命令并回车，以方便地同时安装 VCRedist x64 和 .NET 8 Desktop Runtime：
winget install Microsoft.VCRedist.2017.x64 Microsoft.DotNet.DesktopRuntime.8
Python 版本依赖:
requirements.txt)。您无需手动创建虚拟环境或安装这些依赖。Python 环境: MaaGB 的 macOS 版本已内置嵌入式 Python 环境，您无需单独安装或配置 Python。程序将自动使用此内嵌环境，并管理其依赖。
如果您计划在 Linux 或 macOS 上使用图形用户界面 (MFAAvalonia)，则还需要安装 .NET 8 运行时。
MaaGumballs 下载（更新）地址：https://github.com/KhazixW2/MaaGumballs/releases
国内用户也可通过 Mirror酱 高速下载。
MaaGumballs-win-x86_64-vXXX.zipMaaGumballs-win-aarch64-vXXX.zip[!WARNING] 请注意！Windows 的电脑几乎全都是 x86_64 的，可能占 99.999%，除非你非常确定自己是 arm，否则别下这个！
MaaPiCli.exe（命令行）或 MFAAvalonia.exe（图形化界面）即可查看处理器类型（重要：一定要选择正确版本才能正确运行）：
MaaGumballs-macos-x86_64-vXXX.tar.gzMaaGumballs-macos-aarch64-vXXX.tar.gz使用方式：
打开终端，解压分发的压缩包：
选项1：解压到系统目录（需要管理员权限）
sudo mkdir -p /usr/local/bin/MaaGumballs
sudo tar -xzf <下载的MaaGumballs压缩包路径> -C /usr/local/bin/MaaGumballs
选项2：解压到用户目录（推荐，无需sudo）
mkdir -p ~/MaaGumballs
tar -xzf <下载的MaaGumballs压缩包路径> -C ~/MaaGumballs
进入解压目录并运行程序：
cd /usr/local/bin/MaaGumballs
./MaaPiCli
[!NOTE]
若想使用图形操作页面请按第二步操作，由执行
MaaPiCli改为执行MFAAvalonia程序。
⚠️Gatekeeper 安全提示处理：
在 macOS 10.15 (Catalina) 及更高版本中，Gatekeeper 可能会阻止运行未签名的应用程序。
如果遇到”无法打开，因为无法验证开发者”等错误，请选择以下任一方案:
# 方案1：以 MaaPiCli 为例，移除隔离属性（推荐，以实际路径为准）
sudo xattr -rd com.apple.quarantine /usr/local/bin/MaaGumballs/MaaPiCli
# 或用户目录版本：xattr -rd com.apple.quarantine ~/MaaGumballs/MaaPiCli
# 方案2：添加到 Gatekeeper 白名单
sudo spctl --add /usr/local/bin/MaaGumballs/MaaPiCli
# 或用户目录版本：spctl --add ~/MaaGumballs/MaaPiCli
# 方案3：一次性处理整个目录
sudo xattr -rd com.apple.quarantine /usr/local/bin/MaaGumballs/*
# 或用户目录版本：xattr -rd com.apple.quarantine ~/MaaGumballs/*
同macOS，下载对应版本的压缩包，运行 MaaPiCli 或 MFAAvalonia 即可。
对于一般用户我们并不推荐该版本，故已在发行版删除
如您非常了解手机操作，可参考使用方法，以及开发文档自行安装。
确认解压完整，并确保将 MaaGumballs 解压到一个独立的文件夹中。除关闭内建管理员批准的Administrator账号外，请勿将 MAA 解压到如 C:\、C:\Program Files\ 等需要 UAC 权限的路径。
[!CAUTION] 不要在压缩软件直接打开程序！
查阅模拟器和设备支持，确认正在使用的模拟器支持情况。
模拟器分辨率应为 16:9 比例，推荐分辨率为 1080*1920 dpi480， 最低分辨率为720*1280 dpi320不符合要求造成的运行报错将不会被解决。
[!WARNING]
注意修改分辨率后模拟器主页应该是竖屏的（手机版），不要选成横屏（平板版）了！ 注意修改机型为samsung galaxy 24(推荐)
以下为 config/pip_config.json 的内容。
{
"enable_pip_install": true, // 是否启用 pip 安装，默认 true，推荐开启
"last_version": "v3.2.0", // 完成 pip 安装时读取 interface.json 的 version ，启动时和 version 对比，不同则尝试安装
"mirror": "https://mirrors.ustc.edu.cn/pypi/simple", // 镜像源。pip install -i 后参数，可根据个人需求填写。注意非大陆地区用户请修改值为 ""
"backup_mirrors": [
"https://pypi.tuna.tsinghua.edu.cn/simple",
"https://mirrors.cloud.tencent.com/pypi/simple/",
"https://pypi.org/simple"
] // 备用镜像源
}