01 · 產品介紹
本機桌面自動化
楓之谷 Classic World 自動練功工具
okya for MapleStory 透過螢幕圖像辨識與本機按鍵控制，減少重複打怪、掛機與練功操作。你可以建立自己的角色與怪物範本，再依照地圖選擇合適的運行策略。
- 支援平台
- Windows 10/11 · Apple 晶片 Mac
- 遊戲畫面
- 1366 × 768
- 處理方式
- 本機圖像辨識
為重複練功場景設計的可設定工具#
桌面用戶端讀取目前可見的遊戲視窗，不需要你的遊戲帳號密碼。它會辨識角色、指定怪物、小地圖位置及 HP/MP 區域，再依照已儲存的策略與按鍵設定運行。角色範本、怪物範本和一般設定均保存在本機裝置。
桌面用戶端可以自動處理什麼#
先完成最小設定並從運行日誌確認辨識正常，再逐項開啟選用功能，較容易判斷問題來源。
角色與怪物辨識
分別建立角色及指定怪物面向左、右的圖像範本，用戶端會據此定位畫面中的可見目標。
練功與掛機路線
支援定點攻擊、兩點往返，以及使用地圖編輯器自行製作的多層地圖路線。
自動補給與增益
可設定 HP/MP 觸發門檻、藥水按鍵、冷卻時間，以及最多五組定時增益技能。
拾取與戰鬥控制
集中設定攻擊、跳躍、拾取、轉向方式及各策略需要的動作間隔。
運行日誌與啟動檢查
策略啟動前檢查遊戲視窗、小地圖、角色、怪物及生命狀態辨識，日誌會顯示結果。
本機設定與路線
設定、使用者範本和地圖路線檔儲存在本機，可依照實際地圖反覆測試與調整。
開始前需要準備#
- 64 位元 Windows 10/11，或配備 Apple 晶片（M 系列）的 Mac
- 以 1366 × 768 執行楓之谷並完整顯示小地圖
- macOS 的「輔助使用」及「螢幕與系統音訊錄製」權限
- 有效授權及首次啟用所需的網路連線
- 在實際使用的作業系統與遊戲環境中擷取的範本
楓之谷 Classic World 自動化常見問題#
支援 Windows 和 macOS 嗎？+
支援 64 位元 Windows 10/11 與 Apple 晶片 Mac。目前的 Mac 套件不適用 Intel Mac。
為什麼必須使用 1366 × 768？+
遊戲視窗、小地圖與 HP/MP 辨識區域以 1366 × 768 用戶端畫面校準，其他解析度可能無法通過啟動檢查。
用戶端需要我的楓之谷帳號密碼嗎？+
不需要。用戶端讀取可見的遊戲畫面，並使用你設定的本機按鍵控制。請勿將帳號密碼或 license.dat 傳給客服。
第一次應該使用哪種策略？+
建議先用「定點攻擊」，只選一種怪物並關閉選用功能。基礎辨識穩定後，再加入補給、增益、拾取或路線移動。
Windows 和 Mac 可以共用範本嗎？+
一般設定與路線檔可以備份，但不同系統的畫面渲染可能不同，建議在目標系統重新擷取角色與怪物範本。
我可以自行編輯 Bot 的地圖路線嗎？+
可以。使用瀏覽器地圖編輯器標記平台、節點與移動動作，匯出 JSON 路線後匯入桌面用戶端。每條路線都應在相符的地圖與解析度下建立及測試。
02
使用說明
遊戲實際畫面#
安裝、權限與啟用#
先安裝符合目前系統的套件，完成平台檢查後再設定策略。
Windows 安裝
將 64 位元 Windows ZIP 完整解壓縮到固定資料夾，不要直接從壓縮檔預覽視窗啟動。請使用系統管理員權限執行程式。
Apple 晶片 Mac 安裝
首次開啟前先將 App 移至「應用程式」，同時授予「輔助使用」與「螢幕與系統音訊錄製」，再完全結束並重新開啟。目前套件不適用 Intel Mac。
檢查 macOS 權限
「輔助使用」用於送出移動、攻擊與補給按鍵；「螢幕與系統音訊錄製」用於讀取遊戲視窗、角色、小地圖及 HP/MP。兩處都應加入「應用程式」內的正式 App，而不是 Terminal、Python、舊版本或同名資料夾。開啟後以 Command-Q 完全結束再重開。
啟用授權
輸入完整授權碼且不要帶前後空格，連線啟用並等待成功狀態。若 macOS 顯示鑰匙圈提示，請輸入目前的 Mac 登入密碼，而不是授權碼。
本機資料與備份
Windows 資料位於 %LOCALAPPDATA%\Okya\，macOS 資料位於 ~/Library/Application Support/Okya/。只備份 config.json、templates 與 maps；不要將 license.dat 複製到其他電腦。
建立可靠的辨識範本#
請在實際運行的系統與遊戲環境中，分別擷取目標朝左與朝右的畫面。
角色範本（固定 20 × 20 px）
建立並命名角色範本，先讓角色朝左，擷取頭部上方較穩定的區域；再讓角色朝右，選取完全相同的部位。確認左右預覽只包含角色本體後儲存並選取。
怪物範本（固定 10 × 10 px）
優先選擇動作變化小、動畫幀數較少的怪物。在穩定畫格分別擷取左右方向相同且不易變化的部位，例如頭頂、角或眼睛附近。首次只選一種，日常建議使用 1–3 種。
良好與不良範本
良好範本的左右取樣位置一致，且只包含目標本體。若包含地面、平台邊緣、背景、名稱、傷害數字、聊天文字、寵物、技能特效或其他怪物，請刪除後重新擷取。
何時需要重建
遊戲解析度、顯示縮放、造型、特效、遊戲用戶端或作業系統變更後，必須重新擷取全部範本。範本截圖必須與實際運行的解析度完全一致；Windows 與 macOS 的像素渲染也可能不同。
首次使用設定步驟#
以下流程依據目前桌面用戶端程式與首次使用指南整理。
- 1
安裝適用於 64 位元 Windows 或 Apple 晶片 Mac 的正確套件。macOS 使用者應先把 App 移至「應用程式」，再授予權限。
- 2
將遊戲設為 1366 × 768 的視窗或無邊框視窗模式，並確保小地圖、HP 與 MP 區域在主顯示器上完整可見。
- 3
啟用授權並選擇實際遊戲伺服器，讓用戶端使用相符的小地圖色彩及 HP/MP 辨識區域。
- 4
分別擷取角色與指定怪物面向左、右的範本；更換系統、縮放、外觀或遊戲用戶端後應重新擷取。
- 5
第一次測試選擇「定點攻擊」，只設定角色、一種怪物、攻擊鍵及跳躍鍵。
- 6
啟動策略並查看運行日誌。確認角色及小地圖均辨識成功後，再依序開啟補給、增益與拾取。
運行模式、戰鬥與選用功能#
每次只修改一項並儲存，從運行日誌確認正常後再繼續。
遊戲畫面與基本設定
遊戲使用 1366 × 768 視窗或無邊框模式並置於主螢幕，小地圖完整展開，HP/MP 維持預設位置。軟體內選擇正確伺服器、已儲存角色和一種怪物，並先測試測謊儀警示聲音。
先用診斷模式
「僅辨識」可檢查遊戲視窗、角色、怪物、小地圖及 HP/MP 而不送出戰鬥按鍵；「僅移動」用於驗證巡航與預設路線。兩項正常後再使用完整執行。
戰鬥與移動
攻擊與跳躍按鍵需與遊戲快捷鍵一致。橫向、縱向範圍先採保守值，避免誤追其他平台的怪物。
自動補血與補魔
兩者可分別開啟。首次可從 50% 門檻和約 1 秒冷卻開始，冷卻不得低於 0.1 秒。若日誌顯示 HP 或 MP 為 0.0%，先關閉補給並檢查伺服器、解析度、視窗、預設 UI 與錄製權限。
增益與物品拾取
最多可設定 5 個增益欄位，先測試 1 個；啟用項目需有按鍵且週期大於 0。拾取間隔建議由 0.45 秒開始，最低 0.05 秒，過快會打斷攻擊。
第一次完整運行
進入目標地圖、展開小地圖並確認 HP/MP，儲存伺服器、解析度、角色、怪物、策略與按鍵後從安全位置啟動。等待軟體自動將焦點切回遊戲；只有日誌確認視窗、角色、小地圖與啟動檢查通過才算真正運行。
啟動前 30 秒檢查
確認地圖與安全位置、主螢幕上的 1366 × 768、展開的小地圖、正確伺服器/角色/怪物/策略、所有快捷鍵、足夠補給與背包空間，以及可聽見的測謊儀警示。
三種地圖運行策略#
不同地圖結構應選擇不同策略。新設定先單獨測試移動，再逐步加入其他動作。
定點攻擊
適合首次測試與固定平台。用戶端會記錄啟動時的小地圖位置，角色遭擊退或偏移後可嘗試回到原位。
兩點往返巡航
在小地圖水平 A、B 座標之間移動，可設定端點停留時間，以及是否只在端點攻擊。
自訂路線巡航
依照你在地圖編輯器中建立的節點、平台與動作運行；匯入路線需與目前地圖相符。
建立並使用自訂 Bot 路線#
地圖編輯器用來描述 Bot 在指定地圖中的移動方式。請依照桌面用戶端實際運行時使用的地圖與遊戲畫面建立路線。
三步建立地圖路線
- 1匯入實際運行的地圖
先讓遊戲以日常使用的解析度、視窗模式與介面配置進入目標地圖，再擷取目前遊戲畫面。開啟地圖編輯器並按下「匯入地圖」。請使用自己真實運行環境的截圖，不要使用攻略網站地圖、縮放圖片或其他裝置的截圖，以免座標無法與桌面用戶端對應。
- 2框選左上角小地圖區域
選擇「框選」，先點擊小地圖可見內容的左上角，再點擊右下角並儲存裁切。選取範圍應完整包含可行走平台、繩索、梯子與傳送點，同時排除遊戲場景、聊天、任務提示及小地圖外的介面。儲存前請放大確認邊界與桌面用戶端實際辨識的小地圖一致。
- 3開始標點並建立路線
使用「標點」在轉向、落腳、繩梯入口與傳送點放置節點；需要時標示平台，再連接相鄰節點並指定左移、右移、跳躍、攀爬、下跳或傳送。完成後匯出路線並在桌面用戶端為同一張地圖匯入；先只測試移動，穩定後再啟用攻擊與拾取。
依正確順序排除問題#
先閱讀運行日誌並處理最早失敗的啟動檢查，再調整策略。
找不到遊戲視窗
確認遊戲在主螢幕以 1366 × 768 視窗或無邊框模式運行。macOS 變更錄製權限後必須重新啟動 App。
角色、怪物或小地圖辨識失敗
移除遮擋、核對伺服器與範本、完整展開小地圖，並在目前環境重新擷取左右範本。
HP/MP 都顯示 0.0%
先關閉自動補給，核對正確伺服器、1366 × 768、預設遊戲 UI、視窗位置與螢幕錄製權限後再測試。
怪物漏辨識或辨識錯誤
只選一種怪物，在穩定畫格重新擷取左右範本並使用獨特區域。包含背景或從其他作業系統複製的範本應刪除並在目前系統重建。
辨識成功但沒有按鍵
讓遊戲重新取得焦點，核對快捷鍵與 macOS「輔助使用」。Windows 上請使用系統管理員權限執行程式。
macOS 權限仍反覆提示
刪除舊包、測試包、Python、Terminal 或同名資料夾的舊項目，將「應用程式」中的正式 App 重新加入兩項權限，開啟後以 Command-Q 完全結束再重開。
巡航越過邊界
將 A、B 端點向安全平台內側移動，先以「僅移動」測試；偵測間隔與角色慣性可能造成短暫越界。
更新、備份與支援#
保留已驗證的設定，但不要移動裝置綁定的授權資料或傳送敏感資訊。
更新前
停止策略並結束 App，備份 config.json、templates 與 maps。安裝新版後核對版本、伺服器、範本、按鍵和策略。
移至另一台電腦
一般設定和路線可檢查後移轉，但不要移轉 license.dat。新裝置需重新啟用、授權並擷取範本。
聯絡支援
提供版本、系統與晶片、伺服器、解析度、視窗模式、策略、參數及從啟動到首次失敗的完整日誌，並移除授權碼、裝置識別及帳號名稱。