5星副本脚本的核心结构与野外挂机脚本有本质区别。野外脚本是无限循环打怪，副本脚本则是一条有明确终点的流水线：进本、清怪、拾取、点传送、打BOSS、出本、重新进本。每一环都有固定的触发条件和失败处理逻辑，任何一步卡住，整个流程就停在那里。下面从副本脚本的特殊性开始，逐步拆解编写和使用的完整流程。
## 一、副本脚本的两段式结构
完整的5星副本脚本必须拆成两段独立逻辑来写，不要试图用一个脚本从头管到尾。
第一段是进本脚本。角色站在副本NPC旁边，脚本只做一件事：把鼠标移到“进入副本”按钮的固定坐标上，循环左键单击，每次点击之间插入随机延时。逻辑极简，不需要找图找色，只需要一个抓准的坐标和一个While循环。看到角色开始读条进副本，立刻停止这段脚本。
第二段是本内脚本。进入副本后，脚本需要根据画面状态做判断：有没有怪物、血量是否危险、掉落物是否出现、传送门是否可用。这些判断依赖找色和找图命令，固定坐标点击在这里基本没用，因为怪物和掉落物的位置每轮都在变。
两段脚本通过按键精灵的脚本分组功能串联，或者手动控制切换时机。新手建议先用两个热键分别控制，跑熟了再考虑自动衔接。
## 二、环境准备与素材采集
编写之前必须把运行环境锁死。模拟器分辨率固定1280×720，端游用窗口模式，桌面缩放100%，画质特效全部拉到最低，关闭飘字和动态光效。窗口位置不要拖动，拖动一次所有坐标全部作废。
打开按键精灵，用抓点工具依次采集以下关键坐标：副本NPC位置、进入副本按钮、副本内每一层的传送门、拾取范围中心点、BOSS区域的站位点。每采一个点记录到文本里，方便后续写代码时对照。
图像素材需要截取的有：副本入口图标、NPC对话按钮、背包空格子、BOSS头像或血条特征。截图时只框选目标元素本身，不要带入周围背景，保存为无损格式放到脚本目录的img文件夹。找图的相似度初始设为0.85，识别不到就降到0.8，误识别就升到0.9。
## 三、进本脚本的写法
进本脚本的核心就三行指令加一个循环：
```
While 1
MoveTo 842, 536
LeftClick 1
Delay 3000 + Int(Rnd * 3000)
Wend
```
MoveTo后面的坐标换成你自己抓到的“进入副本”按钮位置。Delay的随机范围设在3000到6000毫秒之间，低于2000毫秒被系统判定为异常操作的概率明显上升。
副本人数满或冷却中时，系统不会放行，脚本继续循环点击即可。如果NPC对话框被意外关闭导致点击落空，可以在循环里加一个保险动作：每隔几轮按一次ESC再按空格，重新打开对话框。进本脚本启动前，先手动右键NPC把对话框点出来，不要关掉，再切出游戏按启动热键。
## 四、本内脚本的主循环框架
本内脚本的主循环按照优先级从高到低排列判断分支，紧急处理放在最前面。
第一优先级是血量检测。取血条末端固定坐标的颜色值，满血通常是绿色或黄色，低于安全线后变成红色。发现红色立刻按键喝药，延时500毫秒后重新检测，连续三次仍是红色就触发回城或退出副本的逻辑。
第二优先级是怪物检测。用FindColor在全屏或半屏范围内找怪物血条的红色值。找到就释放技能，找不到就小范围移动寻怪。技能释放不要连续按，战士类间隔1.2到1.5秒，法师类间隔1.8到2秒。怪物密集时可以插入XP大招的释放指令，XP能量满值时自动触发，批量清怪效率最高。
第三优先级是拾取。怪物死后先等800毫秒让掉落物落地加载，然后用找色或找图定位地面掉落物的特征颜色，找到坐标后把鼠标移过去再点击拾取键。找不到掉落物就做小范围随机移动重新搜索，不要跑离当前区域。
第四优先级是推进流程。当前区域没有怪物、没有掉落物、且已经停留超过预设时间后，执行移动到传送门的动作。传送门的坐标是固定的，直接MoveTo过去点击即可。点击后必须给足场景加载延时，5星副本的切换场景时间通常在3到5秒，延时设短了角色还没加载出来就执行下一步，直接卡死。
## 五、BOSS阶段的单独处理
进入BOSS区域后，脚本逻辑要从群攻切换到单体输出。先找BOSS血条的特征颜色确认BOSS已经出现，确认后开始循环释放单体技能。BOSS战的延时参数要比小怪阶段拉长，因为BOSS的动画时间和技能前摇更长，按键太快反而会打断自己的技能释放。
BOSS击杀后等待掉落，拾取专属奖励。部分5星副本的BOSS掉落有光柱或特殊特效，可以单独截取这个特征做找图判断，比找地面物品颜色更准确。拾取完成后执行出本动作，点击副本出口NPC或等待自动传出。
出本后脚本回到进本状态，重新开始下一轮循环。如果副本有进入冷却，脚本在冷却期间持续点击进入按钮即可，系统会提示冷却中，不用做特殊处理。
## 六、脚本的导入与运行方法
按键精灵的脚本导入有两种方式。下载到的.q或.qmb文件直接复制到按键精灵安装目录的script文件夹下，重启软件后在脚本列表里勾选启用。纯文本代码则通过新建脚本、切换到源文件视图、粘贴代码、设置启动热键的方式加载。
运行模式选择“循环到按中止键为止”，脚本属性设置为对“魔域”窗口有效或对所有窗口有效。前台运行模式下游戏窗口不能被遮挡，后台运行模式需要绑定窗口句柄，但部分魔域客户端会拦截后台消息导致点击失效，建议先用前台模式调试。
启动顺序：先手动把角色移到副本NPC旁边，右键打开对话框不关，切出游戏按进本脚本的启动热键。看到角色开始读条进副本后，按停止键关闭进本脚本，再按本内脚本的启动热键。这个手动切换过程熟练后可以改成自动衔接，新手不要一上来就搞全自动。
## 七、调试要点与常见问题
脚本调试必须分段进行，不要第一次就开全循环。先只跑进本脚本，确认能稳定点击进入按钮且不会误触其他界面元素。然后进本手动跑一遍，只用本内脚本的打怪部分，观察找色是否准确、技能释放是否正常。打怪没问题了再加拾取，最后加传送和BOSS逻辑。
脚本点不到NPC或传送门，九成是窗口位置或尺寸变了。重新固定窗口大小和位置，重新抓点。识别不到怪物血条，检查画面特效是否关闭，或者用抓色工具重新取当前画面的血条颜色值。卡在场景加载不动，把对应位置的延时参数增加2000毫秒再试。
游戏客户端更新后脚本大面积失效是正常现象。UI图标位置、NPC坐标、场景加载时间都可能变动，需要重新截图和抓点，按照之前的流程再走一遍。
脚本运行期间电脑电源管理设为永不休眠，后台无关软件尽量关闭。长时间挂机时脚本文件做好备份，修改参数前复制一份源文件，改坏了可以随时恢复。
## 一、副本脚本的两段式结构
完整的5星副本脚本必须拆成两段独立逻辑来写，不要试图用一个脚本从头管到尾。
第一段是进本脚本。角色站在副本NPC旁边，脚本只做一件事：把鼠标移到“进入副本”按钮的固定坐标上，循环左键单击，每次点击之间插入随机延时。逻辑极简，不需要找图找色，只需要一个抓准的坐标和一个While循环。看到角色开始读条进副本，立刻停止这段脚本。
第二段是本内脚本。进入副本后，脚本需要根据画面状态做判断：有没有怪物、血量是否危险、掉落物是否出现、传送门是否可用。这些判断依赖找色和找图命令，固定坐标点击在这里基本没用，因为怪物和掉落物的位置每轮都在变。
两段脚本通过按键精灵的脚本分组功能串联，或者手动控制切换时机。新手建议先用两个热键分别控制，跑熟了再考虑自动衔接。
## 二、环境准备与素材采集
编写之前必须把运行环境锁死。模拟器分辨率固定1280×720，端游用窗口模式，桌面缩放100%，画质特效全部拉到最低，关闭飘字和动态光效。窗口位置不要拖动，拖动一次所有坐标全部作废。
打开按键精灵，用抓点工具依次采集以下关键坐标：副本NPC位置、进入副本按钮、副本内每一层的传送门、拾取范围中心点、BOSS区域的站位点。每采一个点记录到文本里，方便后续写代码时对照。
图像素材需要截取的有：副本入口图标、NPC对话按钮、背包空格子、BOSS头像或血条特征。截图时只框选目标元素本身，不要带入周围背景，保存为无损格式放到脚本目录的img文件夹。找图的相似度初始设为0.85，识别不到就降到0.8，误识别就升到0.9。
## 三、进本脚本的写法
进本脚本的核心就三行指令加一个循环：
```
While 1
MoveTo 842, 536
LeftClick 1
Delay 3000 + Int(Rnd * 3000)
Wend
```
MoveTo后面的坐标换成你自己抓到的“进入副本”按钮位置。Delay的随机范围设在3000到6000毫秒之间，低于2000毫秒被系统判定为异常操作的概率明显上升。
副本人数满或冷却中时，系统不会放行，脚本继续循环点击即可。如果NPC对话框被意外关闭导致点击落空，可以在循环里加一个保险动作：每隔几轮按一次ESC再按空格，重新打开对话框。进本脚本启动前，先手动右键NPC把对话框点出来，不要关掉，再切出游戏按启动热键。
## 四、本内脚本的主循环框架
本内脚本的主循环按照优先级从高到低排列判断分支，紧急处理放在最前面。
第一优先级是血量检测。取血条末端固定坐标的颜色值，满血通常是绿色或黄色，低于安全线后变成红色。发现红色立刻按键喝药，延时500毫秒后重新检测，连续三次仍是红色就触发回城或退出副本的逻辑。
第二优先级是怪物检测。用FindColor在全屏或半屏范围内找怪物血条的红色值。找到就释放技能，找不到就小范围移动寻怪。技能释放不要连续按，战士类间隔1.2到1.5秒，法师类间隔1.8到2秒。怪物密集时可以插入XP大招的释放指令，XP能量满值时自动触发，批量清怪效率最高。
第三优先级是拾取。怪物死后先等800毫秒让掉落物落地加载，然后用找色或找图定位地面掉落物的特征颜色，找到坐标后把鼠标移过去再点击拾取键。找不到掉落物就做小范围随机移动重新搜索，不要跑离当前区域。
第四优先级是推进流程。当前区域没有怪物、没有掉落物、且已经停留超过预设时间后，执行移动到传送门的动作。传送门的坐标是固定的，直接MoveTo过去点击即可。点击后必须给足场景加载延时，5星副本的切换场景时间通常在3到5秒，延时设短了角色还没加载出来就执行下一步，直接卡死。
## 五、BOSS阶段的单独处理
进入BOSS区域后，脚本逻辑要从群攻切换到单体输出。先找BOSS血条的特征颜色确认BOSS已经出现，确认后开始循环释放单体技能。BOSS战的延时参数要比小怪阶段拉长，因为BOSS的动画时间和技能前摇更长，按键太快反而会打断自己的技能释放。
BOSS击杀后等待掉落，拾取专属奖励。部分5星副本的BOSS掉落有光柱或特殊特效，可以单独截取这个特征做找图判断，比找地面物品颜色更准确。拾取完成后执行出本动作，点击副本出口NPC或等待自动传出。
出本后脚本回到进本状态，重新开始下一轮循环。如果副本有进入冷却，脚本在冷却期间持续点击进入按钮即可，系统会提示冷却中，不用做特殊处理。
## 六、脚本的导入与运行方法
按键精灵的脚本导入有两种方式。下载到的.q或.qmb文件直接复制到按键精灵安装目录的script文件夹下，重启软件后在脚本列表里勾选启用。纯文本代码则通过新建脚本、切换到源文件视图、粘贴代码、设置启动热键的方式加载。
运行模式选择“循环到按中止键为止”，脚本属性设置为对“魔域”窗口有效或对所有窗口有效。前台运行模式下游戏窗口不能被遮挡，后台运行模式需要绑定窗口句柄，但部分魔域客户端会拦截后台消息导致点击失效，建议先用前台模式调试。
启动顺序：先手动把角色移到副本NPC旁边，右键打开对话框不关，切出游戏按进本脚本的启动热键。看到角色开始读条进副本后，按停止键关闭进本脚本，再按本内脚本的启动热键。这个手动切换过程熟练后可以改成自动衔接，新手不要一上来就搞全自动。
## 七、调试要点与常见问题
脚本调试必须分段进行，不要第一次就开全循环。先只跑进本脚本，确认能稳定点击进入按钮且不会误触其他界面元素。然后进本手动跑一遍，只用本内脚本的打怪部分，观察找色是否准确、技能释放是否正常。打怪没问题了再加拾取，最后加传送和BOSS逻辑。
脚本点不到NPC或传送门，九成是窗口位置或尺寸变了。重新固定窗口大小和位置，重新抓点。识别不到怪物血条，检查画面特效是否关闭，或者用抓色工具重新取当前画面的血条颜色值。卡在场景加载不动，把对应位置的延时参数增加2000毫秒再试。
游戏客户端更新后脚本大面积失效是正常现象。UI图标位置、NPC坐标、场景加载时间都可能变动，需要重新截图和抓点，按照之前的流程再走一遍。
脚本运行期间电脑电源管理设为永不休眠，后台无关软件尽量关闭。长时间挂机时脚本文件做好备份，修改参数前复制一份源文件，改坏了可以随时恢复。