冒险岛国际版（GMS）开源辅助项目整理

一、明确支持 GMS 的刷怪 Bot

🐝 Bumblebee Bot

GitHub：https://github.com/CohortMinseok/Bumblebee

语言：Python 3.12

最后实质性更新：2024 年 3 月左右

GMS 兼容性：README 中明确标注支持 MSEA、GMS、TMS、KMS。

核心功能：

• Auto Rune Solver：自动解符文

• Auto Enter Polo / Especia Portal：自动进入 Polo/Especia 传送门

• Auto Change Channel：自动换线

• 同时兼容 Flash Jump 类职业和 Teleport 类职业

• 支持 多 PC 运行（每台 PC 需独立 Telegram Bot）

• 声称不会触发方形测谎仪、悬浮测谎仪或 Princess Violetta

• Active GM Detector：主动 GM 检测

• 支持顺时针 / 逆时针轮转刷图

• Telegram 绑定与控制：支持 Telegram 远程控制、消息通知、Gototown 指令

• QoL 实用功能：自动喂宠物、自动复活等

已知限制：Polo/Especia 传送门在 DMT 日无法工作，因为横幅会遮挡用于区分传送门类型的顶部计时器，建议当天关闭该功能。

运行方式：以管理员权限在 cmd 中执行 python main.py，也可通过 PyInstaller 编译为 .exe。

定位：功能最完整、最贴近现代 GMS 刷怪需求的 Python Bot，适合作为直接使用或二次开发的基础。

🌱 EasyMaple

GitHub：https://github.com/wanliAlex/easymaple

语言：Python 3.10+，依赖 uv 进行依赖管理

最后实质性更新：2026 年中仍有提交（加入测谎仪检测等）

定位：轻量级刷怪 Bot，作者自述为“for-fun”项目，代码简洁，适合学习或在其基础上构建。

核心功能：

• 读取 routine 文件，让角色按预设路线自动移动刷怪

• 自动检测并解符文

• Discord 通知：符文刷新、死亡、精英 Boss 等事件

• 提供 可视化 GUI，方便创建和编辑刷怪路线

运行要求：游戏需以窗口模式运行。

GMS 兼容性：README 未像 Bumblebee 那样明确列出 GMS，但功能设计（符文、测谎仪检测、精英 Boss）与 GMS 的刷怪场景高度对应，实际使用需自行验证版本兼容性。

二、AI / 计算机视觉路线

🧠 Auto Maple（及 Auto Maple Plus）

原仓库：https://github.com/tanjeffreyz/auto-maple

增强分支：https://github.com/ckwon10/auto-maple-plus

配套资源库：https://github.com/tanjeffreyz/auto-maple-resources（包含各职业的 command books 和各图的 routines）

语言：Python

社区规模：原仓库 721 stars，325 forks。

技术路线：不直接读写游戏内存，而是通过模拟按键 + TensorFlow 机器学习 + OpenCV 模板匹配来驱动角色。

核心机制：

• Minimap 追踪：使用 OpenCV 模板匹配识别小地图边界和小地图内的元素，实时定位玩家位置

• Layout + A* 寻路：可选记录玩家历史位置，构建 quadtree 布局文件，使用 A* 搜索算法计算到目标点的最短路径，提升 routine 执行精度和速度

• Command Books：每个职业对应一个 Python 文件，定义技能对应的按键和触发时机，模块化设计使程序可以操作任意职业

• Routines：用户创建的 CSV 文件，规定“在哪个位置执行哪些命令”，由内置编译器解析执行

Auto Maple Plus：ckwon10/auto-maple-plus 是功能增强分支，更新相对活跃（2024 年底仍有提交）。

定位：适合对 AI/视觉方案感兴趣、或希望基于成熟框架进行二次开发的用户。上手门槛高于 Bumblebee，但架构更灵活。

👁️ MapleCV

GitHub：https://github.com/terryhji/MapleCV

语言：Python

最后更新：2024 年初

核心目标：绕过冒险岛的反 Bot 机制，生成高效且接近人类玩家的训练路线。

技术细节：

• 使用 DXCam 以 60fps 捕获游戏画面

• 通过 OpenCV 模板匹配实时追踪玩家位置（黄色圆圈标记）

• 引入 旅行商问题（TSP）算法生成训练路径：每个节点连接到最近的未访问节点，模拟人类玩家“优先击杀最近怪物、以旋转模式遍历地图”的行为

• 每个节点周围设置“边界容差”，让移动更流畅、减少机器人感

• 包含符文检测模块，完成自动化闭环

定位：技术文档较详细，适合想理解“纯视觉 Bot 如何实现反检测和路径规划”的开发者参考。功能完整度不如 Bumblebee 和 Auto Maple，但思路有参考价值。

三、传统客户端 Trainer / Hook（历史参考）

⚙️ MSB（MapleStory Trainer）

GitHub：https://github.com/PrinceFroggy/MSB

语言：C++（Visual Studio 解决方案）

历史地位：README 声称其在 GMS 版本 128 到 140 期间“主导了 Global MapleStory 公开 hack 场景”。

最后实质性提交：2014 年 5 月 15 日。

结构：包含 launcher 和 trainer 两部分。

定位：传统内存修改型 Trainer 的历史参考。几乎不可能直接用于当前版本的 GMS，但如果你需要了解早期 Trainer 的代码结构和内存操作方式，有一定考古价值。

🔗 maplestory-client-hook

GitHub：https://github.com/Hucaru/maplestory-client-hook

语言：C++

最后提交：2021 年 1 月

性质：技术示例，展示如何创建 DLL 来 Hook 冒险岛客户端的函数。README 明确说明仅在 v28 版本上测试过。

构建要求：Visual Studio、DirectX SDK 2006、Microsoft Detours。

注入方式：使用 CFF Explorer 等工具将 DLL 添加到 ijl15.dll 的导入表。

定位：不是开箱即用的辅助工具。适合想了解客户端 Hook 底层原理、或需要自行构建更底层修改工具的开发者作为起点。

四、额外补充：搜索中发现的其他近期项目

以下两个项目不在原始列表中，但在 2025 年仍有活动，供扩展参考。

imbot-99/MapleStoryAutoBot

GitHub：https://github.com/imbot-99/MapleStoryAutoBot

语言：未明确标注，从仓库名称和描述判断为脚本类项目。

最后更新：2025 年 5 月

主要针对：MapleStory N（非传统 GMS），功能包括自定义地图自动打怪、自动 BUFF、检测到其他玩家自动换线、自动过测谎/防挂机等。README 明确声明使用会违反 ToS 并可能导致永封。

参考价值：如果你关注的是反检测策略（玩家检测、换线、测谎绕过），它的功能设计思路有参考意义，但并非直接面向 GMS 传统服务器。

Lyze96/MANIA-Maplestory-Bot

GitHub：https://github.com/Lyze96/MANIA-Maplestory-Bot

最后更新：2025 年 8 月仍有 README 更新。

定位：自动化 botting 系统。README 信息较少，活跃度在近期项目中相对较好，可以作为进一步调研的候选。

五、选择建议

最后提醒：以上项目多为社区开发，更新频率和版本兼容性参差不齐。在实际使用或二次开发前，建议先阅读对应仓库的 README、Issues 和最近提交记录，确认其当前状态是否满足你的需求。使用任何辅助工具均存在账号风险。