Repository navigation
Releases: Aynamuk/MapleStoryAutoLevelUp-CN
Release list
v1.1.6：自动拾取 —— 收掉宠物也能捡东西
新增：自动拾取
宠物挡住自己名字，收掉它又没人帮捡东西？现在可以放心收掉了。
怎么用
- 主界面 →「按键绑定」，把「拾取」填上你游戏里的拾取键（比如 Z）
- 下面的「🖱️ 自动拾取」设好冷却（默认 2 秒）
- 收掉宠物，点开始挂机 —— 脚本会自己捡
说明几点
- 默认是关闭的，拾取键留空就行。
- 冷却调小会让拾取挤占攻击节奏、打怪变慢。低于 1 秒时界面会弹提示，建议 1.5~3 秒。
- 两次拾取的实际间隔会在 ±30% 内随机波动，不是精确的死值。
顺带把「挂机方式」下拉框去掉了 —— 里面只剩「巡逻绕圈」一项，没得选还占地方。
升级方式
- 完整包：解压覆盖整个文件夹（不要只换 exe）
- 补丁包：解压到程序根目录覆盖
老规矩：换新包后配置会保留，不用重新录路线。
v1.1.5 — 怪物素材库升级：每只怪 1~9 个动作帧
v1.1.5 — 怪物素材库升级：每只怪 1~9 个动作帧
这次改了什么
怪物模板从「每只怪一张图」升级为「每只怪 1~9 个动作帧」。
以前每只怪只有一张静态图（站立首帧）。怪一走起来、换个姿势，轮廓就变了，
引擎容易认不出——表现就是「怪明明在眼前，角色却站着不打」。
现在每只怪按动作取帧、再自动筛掉重复的，保留真正有区分度的姿态：
| 怪物 | 帧数 | 说明 |
|---|---|---|
| 绿蘑菇 / 蝙蝠 / 巫婆 | 1 帧 | 这种怪怎么动都一个样，1 帧就够 |
| 三眼章鱼 / 蜗牛 / 火野猪 | 2 帧 | |
| 冰龙 / 木妖 / 青龙 | 4 帧 | |
| 蓝水灵 | 9 帧 | 动作最丰富 |
平均 2.9 帧/只，全库 82 只怪 / 240 张模板（原来 82 张）。
你怎么用上
升级后重新勾选一次就行：
主界面选中地图 → 点【从素材库选怪】→ 勾选这张图会出现的怪 → 确定。
已经装过的怪会自动换成新素材，不用手动删旧的。
几点说明
为什么帧数不一样？ 不是我们偷懒，是怪本身的动作复杂度不同。
一个圆蘑菇怎么走都是那个圆，留 9 帧纯属浪费（引擎每张模板都要跑匹配，
留多了会拖慢识别）；而蓝水灵身法多，就得多留几张才认得准。
只收常态动作。 出招、受击、死亡这些动画一律不收——挂机打的是秒杀怪，
它还没出招就没了，这些画面根本来不及出现，收了也是白占开销。
素材图片本身没有变化，但取图站点换了。 图片经逐像素核对（82/82 完全一致）
与原来完全一样；之所以换站点，是因为只有国际服素材 API 提供逐帧数据，
原来的国服资料库只有单帧快照——不换站就拿不到动作帧。
界面上的怪名还是中文。 没有任何变化，仍是「三眼章鱼」这种中文名。
如果识别还是不理想
先看一眼是不是真的漏检：在软件里点顶部页签**【游戏画面】**，每只识别到的怪都会画框。
- 怪贴脸了却没框 → 漏检。可以把
config/config_custom.yaml里的
monster_detect.diff_thres调大一点（调大 = 更宽松 = 漏检少、误报多） - 满屏碎框、怪身上反而没有 → 误报太多，把这个值调小
反馈时请附上 log/ 目录下最新的日志，只描述「不行/没反应」很难定位问题。
完整改动
src/utils/mob_library.py— 素材库装载支持多帧tools/fetch_mob_frames.py— 新增：按动作抓帧 + 自动筛冗余tools/pack_mob_library.py— 新增：把筛好的帧打进素材库tools/verify_mob_library.py— 自检适配多帧monster_lib/— 97 张单图 → 240 张多帧；顺带清掉 15 个失效目录
CI: 全绿（22 项自检）
v1.1.4：修「按 F2 没反应、框选窗口不弹」
修复内容
修 bug 的版本。上一版 v1.1.3 修好了一半，这版补上另一半 —— 遇到下面任一情况的用户请更新。
1. 按 F2 没反应、框选名字的窗口弹不出来
v1.1.3 发出来之后才发现的，和上一版是同一个根源。
按 F2 标定名字时，程序要先抓一张游戏画面。抓完之后它会检查「这张图是不是游戏」——
防止抓到标题里碰巧带「冒险岛」的其它窗口（以前真的抓到过资源管理器）。
但那次检查用的还是写死的标题栏高度 31，所以和上一版一样，在标题栏更小的电脑上
算出来对不上，就把你自己的游戏画面误判成「抓到了别的窗口」给拒了。
结果就是你按 F2，控制台只闪一行错误，框选窗口根本不弹——看起来像"点了没反应"。
现在这个检查也改成按你电脑的真实标题栏高度来算，不会再误伤。
如果你升级后按 F2 仍然没弹窗，把控制台里的那行错误发到 issue 里，我看一下。
2. 上一版（v1.1.3）修的「抓不到游戏画面」
如果你还没升到 v1.1.3，这版同样包含：程序会自己量本机真实标题栏高度，
不再用写死的 31，修掉「画面大小对不上」和 F4 说没截到画面。
3. 血条蓝条读数偶发不准（同源）
标题栏算偏几像素时，不会弹任何提示，但整个画面会跟着偏。
血条距离画面底边本来只有约 4 像素，所以这种情况下读出来的血量是错的。一并修好。
安装与使用
不想装 Python —— 下载附件里的 zip，整个文件夹解压后双击 冒险岛自动练级.exe。
已有旧版 —— 下载增量补丁包 patch-to-v1.1.4-universal.zip，解压覆盖到程序目录即可
（不会动你的配置、地图路线和怪物模板）。
环境要求
- Windows 10 1809 以上（64 位）
- 游戏设为窗口模式、分辨率 1366x768、系统缩放 100%
- 游戏左上角小地图要打开
- 需要安装 Interception 驱动（见用户版说明）
v1.1.3：修「抓不到游戏画面」（issue #14）
修复内容
修 bug 的版本，遇到「抓不到游戏画面」的用户请更新。
1. 「画面大小对不上」/ 按 F4 说没截到画面
有用户反馈：游戏窗口设成 1366x768、系统缩放 100%，但工具就是抓不到画面，弹出
「抓到的画面 1368x764 比配置的 1366x768 小」。
原因是标题栏高度。抓游戏窗口时拿到的是整个窗口（含最上面那条标题栏），
程序要靠一个「标题栏高度」把这条切掉，才能对准游戏画面。
这个值以前是写死的 31 像素——那是开发电脑上量出来的。但标题栏高度是
Windows 根据你的系统版本、主题、显示缩放自己算的，每台电脑都可能不一样。
那位用户量出来是 27，比 31 少 4 像素：切多了，剩下的画面高度就不够 768，
于是程序判定「画面不对」并且完全派不上用场。
现在程序会自己量本机的真实标题栏高度：和配置里的值对得上就用配置的（绝大多数
人不受影响），对不上就按量出来的值走，并在日志里留一行说明。
更新后不用做任何事。 如果想让配置也永久适配你的机器，可以跑一次
python -m tools.measure_window --write-config。
顺带修掉两个坑：
- 那段「抓到的画面比配置小」的提示以前只说「窗口是不是被改小了」，把问题指向用户；
现在会同时告诉你是哪两种可能、各自怎么查。 - 新增的自检里发现：这次加的提示日志原本会每帧打一条（一秒几十条），会把日志冲爆。
已改成只在情况变化时打一次。
2. 血条蓝条读数偶发不准（同源问题）
同上。标题栏切多了但还没多到报错时，不会弹提示，只是整个画面被算偏几像素。
血条距离画面底边本来只有约 4 像素，所以这种情况下读出来的血量会是错的。
这一版一并修好。
安装与使用
不想装 Python —— 下载附件里的 zip，整个文件夹解压后双击 冒险岛自动练级.exe。
已有旧版（v1.0 及以后） —— 下载增量补丁包 patch-to-v1.1.3-universal.zip，解压覆盖到程序目录即可
（不会动你的配置、地图路线和怪物模板）。
环境要求
- Windows 10 1809 以上（64 位）
- 游戏设为窗口模式、分辨率 1366x768、系统缩放 100%
- 游戏左上角小地图要打开
- 需要安装 Interception 驱动（见用户版说明）
v1.1.1 —— 修复两侧都有怪时反而不攻击（issue #12）
修了什么
两侧都有怪时，不再"两边都不打"（issue #12）
有用户反馈「左右同时存在怪物时，角色在原地左右抽搐，但是不攻击」。
原因是代码在两侧都有怪、且两只怪距离差不多时，不知道该打哪边，就干脆一帧都不出招；
而走路指令还在照常发 —— 所以看着像是在原地抽搐。
现在改成：两侧都有怪就打近的那只，一样近就固定打左边。
顺带把「目标在左右之间来回换」时角色反复转身、转不完身的问题也压住了。
升级方式
- 老用户：下载 patch-to-v1.1.1-universal.zip，解压覆盖到程序目录（覆盖 v1.0~v1.1.0 均可）
- 新用户：下载 MapleStoryAutoLevelUp-CN-v1.1.1.zip
还有一件事没结论
有反馈说「识别到怪但不攻击」，这个目前判断不了，需要日志。
如果您遇到的是这种，麻烦开 issue 附一段日志，能看到 [运行状态] 那行的 怪N 最有帮助。
v1.1.0 — 内置 82 种怪素材库 + 怪物识别框修复
修复内容
合并了原定分两次发的两个版本（识别框修复 + 怪物素材库）。所有 v1.0.13 及更早的用户都建议更新。
1. 内置怪物素材库 —— 不用从零开始抠图了（本版最大改动）
以前想打一种怪，必须开游戏 → 找到那只怪 → 框住它 → 存成模板。国服怀旧服的怪有
80 多种，没人可能每种都截一遍，于是「选完地图没怪可用 → 角色站着不打怪」成了
最常见的问题（见 #10）。
现在随包附带了 82 种怪的现成模板（Lv1 ~ Lv85，覆盖新手村到高阶地图）：
主界面选中地图 → 点【📦 从素材库选怪…】→ 勾上这张图会出现的怪 → 确定
模板会自动装好，并登记到这张图的打怪列表。不用开游戏、不用自己抠图，点两下就能开打。
选怪窗口按等级排序，带搜索框（输入「猪」「蘑菇」或「Lv30」都能过滤），
还有个「只选已装的」按钮，82 项也能几秒钟找齐。
这些模板取自国服官方素材，自带黑色描边，与程序的识别方式天然匹配，
实测比手工抠的图对得更准（同一只怪匹配分 0.017，手抠图 0.053，越低越好）。
但要如实说清楚：这是个应急方案，不是终点
素材库解决的是「一只模板都没有，角色站着不打怪」这个最卡人的问题 ——
装上它，绝大多数图能立刻开打，不用再卡在这一步。
但它不是精确调优过的方案，有两个已知的短板：
- 每种怪只有一张静态站立图。官方素材只放出了这一个姿势，怪物走动的样子、
攻击的样子都没有。所以动作幅度大的怪（典型如三眼章鱼，触手每帧都在变），
光靠素材库这一张图，识别会漏。 - 所以想要稳定识别，仍然建议自己再录一两个模板补进去。哪种怪老是认不出，
就对着它补截 1~2 张不同姿势的（主界面【截取怪物模板】）。
素材库那张做底子，自己补的做补充，这样组合起来最稳。
补的时候不用担心冲突 —— 素材库的图不会被覆盖，两者会一起参与识别。
后续这个模板库会继续扩充（补更多姿势、覆盖更多怪），目标是尽量少让用户自己录。
在那一版出来之前，请把素材库当成「先能用起来」的起点，而不是「不用管了」的终点。
2. 怪物识别框回来了 + 不闪了（治「框疯狂闪烁」）
有用户反馈「怪物识别框从头到尾不显示」，也有说「疯狂闪烁、时灵时不灵」。
- 框加回来了：每只识别到的怪会画一个小框（绿=按外形匹配到的，黄=按血条匹配到的）。
这是排查「程序到底看没看见这只怪」最直接的手段，默认开。
不想看的在config_default.yaml里把monster_detect.draw_mob_boxes设成false。 - 闪烁修好了：根因是画框和清空调试图的频率对不上，现在两者对齐到帧尾，
框会稳定显示。
安装与使用
不想装 Python —— 下载附件里的 zip，整个文件夹解压后双击 冒险岛自动练级.exe。
已有旧版（v1.0 及以后） —— 下载增量补丁包 patch-to-v1.1.0-universal.zip，
解压覆盖到程序目录即可（不会动你的配置、地图路线和怪物模板）。
更新后想用素材库 —— 直接选中地图点【📦 从素材库选怪…】就行，无需其他操作。
哪只怪识别不稳，再对着它自己补截 1~2 张即可。
环境要求
- Windows 10 1809 以上（64 位）
- 游戏设为窗口模式、分辨率 1366x768、系统缩放 100%
- 游戏左上角小地图要打开
- 需要安装 Interception 驱动（见用户版说明）
v1.0.13 —— 修复基础攻击键设成 Ctrl 时完全不攻击
v1.0.13
主要修复
基础攻击键设成 Ctrl 时，角色会走位正常、但一次都不打怪。
原因：界面上的按键是"按哪个键就填哪个"，存下来的是 Control，而键盘驱动只认 ctrl。于是技能键每一次都没送进游戏，而且只在日志里报一次、很容易被忽略。
同一个问题也影响 PageDown（存成 pgdown）和 Insert（存成 ins）这几个键。
其他变化
- 启动时会检查按键：如果你设置的键驱动不认识，程序会直接告诉你哪个键有问题、怎么改，不会再默默失效。
- 工具箱多了一个按钮：
保存诊断包（不含游戏画面）。以前只能连游戏画面一起打包，如果不方便把画面发出来，可以用这个，只收日志和模板。 - 日志里多了两类提示：
[名字定位·分数]—— 认不出角色名时，会告诉你"差多少"，方便判断是模板问题还是别的[路线够不着]—— 路线终点一直走不到时，会说明"这不是卡死，是路线画得够不着"
你要做什么
- 没改过按键设置：下载新版直接用，不用做别的。
- 攻击键设成了 Ctrl / PageDown / Insert：新版会自动认这些写法，不用重新设置。
- 不想下载新版：把「基础攻击」改成一个普通键（字母或数字），马上就正常了。
下载哪个
- 第一次用，或想省事：
MapleStoryAutoLevelUp-CN-v1.0.13.zip（106 MB），解压即用。 - 已经有旧版：
patch-to-v1.0.13-universal.zip（6 MB），解压后覆盖到原来的程序目录即可（适用于 v1.0 ~ v1.0.12 任意版本）。
v1.0.12 — 修复名字定位漂移（v1.0.11 回归）
修复内容
修 bug 的版本，所有升级到 v1.0.11 的用户都建议更新。
1. 名字定位漂移（v1.0.11 的回归，最重要）
有用户反馈：v1.0.10 定位只是有点不顺畅，但 v1.0.11 漂移得非常厉害。
原因：v1.0.11 把名字识别的默认模式从「灰度比对」改成了「白字掩码」。这个改动本身是错的——
改成掩码后，程序看到的模板变成一整块没有任何特征的纯白图，于是画面里任何一块白色区域
（天空、界面、画面边缘的填充条）都会被当成"名字"，角色位置就锁死在那儿不动了。更麻烦的是
这种情况不报错，日志看起来一切正常，只是位置全错。
v1.0.12 已经把默认模式改回灰度，实测 14 张真机截图 14/14 全部定位正确。
更新后不用做任何事：程序启动时会自动把配置里残留的旧模式改回来，并在日志里留一行提示。
（如果你之前手动改过 nametag.mode，或跑过标定工具，这次都会被自动纠正。）
2. 标定工具会写出错误的模式值
之前按 F3 标定名字时，标定工具会顺手把模式写成「白字掩码」——这是 v1.0.11 那个错误改动的
配套部分。现在改成写回灰度模式，重新标定不会再写坏。
更新后建议：把 nametag\ 文件夹里旧的模板图删掉，重新按 F3 标定一次（10 秒的事）。
不删也能用（旧模板配灰度模式是对的），但重标一次最干净。
3. 自动喝药发不出按键（v1.0.11 期间报的，本版一并发布）
[喝药] 发送药水键 'home' 失败：'KeyBoardController' object has no attribute 'press_key'
这是上一条反馈的 bug：喝药模块调用的按键方法名在键盘控制器里不存在，两边对不上，
所以每次喝药都发不出键。挂机打怪本身不受影响，只是血蓝低了不会帮你按药水键。
修好的代码在 v1.0.11 之后才提交，所以到这个版本才发出来。
安装与使用
不想装 Python —— 下载附件里的 zip，整个文件夹解压后双击 冒险岛自动练级.exe。
已有旧版（v1.0 及以后） —— 下载增量补丁包 patch-to-v1.0.12-universal.zip，解压覆盖到程序目录即可
（不会动你的配置、地图路线和怪物模板）。
环境要求
- Windows 10 1809 以上（64 位）
- 游戏设为窗口模式、分辨率 1366x768、系统缩放 100%
- 游戏左上角小地图要打开
- 需要安装 Interception 驱动（见用户版说明）
v1.0.11 —— 角色定位卡顿修复 + 爬梯/切段修复
v1.0.11 修复更新
修 bug 版本，建议所有用户更新。
用过旧版的，更新后只需要做一件事：删掉 nametag\ 文件夹里旧的模板图（F3 截下来的角色名字图），重新按 F3 标定一次。原因见第 1 条——旧模板配这个版本可能还是坏的。
1. 名字定位失效：角色不动、画面像幻灯片（最重要）
你会看到：按 F3 标定完名字后，角色中心点不动、画面半天不刷新，日志里反复刷 名字命中False。
原因：F3 标定工具存出来的模板是「只留名字白字」的格式，程序默认却按「整张图灰度比对」去找——格式对不上，每一帧都匹配失败，程序越跑越慢（实测慢到每秒 0.1 帧，基本等于卡死）。本版把两边统一成同一种格式，实测恢复到每秒 29 帧。
你要做的：删掉 nametag\ 里旧的模板图，重新按 F3 标定一次（旧模板是按老抠图规则生成的，重标最保险，10 秒的事）。
2. 自动喝药从来没生效过（上版遗留）
上版（v1.0.10）新加的血蓝自动喝药，实际上一次药都没按出去过：程序内部少了个函数，每次轮到喝药都报错，但错误被吞掉、挂机照常跑——日志里只有一行不起眼的 [喝药] … 失败，很容易漏看。本版补上了。
开过自动喝药的，务必更新。
3. 带梯子/平台的地图走不顺
三个相关修复（都有真机路线实测验证）：
- 爬梯爬到一半掉头往下爬 / 差一点碰到梯子就回头：程序判断「这段走完没有」的依据算反了——按整段路线的方向统计，像「先横走、爬梯上去、再横走」的 L 形路线会算反；而且只看左右位置、不看高度，人还在地面就被判「到顶了」。现在按终点附近的方向算，并且要求高度真的接近才算到达。
- 跳起来抓不住梯子：现在跳跃时如果旁边有梯子，会顺带按住「↑」，角色沿跳跃弧线过去就能扒住梯子。普通跳（跨缺口）行为不变。
- 新增配置
route.goal_reach_y_tol（默认 3）：上面说的「高度接近」的容差。一般不用动；万一某张图的角色一直到不了终点、在原地打转，把这个值调大一点，或填 0 关掉这层判定。
4. 按了开始却没反应
- 窄路线被判「不值得巡逻」：两段终点间距小于 24 像素的路线会被程序降级成「站着不动」，有用户实测 23 像素的正常路线中招，看着就像按 F1 没启动。阈值已放宽到 15。
- 地图没有可用路线（比如没录到终点就保存了）：以前程序会「装死」——主循环停了但进程不退出，看着像卡死，只能去任务管理器强杀。现在按开始时会直接弹窗，告诉你哪张图、为什么、怎么补（按 F4 重录这张图，一路走到终点再按 F3 保存）。
- F1 热键偶发不响应，一并修了。
5. 「停止界面.bat」关不掉 / 「启动界面.bat」重复启动
两层原因：bat 里 PowerShell 命令的 $ 符号被 cmd 吃掉、文件换行符存成了 LF（cmd 只认 CRLF）。现在 PowerShell 逻辑挪到独立文件 _stop_ui.ps1，两个脚本都修好；「启动界面」的防重复启动判断原来读不到管理员进程、形同虚设，也一并修了。
6. 录路线时连跳录不进去
以前两次跳跃间隔小于 0.7 秒就只记一次——而跳台阶、跳着爬管子恰恰要求连续快跳，录出来的路线就缺跳跃点，挂机走到梯子底下只会干按「↑」。冷却已从 0.7 秒降到 0.15 秒，正常连跳都能录进去。
其他
- 新增诊断小工具
tools/jump_pixel_report.py：报告一条路线里的跳跃像素分布，排查「跳不上去」类问题用。
下载与升级
第一次用 / 不想装 Python：下载 MapleStoryAutoLevelUp-CN-v1.0.11.zip，整个文件夹解压后双击 冒险岛自动练级.exe。
已有 v1.0 及以后的版本：下载增量补丁 patch-to-v1.0.11-universal.zip（约 6MB，只含 exe 和默认配置 2 个文件），解压覆盖到程序目录即可——不会动你的配置、地图路线和怪物模板。
环境要求（不变）
- Windows 10 1809 以上（64 位）
- 游戏设为窗口模式、分辨率 1366x768、系统缩放 100%
- 游戏左上角小地图要打开
- 需要安装 Interception 驱动（见用户版说明）
v1.0.10 — 修复低版本 Windows 上录制器崩溃
修复内容
修 bug 的版本，建议所有用户更新。
主要修复：低版本 Windows 上「一按 F4 录制就崩」
有用户反馈：按 F4 录制路线，程序直接退出，提示一句英文
Toggling the capture border is not supported by the Graphics Capture API on this platform.
原因是上一版为了去掉 Win11 抓屏时那圈黄色边框加的一个设置，它要求
Windows 10 build 20348（2021 年的 2104 更新）以上。系统低于这个版本时，
不是忽略这个设置，而是直接报错退出 —— 所以是「一按录制就崩」，根本走不到录制那一步。
这次改成按系统版本自动判断：系统够新才去关黄框，不够新就跳过。
老系统本来也没有那圈黄框（它是 Win11 才有的东西），所以跳过没有任何损失。
顺带：
- 那句裸英文报错现在会翻译成看得懂的中文提示；
- 加了回归用例钉住这个坑，防止以后改回去。
如果你的系统低于 Windows 10 2104，且之前遇到过这个问题，装这版即可。
安装与使用
不想装 Python —— 下载附件里的 zip，整个文件夹解压后双击 冒险岛自动练级.exe。
已有旧版 —— 下载增量补丁包，解压覆盖到程序目录即可（不会动你的配置、地图路线和怪物模板）。
环境要求
- Windows 10 1809 以上（64 位）
- 游戏设为窗口模式、分辨率 1366x768、系统缩放 100%
- 游戏左上角小地图要打开
- 需要安装 Interception 驱动（见用户版说明）