冒险岛经典服自动打怪与挂机工具

角色与怪物识别

分别采集角色和目标怪物面向左、右的图像模板，客户端据此在画面中定位可见目标。

刷怪与挂机路线

支持原地攻击、两点往返，以及使用地图编辑器自主制作的多层地图路线。

自动补药与增益

可设置 HP/MP 触发阈值、药水按键、冷却时间，以及最多五组定时增益技能。

拾取与战斗控制

统一配置攻击、跳跃、拾取、转向行为和不同策略所需的动作间隔。

运行日志与启动检查

策略运行前检查游戏窗口、小地图、角色、怪物和生命状态识别，日志会显示当前结果。

本地配置与路线

配置、用户模板和地图路线文件保存在本地，可按实际地图反复测试和调整。

Mac 安装

首次打开前先把 App 移入“应用程序”。在“隐私与安全性”中同时授予“辅助功能”和“屏幕与系统音频录制”，然后彻底退出并重新打开。请选择与芯片匹配的安装包（Apple 芯片或 Intel）。

检查 macOS 权限

“辅助功能”用于发送移动、攻击和补给按键；“屏幕与系统音频录制”用于读取游戏窗口、人物、小地图和 HP/MP。两处都应添加“应用程序”中的正式 App，而不是 Terminal、Python、旧包或同名文件夹。打开开关后使用 Command-Q 完全退出并重开。

激活许可证

在设置页输入完整许可证，注意不要带前后空格；联网点击激活并等待成功状态，再返回主界面。macOS 若弹出钥匙串访问提示，应输入当前 Mac 登录密码，而不是许可证。

本地数据与备份

Windows 数据位于 %LOCALAPPDATA%\Okya\，macOS 数据位于 ~/Library/Application Support/Okya/。只备份 config.json、templates 和 maps；不要把 license.dat 复制到其他电脑，新设备应单独激活。

人物模板（固定 15 × 15 px）

新建并命名人物模板，让角色先面向左，在截图中选取头部上方较稳定的区域；再让角色面向右，选取完全相同的身体部位。确认左右预览只包含角色本身，保存后在下拉框中选中。

好模板与坏模板

好模板的左右取样位置一致，且只包含目标本体。若包含地面、平台边缘、背景、角色名、伤害数字、聊天文字、宠物、技能光效或其他怪物，应删除并重新采集。

需要重新采集的情况

时装、特效、游戏客户端或操作系统发生变化后，必须重新采集全部模板。Windows 与 macOS 的像素渲染也可能不同，不建议直接共用模板。

游戏画面与基础设置

游戏使用窗口或无边框窗口模式，并放在主显示器。小地图保持完整展开，HP/MP 使用默认界面位置。软件内必须选择真实服务器、已保存的人物和一种怪物；建议开启测谎仪告警并先执行“声音测试”。

先使用诊断模式

“仅识别”用于确认游戏窗口、人物、怪物、小地图和 HP/MP，不发送战斗按键；“仅移动”用于验证巡航或预设路线。两项检查正常后，再启用“完整执行”。

战斗与移动

攻击键、跳跃键必须与游戏快捷栏一致。横向和纵向识别范围应从保守值开始，范围过大可能误追其他平台的怪物。

自动补血与补蓝

两者可分别开启。首次测试可从 50% 阈值和约 1 秒冷却开始，冷却不能低于 0.1 秒。如果日志显示 HP 或 MP 为 0.0%，先关闭自动补给，再检查服务器、窗口位置、默认游戏 UI 和屏幕录制权限。

增益与物品拾取

最多可配置 5 个增益槽位，首次只开启 1 个；启用项必须设置按键，周期必须大于 0。拾取间隔建议从 0.45 秒开始，最低为 0.05 秒；频率过高会打断攻击并造成输入拥堵。

第一次完整运行

进入目标地图，展开小地图并确认 HP/MP 可见；保存服务器、人物、怪物、策略和按键后，从安全位置点击“启动策略”。等待软件自动把焦点切回游戏，不要主动切换应用。只有日志确认游戏窗口、人物、小地图和启动检查通过，才算真正开始运行。

