给魔域添加副本脚本，分为脚本文件导入、副本任务参数配置、地图识别点位校准、分段测试以及长期维护几个环节，按照步骤操作才能让脚本正常跑完整套副本流程，不会中途卡任务或者停止运行。
前期准备工作需要先完成环境检查。确认游戏客户端窗口模式，固定分辨率，不要使用全屏，窗口尺寸改动会让所有坐标和图片识别素材失效。清理电脑后台多余程序，减少内存占用，防止画面识别延迟。准备好副本相关素材截图，包含副本入口图标、NPC对话按钮、怪物头像、副本内传送点、拾取物品图标，保存到脚本工具对应的素材文件夹。确认脚本工具权限正常，能够读取游戏窗口画面，具备模拟点击、找图、延时等待的基础能力。
脚本文件导入是第一步操作。打开脚本工具，找到脚本加载入口，选择对应的副本脚本文件完成导入。导入完成后查看脚本内置任务列表，部分脚本自带多副本模板，需要在任务配置页选中目标副本。如果是空白脚本需要手动新增副本任务，点击新建任务，填写任务名称，设置任务启动热键与停止热键。检查脚本文件路径，素材图片存放目录不能出现中文特殊符号，路径过长也会导致加载素材失败。
副本地图点位与识别素材配置。进入游戏内目标副本，开启工具自带的坐标拾取功能，依次标记副本入口NPC坐标、进入副本确认按钮坐标、副本内每一层传送门坐标、BOSS刷新区域坐标、拾取掉落物区域坐标。标记点位的时候尽量贴近图标中心，坐标偏差会出现点不到NPC或者踩错传送门的问题。打开脚本找图设置，依次绑定提前截取的图片素材，调整图片相似度参数，相似度过高容易识别不到图标，相似度太低会出现误判。多层副本需要分段设置识别区域，切换场景之后重新检索画面，判断当前所在副本层数。
副本任务逻辑参数设置。按照副本流程设置执行顺序，先是寻路到副本入口，识别NPC图标后点击对话，接着点击进入副本按钮，等待场景加载完成。进入副本之后设置怪物检索逻辑，识别怪物图标自动释放技能，击杀完成后开启掉落物品拾取，拾取完成移动到下一层传送点位。BOSS阶段单独设置判断逻辑，识别BOSS图标后切换技能释放顺序，BOSS击杀完成拾取专属掉落。设置场景加载等待延时，副本切换地图会有加载黑屏，延时时间不足会造成脚本提前执行点击动作，直接卡住流程。增加背包空间检测，背包剩余空间不足时停止拾取，可设置自动清理无用道具。
分段测试脚本，不要直接完整跑完全程副本。先单独测试进入副本模块，启动脚本，观察角色能否自动找到NPC，点击对话并成功进入副本。这一步如果卡住，重新核对NPC坐标和入口图标素材。副本第一层单独测试，查看打怪拾取、传送切换场景动作是否正常，出现原地卡顿，增加场景切换等待时间。依次测试每一层的流程，全部单段功能无异常，再进行完整副本全流程试运行。第一次完整测试全程观察，记录卡住的节点，回到脚本配置页面修改坐标、图片素材或者延时参数。
脚本运行常见故障排查。脚本点击NPC没有反应，检查游戏窗口是否被工具正常绑定，核对NPC图标素材，确认图片相似度参数。成功进副本但是卡在场景加载页面，适当增加场景切换延时，关闭游戏内多余特效，降低画面干扰。副本内不拾取掉落，检查拾取开关状态，拾取范围设置以及掉落物品素材图片。打到BOSS不会释放指定技能，重新标记技能快捷键坐标，调整BOSS图标识别参数。跑完一次副本之后无法自动重新开启，查看循环任务开关，副本结束返回主城的点位是否配置完整。
游戏客户端更新之后，副本UI图标、场景画面发生改动，原有素材和坐标失效，脚本无法正常运行。需要重新进入副本截取图片素材，重新拾取所有关键坐标点位，再次分段测试流程。保存配置完成的脚本文件，做好备份，修改参数前复制一份源文件，避免改动出错无法恢复。添加副本脚本核心在于理顺副本每一步流程，拆分任务节点，校准识别素材和坐标，反复调试延时参数，保证整套副本流程可以连贯自动执行。
前期准备工作需要先完成环境检查。确认游戏客户端窗口模式，固定分辨率，不要使用全屏，窗口尺寸改动会让所有坐标和图片识别素材失效。清理电脑后台多余程序，减少内存占用，防止画面识别延迟。准备好副本相关素材截图，包含副本入口图标、NPC对话按钮、怪物头像、副本内传送点、拾取物品图标，保存到脚本工具对应的素材文件夹。确认脚本工具权限正常，能够读取游戏窗口画面，具备模拟点击、找图、延时等待的基础能力。
脚本文件导入是第一步操作。打开脚本工具，找到脚本加载入口，选择对应的副本脚本文件完成导入。导入完成后查看脚本内置任务列表，部分脚本自带多副本模板，需要在任务配置页选中目标副本。如果是空白脚本需要手动新增副本任务，点击新建任务，填写任务名称，设置任务启动热键与停止热键。检查脚本文件路径，素材图片存放目录不能出现中文特殊符号，路径过长也会导致加载素材失败。
副本地图点位与识别素材配置。进入游戏内目标副本，开启工具自带的坐标拾取功能，依次标记副本入口NPC坐标、进入副本确认按钮坐标、副本内每一层传送门坐标、BOSS刷新区域坐标、拾取掉落物区域坐标。标记点位的时候尽量贴近图标中心，坐标偏差会出现点不到NPC或者踩错传送门的问题。打开脚本找图设置，依次绑定提前截取的图片素材，调整图片相似度参数，相似度过高容易识别不到图标，相似度太低会出现误判。多层副本需要分段设置识别区域，切换场景之后重新检索画面，判断当前所在副本层数。
副本任务逻辑参数设置。按照副本流程设置执行顺序，先是寻路到副本入口，识别NPC图标后点击对话，接着点击进入副本按钮，等待场景加载完成。进入副本之后设置怪物检索逻辑，识别怪物图标自动释放技能，击杀完成后开启掉落物品拾取，拾取完成移动到下一层传送点位。BOSS阶段单独设置判断逻辑，识别BOSS图标后切换技能释放顺序，BOSS击杀完成拾取专属掉落。设置场景加载等待延时，副本切换地图会有加载黑屏，延时时间不足会造成脚本提前执行点击动作，直接卡住流程。增加背包空间检测，背包剩余空间不足时停止拾取，可设置自动清理无用道具。
分段测试脚本，不要直接完整跑完全程副本。先单独测试进入副本模块，启动脚本，观察角色能否自动找到NPC，点击对话并成功进入副本。这一步如果卡住，重新核对NPC坐标和入口图标素材。副本第一层单独测试，查看打怪拾取、传送切换场景动作是否正常，出现原地卡顿，增加场景切换等待时间。依次测试每一层的流程，全部单段功能无异常，再进行完整副本全流程试运行。第一次完整测试全程观察，记录卡住的节点，回到脚本配置页面修改坐标、图片素材或者延时参数。
脚本运行常见故障排查。脚本点击NPC没有反应，检查游戏窗口是否被工具正常绑定，核对NPC图标素材，确认图片相似度参数。成功进副本但是卡在场景加载页面，适当增加场景切换延时，关闭游戏内多余特效，降低画面干扰。副本内不拾取掉落，检查拾取开关状态，拾取范围设置以及掉落物品素材图片。打到BOSS不会释放指定技能，重新标记技能快捷键坐标，调整BOSS图标识别参数。跑完一次副本之后无法自动重新开启，查看循环任务开关，副本结束返回主城的点位是否配置完整。
游戏客户端更新之后，副本UI图标、场景画面发生改动，原有素材和坐标失效，脚本无法正常运行。需要重新进入副本截取图片素材，重新拾取所有关键坐标点位，再次分段测试流程。保存配置完成的脚本文件，做好备份，修改参数前复制一份源文件，避免改动出错无法恢复。添加副本脚本核心在于理顺副本每一步流程，拆分任务节点，校准识别素材和坐标，反复调试延时参数，保证整套副本流程可以连贯自动执行。