01 · 產品介紹
本機桌面自動化
楓之谷 Classic World 自動練功工具
為 Global MapleStory Classic World 設計的本機自動練功工具，適用於 Windows 10/11、Apple 晶片與 Intel 晶片 Mac。透過畫面辨識及自訂按鍵處理練功、補水與增益，並提供定點攻擊、兩點往返和自訂路線。角色與怪物範本須在實際使用的遊戲環境中擷取。
- 支援平台
- Windows 10/11 · Apple 晶片 / Intel Mac
- 處理方式
- 本機圖像辨識
Classic World 的本機自動化如何運作#
桌面用戶端讀取可見的遊戲視窗，辨識角色、指定怪物、小地圖及 HP/MP，再依已儲存的策略送出本機按鍵，不需要遊戲帳號密碼。瀏覽器地圖編輯器只負責製作路線檔；Bot 實際在電腦用戶端執行，不是在網頁中運行。購買前請向客服確認伺服器、遊戲版本與作業系統，更新或畫面變更可能影響相容性。
桌面用戶端可以自動處理什麼#
先完成最小設定並從運行日誌確認辨識正常，再逐項開啟選用功能，較容易判斷問題來源。
角色與怪物辨識
分別建立角色及指定怪物面向左、右的圖像範本，用戶端會據此定位畫面中的可見目標。
練功與掛機路線
支援定點攻擊、兩點往返，以及使用地圖編輯器自行製作的多層地圖路線。
自動補給與增益
可設定 HP/MP 觸發門檻、藥水按鍵、冷卻時間，以及最多五組定時增益技能。
拾取與戰鬥控制
集中設定攻擊、跳躍、拾取、轉向方式及各策略需要的動作間隔。
運行日誌與啟動檢查
策略啟動前檢查遊戲視窗、小地圖、角色、怪物及生命狀態辨識，日誌會顯示結果。
本機設定與路線
設定、使用者範本和地圖路線檔儲存在本機，可依照實際地圖反覆測試與調整。
開始前需要準備#
- 64 位元 Windows 10/11，或配備 Apple 晶片（M 系列，macOS 11 以上）或 Intel 晶片（macOS 12 以上）的 Mac
- 執行楓之谷並完整顯示小地圖
- macOS 的「輔助使用」及「螢幕與系統音訊錄製」權限
- 有效授權及首次啟用所需的網路連線
- 在實際使用的作業系統與遊戲環境中擷取的範本
楓之谷 Classic World 自動化常見問題#
支援 Windows 和 macOS 嗎？+
支援 64 位元 Windows 10/11、Apple 晶片 Mac（macOS 11 以上）與 Intel Mac（macOS 12 以上），兩種晶片各有獨立的 Mac 套件。
購買前要確認哪些 Classic World 版本資訊？+
本指南以 Global MapleStory Classic World 為主。相容性取決於伺服器、遊戲版本、作業系統及目前遊戲介面。購買前請將這些資訊寄至 hi@okya.app 確認；同為經典服，不代表所有伺服器或更新版本都能使用相同設定。
這是網頁版 Bot，還是安裝在電腦上的工具？+
Bot 是需購買授權的桌面用戶端，在 Windows 或 Mac 本機執行。地圖路線編輯器則免費提供，可在瀏覽器匯入圖片、建立節點與移動動作，再匯出 JSON 給用戶端使用。編輯器本身不會執行遊戲或 Bot。
購買後如何取得授權與下載？+
月卡 $19 / 30 天，季卡 $39 / 90 天，年卡 $99 / 365 天，皆含全部自動化功能。永久版已停止販售。 付款確認後，訂單頁面會提供授權碼，以及 Windows 與 Apple 晶片 Mac 各自的下載按鈕。請透過官方訂單下載用戶端，再依下方教學完成安裝與首次設定。
02
使用說明
遊戲實際畫面#
安裝、權限與啟用#
先安裝符合目前系統的套件，完成平台檢查後再設定策略。
Windows 安裝
將 64 位元 Windows ZIP 完整解壓縮到固定資料夾，不要直接從壓縮檔預覽視窗啟動。請使用系統管理員權限執行程式。
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）
建立並命名角色範本，先讓角色朝左，擷取頭部上方較穩定的區域；再讓角色朝右，選取完全相同的部位。確認左右預覽只包含角色本體後儲存並選取。
怪物範本（固定 10 × 10 px）
優先選擇動作變化小、動畫幀數較少的怪物。在穩定畫格分別擷取左右方向相同且不易變化的部位，例如頭頂、角或眼睛附近。首次只選一種，日常建議使用 1–3 種。
良好與不良範本
良好範本的左右取樣位置一致，且只包含目標本體。若包含地面、平台邊緣、背景、名稱、傷害數字、聊天文字、寵物、技能特效或其他怪物，請刪除後重新擷取。
何時需要重建
造型、特效、遊戲用戶端或作業系統變更後，必須重新擷取全部範本。Windows 與 macOS 的像素渲染也可能不同。
首次使用設定步驟#
以下流程依據目前桌面用戶端程式與首次使用指南整理。
- 1
安裝適用於 64 位元 Windows、Apple 晶片 Mac 或 Intel Mac 的正確套件。macOS 使用者應先把 App 移至「應用程式」，再授予權限。
- 2
使用視窗或無邊框視窗模式執行遊戲，並確保小地圖、HP 與 MP 區域在主顯示器上完整可見。
- 3
啟用授權並選擇實際遊戲伺服器，讓用戶端使用相符的小地圖色彩及 HP/MP 辨識區域。
- 4
分別擷取角色與指定怪物面向左、右的範本；更換系統、外觀或遊戲用戶端後應重新擷取。
- 5
第一次測試選擇「定點攻擊」，只設定角色、一種怪物、攻擊鍵及跳躍鍵。
- 6
啟動策略並查看運行日誌。確認角色及小地圖均辨識成功後，再依序開啟補給、增益與拾取。
運行模式、戰鬥與選用功能#
每次只修改一項並儲存，從運行日誌確認正常後再繼續。
遊戲畫面與基本設定
遊戲使用視窗或無邊框模式並置於主螢幕，小地圖完整展開，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 座標之間移動，可設定端點停留時間，以及是否只在端點攻擊。
自訂路線巡航
依照你在地圖編輯器中建立的節點、平台與動作運行；匯入路線需與目前地圖相符。
建立並使用自訂 Bot 路線#
地圖編輯器用來描述 Bot 在指定地圖中的移動方式。請依照桌面用戶端實際運行時使用的地圖與遊戲畫面建立路線。
三步建立地圖路線
- 1匯入實際運行的地圖
先讓遊戲以日常使用的視窗模式與介面配置進入目標地圖，再擷取目前遊戲畫面。開啟地圖編輯器並按下「匯入地圖」。請使用自己真實運行環境的截圖，不要使用攻略網站地圖、縮放圖片或其他裝置的截圖，以免座標無法與桌面用戶端對應。
- 2框選左上角小地圖區域
選擇「框選」，先點擊小地圖可見內容的左上角，再點擊右下角並儲存裁切。選取範圍應完整包含可行走平台、繩索、梯子與傳送點，同時排除遊戲場景、聊天、任務提示及小地圖外的介面。儲存前請放大確認邊界與桌面用戶端實際辨識的小地圖一致。
- 3開始標點並建立路線
使用「標點」在轉向、落腳、繩梯入口與傳送點放置節點；需要時標示平台，再連接相鄰節點並指定左移、右移、跳躍、攀爬、下跳或傳送。完成後匯出路線並在桌面用戶端為同一張地圖匯入；先只測試移動，穩定後再啟用攻擊與拾取。
更新、備份與支援#
保留已驗證的設定，但不要移動裝置綁定的授權資料或傳送敏感資訊。
更新前
停止策略並結束 App，備份 config.json、templates 與 maps。安裝新版後核對版本、伺服器、範本、按鍵和策略。
移至另一台電腦
一般設定和路線可檢查後移轉，但不要移轉 license.dat。新裝置需重新啟用、授權並擷取範本。
更換綁定裝置
授權與首次啟用的裝置綁定。更換電腦、重新安裝系統或更換硬體後需要換綁，請聯絡客服（hi@okya.app）並提供訂單編號，由客服協助處理。請不要將 license.dat 複製到新裝置。
聯絡支援
提供版本、系統與晶片、伺服器、視窗模式、策略、參數及從啟動到首次失敗的完整日誌，並移除授權碼、裝置識別及帳號名稱。
03
問題排查
依現象找到對應條目,照著步驟處理,有效就不必繼續往下。請先完成基礎設定,再排查具體問題。
依正確順序排除問題#
先閱讀運行日誌並處理最早失敗的啟動檢查，再調整策略。
找不到遊戲視窗
確認遊戲在主螢幕以視窗或無邊框模式運行。macOS 變更錄製權限後必須重新啟動 App。
角色、怪物或小地圖辨識失敗
移除遮擋、核對伺服器與範本、完整展開小地圖，並在目前環境重新擷取左右範本。
HP/MP 都顯示 0.0%
先關閉自動補給，核對正確伺服器、預設遊戲 UI、視窗位置與螢幕錄製權限後再測試。
怪物漏辨識或辨識錯誤
只選一種怪物，在穩定畫格重新擷取左右範本並使用獨特區域。包含背景或從其他作業系統複製的範本應刪除並在目前系統重建。
辨識成功但沒有按鍵
讓遊戲重新取得焦點，核對快捷鍵與 macOS「輔助使用」。Windows 上請使用系統管理員權限執行程式。
macOS 權限仍反覆提示
刪除舊包、測試包、Python、Terminal 或同名資料夾的舊項目，將「應用程式」中的正式 App 重新加入兩項權限，開啟後以 Command-Q 完全結束再重開。
巡航越過邊界
將 A、B 端點向安全平台內側移動，先以「僅移動」測試；偵測間隔與角色慣性可能造成短暫越界。
安裝與啟用#
macOS 提示無法驗證開發者，或應用程式已損毀+
先確認安裝包來自官方位址、下載完整，並且與晶片架構相符（Apple 晶片或 Intel）。不要只憑「已損毀」的提示判斷原因。
確認來源可信後，到「系統設定 → 隱私權與安全性」查看是否有「仍要打開」。仍無法開啟，請聯絡客服並提供完整提示、用戶端版本、Mac 晶片與 macOS 版本。
重新安裝系統或換電腦後，提示授權已綁定+
一份授權綁定一台裝置。同一台裝置可以切換不同的遊戲帳號，但這不等於可以同時多開遊戲，也不等於一份授權能用於多台電腦或虛擬機。
重新安裝系統或更換裝置後出現綁定提示，請聯絡客服（hi@okya.app）並提供訂單編號，由客服核對並處理換綁。
請不要反覆嘗試他人的授權，也不要在論壇或公開截圖裡發布完整授權碼。
授權檢查通過了，為什麼還是不能啟動？+
「License check passed」只表示授權通過，不代表遊戲視窗、角色、小地圖與擷取來源都已辨識成功。
請繼續查看後面的日誌，判斷失敗發生在視窗擷取、角色辨識還是小地圖辨識，再對照下面對應的條目處理。
防毒軟體攔截或提示風險+
Windows 上需要以系統管理員身分啟動程式。我們無法保證相容所有防毒軟體設定。
請把攔截提示原文與安裝包來源傳給客服，由客服核對官方檔案。不建議把關閉安全軟體或加入排除項當作預設辦法。
啟動與視窗擷取#
提示找不到遊戲視窗或解析度不正確+
請依序檢查：
- 確認實際遊戲視窗是 1366 × 768，而不只是全螢幕設定裡顯示了這個數字。
- 使用視窗模式，保持遊戲完整可見，不最小化、不最大化，也不被其他視窗覆蓋。
- 如果版本提供擷取來源選擇，請選中實際的遊戲視窗。
- 修改解析度後，先停止目前執行再重新啟動，必要時重啟用戶端。
- 解析度或顯示尺寸改變後，請重新採集角色與怪物範本。
Mac 已開啟輔助使用與螢幕錄製權限，點擊啟動仍無反應+
確認「輔助使用」與「螢幕錄製」已為正在執行的用戶端開啟，同時查看完整的啟動日誌。
曾有案例看起來像權限問題，實際阻塞點是角色與怪物範本辨識。不要只根據一條權限提示反覆修改權限，還要核對視窗尺寸、小地圖、角色範本與擷取來源。
問題持續時，請提供權限頁面、用戶端設定、完整桌面截圖與啟動日誌。
日誌顯示 Game is not in the foreground+
點擊用戶端的設定或日誌視窗後，遊戲會失去前景焦點，此時出現該提示是正常的。請先停止執行再修改設定，完成後重新啟動並點回遊戲，讓遊戲保持在前景。
如果遊戲確實在前景，提示仍持續出現，請提交完整日誌與螢幕配置，不要預設是操作問題。
日誌出現 0 × 0 視窗，或小地圖辨識失敗+
已有報告同時出現視窗尺寸 0 × 0、回退到主螢幕全螢幕擷取以及 minimap not detected。請確認遊戲沒有最小化、實際擷取的是遊戲視窗，並展開小地圖讓人物標記可見。
啟動時盡量讓角色保持靜止、不受攻擊。仍失敗請提供完整日誌與遊戲全視窗截圖。
角色與怪物辨識#
角色定位頻繁遺失，範本應該怎麼擷取？+
請在角色正常站立、沒有受擊閃爍時擷取，優先擷取上半部，尤其是頭部附近清晰穩定的特徵。
- 不要包含技能文字、傷害數字、背景裝飾或大範圍特效。
- 分別採集左右朝向，儲存後選中對應設定。
- 執行時也盡量避免特效持續遮擋角色。
- 更改遊戲解析度後重新擷取，不要繼續使用舊尺寸的範本。
怪物範本儲存了，仍然辨識不到+
先排除下一條裡的「怪物在攻擊範圍外所以計數為 0」，再檢查範本：
- 選擇姿態相對穩定的怪物與清晰的特徵，例如頭頂、角等變化較小的位置。
- 左右朝向盡量擷取同一個特徵部位。
- 避開背景、傷害數字與技能特效。
- 在實際執行的解析度下重新採集，儲存後確認已選中。
- 先只選擇一種怪物測試，便於判斷問題。
畫面裡明明有怪，日誌為什麼顯示 0？+
日誌只統計你設定的橫向攻擊範圍內的怪物，不是整個畫面裡的怪物總數。怪物在範圍之外時顯示 0 可能是正常結果。
先觀察怪物進入設定範圍後數量是否變化。只有怪物已經進入範圍、日誌仍持續為 0 時，再檢查範本與辨識設定。不要僅因為日誌顯示 0 就重截範本。
小地圖與角色辨識應該檢查什麼？+
確認伺服器選擇正確，小地圖完整展開且人物標記可見，遊戲處於正確的解析度與視窗模式。啟動時盡量靜止、不處於受擊狀態。
留意日誌中的 CHARACTER_RECOGNITION、MINIMAP_RECOGNITION 或 MARKER_COLOR_ABSENT，分別檢查角色與小地圖的結果。「角色辨識成功」不能證明小地圖也已辨識成功。
戰鬥與攻擊範圍#
只來回移動，不打怪+
依序檢查：角色與小地圖是否辨識成功、目標怪物範本是否選中、怪物是否進入設定的攻擊範圍、攻擊鍵是否與遊戲一致，以及設定的技能是否已經學會。
先回到原地攻擊驗證基礎辨識與按鍵。不要僅靠切換巡邏模式就判斷已經修好。
橫向攻擊範圍怎麼設定？+
這個數值對應遊戲畫面裡的像素距離，請參考角色在目前顯示設定下的實際攻擊距離。
可以用能顯示選區像素尺寸的截圖工具估算攻擊距離再調整。不要直接套用其他職業的數值，也沒有「某個數一定正確」的結論。針對新手短距離匕首，客服曾建議 50 像素或以下，這只是短距離攻擊的示例，不是所有職業的預設值。
不斷攻擊空地，浪費 MP 或消耗品+
攻擊範圍過大，用戶端可能去攻擊實際打不到的怪物；範本不穩定也會造成漏辨識或誤比對。先檢查實際攻擊距離、範本品質與目前辨識結果。
如果持續空打，請停止本次執行避免繼續消耗資源，並把攻擊設定、範本與簡短的重現紀錄交給客服。目前沒有保證「沒有怪物時一定停止攻擊」的開關。
改了設定，為什麼看起來沒有生效？+
設定變更不會自動套用到已經執行的工作階段。請依序操作：停止執行 → 儲存修改 → 重新啟動。
修改攻擊範圍、技能鍵、數量門檻或解析度後，都應重新驗證實際效果。
巡邏與地圖編輯器#
如何匯入路線？有範例地圖嗎？+
地圖編輯器附有範例地圖，可以透過 “Load sample map” 了解結構，再製作自己的路線。
匯入時，選擇自訂路線巡邏，在地圖下拉選單旁點 Import，選取匯出的 JSON 檔案。不同版本的名稱或介面可能不同，找不到對應控制項時請提供用戶端截圖確認。
匯出時，Map Name 與 Map ID 建議只使用英文字母與數字。
地圖匯出後點擊 Add to OKYA 沒有出現+
先下載編輯器匯出的 .json 檔案，再在桌面用戶端的自訂路線巡邏中，用地圖旁的 Import 匯入。成功後地圖會出現在下拉清單中。
不需要手動複製到 assets/maps，該目錄用於內建地圖。仍無法匯入時，檢查 Map Name、Map ID 與檔案名稱，並把匯出的 JSON 與錯誤截圖交給客服。不要僅因為匯入失敗就認定檔案格式一定有錯。
聯絡客服時需要提供的資訊#
一次提供齊全,可以減少反覆溝通。
- 系統與版本；Mac 請註明 Apple 晶片或 Intel。
- 用戶端實際版本號。
- 遊戲名稱、伺服器、視窗模式與解析度。
- 是否使用外接螢幕，以及顯示縮放。
- 具體操作步驟、預期結果與實際現象。
- 完整錯誤日誌，不要只擷取最後一行。
- 能同時看到遊戲與用戶端設定的全桌面截圖；辨識問題請附左右朝向範本。
- 按鍵問題請附遊戲與用戶端兩側的按鍵設定。
- 效能問題請附執行時長與相關監測資料；能安全取得時，再補充短影片。