每次启动前 30 秒检查

确认角色位于正确地图和安全位置；游戏位于主显示器；服务器、人物、怪物和策略正确；攻击、跳跃、药水、增益和拾取键与游戏一致；药水与技能数量足够、背包有空间；测谎仪告警已开启且声音可听见。

原地攻击

适合首次测试和固定平台。客户端记录启动时的小地图位置，角色被击退或偏移后可尝试回到原位。

两点往返巡航

在小地图的水平 A、B 坐标之间移动，可设置端点停留时间以及是否只在端点攻击。

自定义路线巡航

按照你在地图编辑器中创建的节点、平台和动作运行；导入路线需与当前地图匹配。

三步创建地图路线

1. 1
   导入实际运行的地图

   先让游戏以日常运行时使用的窗口模式和界面布局进入目标地图，再截取当前游戏画面。打开地图编辑器并点击“导入地图”。请使用你自己真实运行环境中的截图，不要使用攻略站地图、被缩放的图片或其他设备的截图，否则坐标可能无法与桌面客户端匹配。

2. 2
   框选左上角小地图区域

   选择“框选”，先点击小地图可见内容的左上角，再点击右下角，然后保存裁切。框内应完整包含角色能够行走的平台、绳索、梯子和传送点，同时排除游戏场景、聊天框、任务提示及小地图之外的界面。保存前放大核对边界，确保裁切结果与桌面客户端实际识别的小地图一致。

3. 3
   开始选点并设立路线

   选择“标点”，在转向位置、落脚点、绳梯入口和传送点放置节点；需要时用“平台”标出地形，再用“连线”连接相邻节点，并为每条路径选择左移、右移、跳跃、攀爬、下跳或传送。完成后导出路线，在桌面客户端中为同一张地图导入；先只测试移动，确认路线稳定后再开启攻击和拾取。

更新软件之前

停止策略并完全退出，备份 config.json、templates 和 maps。单独安装新版本，再核对版本、服务器、模板、按键和策略配置。

迁移到其他电脑

常规配置与路线文件可以审核后迁移，但不要迁移 license.dat。请在新设备重新激活、授予权限，并重新采集人物和怪物模板。

更换绑定设备

许可证与首次激活的设备绑定。更换电脑、重装系统或更换硬件后需要换绑，请联系客服（hi@okya.app）并提供订单号，由客服处理换绑。请不要把 license.dat 复制到新设备。

联系客服时

请提供软件版本、系统与芯片、服务器、窗口模式、策略、关键参数，以及从“启动参数”到首次失败位置的完整日志。请移除许可证、设备标识、账号名等敏感内容。

找不到游戏窗口

确认游戏已在主显示器打开，并使用窗口或无边框窗口模式。macOS 修改屏幕录制权限后，必须彻底退出并重开软件。

人物、怪物或小地图识别失败

去掉画面遮挡，核对服务器和当前模板，完整展开小地图，并在当前环境重新采集左右模板。排查时只选择一种怪物。

HP/MP 均显示 0.0%

先关闭自动补给，核对真实服务器、默认游戏 UI、窗口位置和屏幕录制权限，再重新测试。

怪物漏识别或识别错误

只选择一种怪物，在动画稳定帧重新采集左右模板，并选取只属于该怪物的独特区域。模板包含背景或来自其他操作系统时，应删除并在当前系统重采。

能够识别但不发送按键

让游戏重新获得焦点，核对游戏快捷键，并检查 macOS“辅助功能”。Windows 上请使用管理员权限运行程序。

macOS 权限已开启仍反复提示

删除旧包、测试包、Python、Terminal 或同名文件夹对应的旧条目，把“应用程序”中的当前正式 App 重新加入两项权限并打开开关，然后使用 Command-Q 完全退出再重开。

巡航越过边界

把 A、B 端点向安全平台内侧移动，并先使用“仅移动”验证。检测间隔和角色移动惯性可能导致短暂越界。