操作手冊
Artale GUI 操作手冊
17 個章節、完整參數說明。輸入授權序號即可閱讀。
快速開始
從零開始下載、安裝並第一次啟動 Artale Script。
v3.2.0 最新版本更新內容
🎯 內建截圖小工具：免開小畫家，一鍵截下繩子 / 梯子 / 傳送點模板，附 8 倍放大微調與即時尺寸燈號。詳見「截圖工具」。
🚨 警告圖片偵測：把圖片丟進
🪢 繩子 / 梯子 / 傳送點資料夾說明：新增 GUI 內建教學頁，引導用戶自行新增地圖專屬模板。
🎯 內建截圖小工具：免開小畫家，一鍵截下繩子 / 梯子 / 傳送點模板，附 8 倍放大微調與即時尺寸燈號。詳見「截圖工具」。
🚨 警告圖片偵測：把圖片丟進
assets/warning/，命中時自動 Beep 3 秒提醒。詳見「警告偵測」。🪢 繩子 / 梯子 / 傳送點資料夾說明：新增 GUI 內建教學頁，引導用戶自行新增地圖專屬模板。
系統需求
最低配置
- Windows 10 64-bit
- Intel Core i5 / AMD 同級
- 8 GB RAM
- 10 GB 可用硬碟空間
- 穩定網路連線
建議配置
- Windows 10 / 11 64-bit
- Intel Core i5 以上
- 16 GB RAM 以上
- SSD 固態硬碟
- 穩定寬頻連線
安裝步驟
- 下載最新版 Artale Script 壓縮檔。
- 解壓縮至一個全英文路徑的資料夾，例如
C:\ArtaleScript。 - 確認遊戲 MapleStory Worlds - Artale（繁體中文版） 已開啟並以視窗模式執行。
- 在解壓縮後的資料夾中，雙擊
start_gui.bat啟動程式。 - 在左側登入欄輸入您的啟動序號，按下登入即可開始使用。
重要：程式資料夾路徑不能包含中文、空格或特殊符號，這是最常見的啟動失敗原因。
教學影片
完整示範角色定位工具、怪物下載及基本參數設定流程，建議初次使用前先觀看。
序號啟動
啟動程式後需要輸入序號登入，才能使用所有功能。
登入步驟
- 啟動
start_gui.bat，程式主視窗開啟。 - 在左側面板找到「序號登入」欄位，將您的啟動序號（UUID）貼入。
- 按下「登入」按鈕，稍候片刻完成驗證。
- 左側狀態列顯示「已登入」後，即可啟動腳本。
每次啟動程式都需要連線驗證，請確保網路正常。序號有效期限請參考購買方案說明。
介面總覽
程式主視窗分為左側控制面板與右側功能頁籤兩大區域。
左側面板
| 區塊 | 說明 |
|---|---|
| 序號登入 | 輸入 UUID、登入 / 登出按鈕，顯示目前帳號狀態 |
| 腳本控制 | 啟動（F1）/ 停止（F2）按鈕，顯示目前運行狀態 |
| 狀態列 | 即時顯示登入狀態、配置檔名稱、目前偵測怪物、腳本狀態 |
右側頁籤
| 頁籤 | 說明 |
|---|---|
| 配置設定 | 所有參數設定，分為 9 個可折疊區塊。頂部有配置檔選擇器與保存按鈕。 |
| Log 紀錄 | 即時顯示腳本執行日誌，Info / Warning / Error 分色顯示，腳本重啟時自動清除。 |
配置設定頁的 9 個區塊
| # | 區塊名稱 | 內容 |
|---|---|---|
| 1 | 攻擊設置 | 主攻擊鍵、次攻擊鍵、跳躍攻擊模式、攻擊範圍、持續時間與冷卻 |
| 2 | 被動技能配置 | 技能 1–4 的啟用開關、按鍵、施放冷卻與隨機延遲 |
| 3 | 移動邏輯配置 | 跳躍移動、隨機下跳、繩子攀爬、傳送點使用、斷層檢測 |
| 4 | 血量與魔力配置 | HP/MP 觸發閾值、補血補魔鍵、冷卻時間、FPS 限制 |
| 5 | 定時休息配置 | 掛機時長、休息時長、循環後自動停止 |
| 6 | 紅點偵測配置 | 玩家入侵偵測與自動換頻道 |
| 7 | 全局配置 | 檢測間隔、邊界偵測、無怪自動停止 |
| 8 | 怪物設置 | 搜尋、下載、選擇目標怪物 |
| 9 | 角色定位設置 | 擷取角色 ID 圖像（per-profile）、啟用組隊血條辨識 |
每個區塊右上角有折疊按鈕，可個別展開 / 收合。頂部也有「全部展開」與「全部折疊」快捷按鈕。設定完成後務必按「保存設定」（綠色按鈕）才會生效。
多配置檔管理
針對不同角色或地圖儲存獨立的設定組合，切換時所有參數一次到位。(首次設定請務必擷取角色 ID 圖像並儲存)
基本操作
| 動作 | 操作方式 | 說明 |
|---|---|---|
| 切換配置檔 | 點選頁籤頂部的下拉選單 | 切換後所有設定值自動載入 |
| 新增配置檔 | 點選「新增」按鈕 | 初始值複製自目前配置檔 |
| 重新命名 | 點選「重命名」按鈕 | 無法重命名預設配置檔「預設」 |
| 刪除配置檔 | 點選「刪除」按鈕 | 無法刪除預設配置檔「預設」 |
| 保存設定 | 點選「保存設定」（綠色） | 將目前頁面所有設定寫入 user_config.json |
配置檔命名規則
- 名稱長度上限：50 個字元
- 不可包含：
\ / : * ? " < > | - 建議使用角色名稱或地圖名稱命名，方便辨識
每個配置檔各自儲存獨立的角色定位圖像，路徑格式為
assets/player/medal_{配置檔名稱}.png。切換配置檔後若角色定位失效，請重新至「角色定位設置」擷取。
血量與魔力監控
程式透過截圖分析角色的 HP / MP 條，當數值低於設定閾值時自動按下對應按鍵。
請先確認遊戲中補血 / 補魔技能的快捷鍵，再於此處填入相同按鍵名稱，兩邊一致才能正常觸發。
設定參數
| GUI 欄位 | 預設值 | 說明 |
|---|---|---|
| ENABLE_HEALTH_MONITOR | true | 血量魔力監控的主開關，建議保持開啟。關閉後補血補魔功能完全停止。 |
| HEALTH_MONITOR_HP_THRESHOLD | 0.5 | HP 觸發閾值（0.0 – 1.0）。0.5 表示 HP 低於 50% 時觸發補血。數值越大越早補血。 |
| HEALTH_MONITOR_MP_THRESHOLD | 0.5 | MP 觸發閾值，邏輯同上。 |
| HEALTH_MONITOR_HEAL_KEY | pageup | 補血按鍵。點擊欄位後按下鍵盤按鍵即可自動填入，須與遊戲快捷鍵完全一致。 |
| HEALTH_MONITOR_MP_KEY | pagedown | 補魔按鍵，設定方式同上。 |
| HEALTH_MONITOR_HEAL_COOLDOWN | 1.0 秒 | 兩次補血之間的最短間隔（秒）。 |
| HEALTH_MONITOR_MP_COOLDOWN | 1.0 秒 | 兩次補魔之間的最短間隔（秒）。 |
| HEALTH_MONITOR_FPS_LIMIT | 10 | 血量偵測的截圖頻率（每秒幾次，1 – 60）。10 FPS 通常已足夠，數值過高會增加 CPU 負擔。 |
| HEALTH_MONITOR_AUTO_DETECT_BARS | true | 自動偵測 HP / MP 條在畫面上的位置，通常保持開啟即可。 |
| HEALTH_MONITOR_DEBUG_OUTPUT | true | 在 Log 頁籤顯示血量偵測的即時數值，方便確認偵測是否正常，排查問題時開啟。 |
被動技能設定
設定需要定時施放的 Buff 或主動技能，程式依照冷卻時間自動按下對應按鍵。
主開關與隨機延遲
| GUI 欄位 | 預設值 | 說明 |
|---|---|---|
| ENABLE_PASSIVE_SKILLS | false | 被動技能系統的主開關。必須開啟後，下方各技能設定才會生效。 |
| PASSIVE_SKILL_RANDOM_DELAY_MIN | 1.0 秒 | 每次技能施放前隨機等待的最短時間（秒）。加入隨機延遲使行為更自然，避免固定節奏。 |
| PASSIVE_SKILL_RANDOM_DELAY_MAX | 5.0 秒 | 每次技能施放前隨機等待的最長時間（秒），必須大於等於最短時間。 |
技能 1 – 4
每個技能欄位各有三個設定項，以技能 1 為例，其餘 2–4 依此類推：
| GUI 欄位 | 預設值 | 說明 |
|---|---|---|
| ENABLE_PASSIVE_SKILL_1 | false | 是否啟用技能 1 的自動施放。 |
| PASSIVE_SKILL_1_KEY | "1" | 技能 1 的按鍵，點擊後直接按鍵盤自動填入，須與遊戲快捷鍵一致。 |
| PASSIVE_SKILL_1_COOLDOWN | 100.0 秒 | 技能 1 的自動施放間隔（秒），建議設定略短於遊戲實際冷卻時間。 |
範例：Buff 技能綁在 5，遊戲冷卻 90 秒。
→
保存後啟動腳本即可每 85 秒自動施放一次。
→
ENABLE_PASSIVE_SKILLS = true、ENABLE_PASSIVE_SKILL_1 = true、PASSIVE_SKILL_1_KEY = "5"、PASSIVE_SKILL_1_COOLDOWN = 85保存後啟動腳本即可每 85 秒自動施放一次。
攻擊設定
設定腳本對偵測到的怪物自動出手的方式，包含主攻擊鍵、跳躍模式與副攻擊。
主攻擊
| GUI 欄位 | 預設值 | 說明 |
|---|---|---|
| ATTACK_KEY | "z" | 主攻擊技能的按鍵，須與遊戲快捷鍵一致。 |
| ATTACK_HOLD_DURATION | 0.1 秒 | 按下攻擊鍵的持續時間（0.1 – 100.0 秒）。單次施放技能設短（0.1 秒），需要長按的技能或是怪物需攻擊較多下可調長該值。 |
| ATTACK_COOLDOWN | 0.0 秒 | 兩次攻擊觸發之間的最短等待時間（秒）。 |
| ATTACK_RANGE_X | 600 px | 怪物偵測範圍半徑（像素）。怪物在此範圍內才觸發攻擊動作。 |
跳躍設定
| GUI 欄位 | 預設值 | 說明 |
|---|---|---|
| JUMP_KEY | "alt" | 跳躍鍵，須與遊戲快捷鍵一致。 |
| JUMP_ATTACK_MODE | "original" | 攻擊前的跳躍方式：original：先跳再攻擊（通用型）mage：使用瞬移技能再攻擊（法師適用）disabled：不跳，直接攻擊 |
副攻擊
| GUI 欄位 | 預設值 | 說明 |
|---|---|---|
| ENABLE_SECONDARY_ATTACK | false | 啟用雙攻擊模式，程式依機率在主副攻擊鍵之間切換。 |
| SECONDARY_ATTACK_KEY | "c" | 副攻擊技能的按鍵。 |
| PRIMARY_ATTACK_CHANCE | 1.0 | 使用主攻擊的機率（0.0 – 1.0）。 |
| SECONDARY_ATTACK_CHANCE | 0.0 | 使用副攻擊的機率，兩者之和請設定為 1.0。 |
移動邏輯
設定角色在地圖上尋找怪物時的移動方式。
衝刺 / 瞬移移動
| GUI 欄位 | 預設值 | 說明 |
|---|---|---|
| ENABLE_DASH_MOVEMENT | true | 啟用瞬移移動。法師職業開啟後機率性瞬移移動。 |
| DASH_SKILL_KEY | "x" | 瞬移技能的按鍵。 |
| DASH_SKILL_COOLDOWN | 3.0 秒 | 瞬移技能冷卻時間（秒）。 |
| DASH_MOVEMENT_CHANCE | 0.7 | 移動時使用瞬移的機率（0.0 – 1.0）。0.7 表示 70% 機率使用瞬移移動。 |
跳躍移動
| GUI 欄位 | 預設值 | 說明 |
|---|---|---|
| ENABLE_JUMP_MOVEMENT | false | 啟用跳躍移動，在高差較多的地圖較高機率跳到各種平台上方。 |
| JUMP_MOVEMENT_CHANCE | 0.2 | 移動時跳躍的機率（0.0 – 1.0）。 |
下跳
| GUI 欄位 | 預設值 | 說明 |
|---|---|---|
| ENABLE_DOWN_JUMP | false | 啟用隨機向下跳（下穿平台），適合多層地圖。 |
| DOWN_JUMP_CHANCE | 1.0 | 觸發下跳的機率（0.0 – 1.0）。 |
| DOWN_JUMP_COOLDOWN | 30.0 秒 | 兩次下跳之間的冷卻時間（秒）。 |
繩子攀爬
| GUI 欄位 | 預設值 | 說明 |
|---|---|---|
| ENABLE_ROPE_CLIMBING | true | 自動偵測並攀爬繩子，有多層平台的地圖建議開啟。 |
| ROPE_MIN_DISTANCE | 65 px | 觸發攀爬的最小偵測距離（像素）。角色需在此距離內才會嘗試爬繩(該值針對無速度加乘之狀態設定，如有速度激發等加速效果請多次嘗試調高該值以提高爬繩成功機率)。 |
| ROPE_MAX_DISTANCE | 80 px | 觸發攀爬的最大偵測距離（像素）(該值針對無速度加乘之狀態設定，如有速度激發等加速效果請多次嘗試調高該值以提高爬繩成功機率)。 |
| ROPE_COOLDOWN_TIME | 60.0 秒 | 兩次攀繩之間的冷卻時間（秒），避免反覆攀繩造成卡住。 |
| ROPE_MAX_CLIMBING_DURATION | 15.0 秒 | 單次攀繩的最長持續時間（1.0 – 20.0 秒），超過後自動鬆開繩子。 |
繩子圖片自訂：若啟用繩子攀爬後，角色仍無法正確偵測地圖上的繩子，請自行截圖遊戲中的繩子圖片，放入程式的
assets\rope 資料夾內，程式將自動載入辨識。
其他移動設定
| GUI 欄位 | 預設值 | 說明 |
|---|---|---|
| ENABLE_CLIFF_DETECTION | true | 偵測到地形高低差時自動跳躍，防止角色卡在高差邊緣，建議保持開啟。 |
| ENABLE_TELEPORT_DETECTION | false | 自動偵測並使用傳送點，適合多傳點地圖(101)。 |
| TELEPORT_COOLDOWN_TIME | 5.0 秒 | 兩次使用傳送門之間的冷卻時間（秒）。 |
傳送點圖片自訂：若地圖含有傳送點且有使用需求，請自行截圖遊戲中的傳送點圖片，放入程式的
assets\teleport 資料夾內，程式將自動載入辨識。
定時休息
程式自動在「掛機打怪」與「進入自由市場休息」之間交替，模擬自然的遊戲行為。
運作流程
- 腳本啟動後進入掛機階段，持續時間在
FARMING_MIN至FARMING_MAX之間隨機決定。 - 掛機時間到後自動移動至自由市場並停止攻擊，進入休息階段。
- 休息時間在
REST_MIN至REST_MAX之間隨機決定，時間到後回到掛機地圖繼續打怪。 - 若啟用
ENABLE_STOP_AFTER_CYCLES，完成指定循環次數後腳本自動停止。
設定參數
| GUI 欄位 | 預設值 | 說明 |
|---|---|---|
| ENABLE_SCHEDULED_REST | false | 定時休息系統主開關，需手動開啟才會生效。 |
| SCHEDULED_REST_FARMING_MIN | 40 分鐘 | 每次掛機的最短時長（≥ 1 分鐘）。 |
| SCHEDULED_REST_FARMING_MAX | 60 分鐘 | 每次掛機的最長時長（必須 ≥ 最短時長）。 |
| SCHEDULED_REST_REST_MIN | 8 分鐘 | 每次休息的最短時長（≥ 1 分鐘）。 |
| SCHEDULED_REST_REST_MAX | 15 分鐘 | 每次休息的最長時長。 |
| ENABLE_STOP_AFTER_CYCLES | false | 完成 N 個掛機 / 休息循環後自動停止腳本。 |
| SCHEDULED_REST_STOP_CYCLES | 5 | 停止前要完成的循環次數（需搭配上方開關）。 |
紅點偵測
當其他玩家進入地圖（HUD 出現紅點警示）時，程式自動換頻道以規避干擾。
| GUI 欄位 | 預設值 | 說明 |
|---|---|---|
| ENABLE_RED_DOT_DETECTION | true | 紅點偵測主開關，建議保持開啟。 |
| RED_DOT_MIN_TIME | 5.0 秒 | 偵測到紅點後，等待最少幾秒才執行換頻，避免誤觸。 |
| RED_DOT_MAX_TIME | 6.0 秒 | 偵測到紅點後，等待最長幾秒才執行換頻。 |
程式自動選擇隨機頻道切換。
怪物設定
程式使用圖像模板匹配偵測怪物，必須先至'怪物搜尋'下載目標怪物的圖像模板，腳本才會進行攻擊。
未下載怪物模板時，腳本啟動後不會進行任何攻擊動作，請務必先完成此步驟。
下載怪物模板
- 在「配置設定」展開「怪物設置」區塊。
- 在'怪物搜尋'搜尋框輸入您要掛機的地圖上的怪物名稱（中文或英文均可），點擊「搜尋」。
- 從搜尋結果清單中勾選要偵測的怪物。
- 點擊「下載勾選怪物」，圖像模板將自動下載並儲存至
assets/monsters/資料夾。 - 下載完成後即可在'已下載'中啟用該怪物作為攻擊目標。
同一地圖若有多種怪物，建議全部勾選後一次下載，避免遺漏導致部分怪物無法被偵測(總圖片張數請控制<100張，避免延遲嚴重)。
角色定位設定
程式透過比對角色名稱下方的名稱來定位角色位置，每個配置檔都需要獨立擷取一次。
若未完成角色定位，或圖像辨識失敗，程式無法判斷移動方向，可能導致角色站在原地或亂走，請確保每個配置檔都完成此設置。
擷取步驟
- 確認遊戲視窗已開啟，角色在地圖上（非戰鬥狀態）。
- 在「角色定位設置」區塊，點擊「開始擷取角色 ID」按鈕。
- 程式自動截取目前遊戲畫面。
- 用滑鼠框選角色名稱正下方的 ID （文字名稱）。
- 確認框選範圍後，圖像自動儲存至
assets/player/medal_{配置檔名稱}.png。 - 設定區塊中會顯示擷取預覽，確認圖像清晰完整即完成設置。
相關設定
| GUI 欄位 | 預設值 | 說明 |
|---|---|---|
| ENABLE_RED_BAR_DETECTION | false | 改以 HP 血條輔助定位角色。若ID辨識率不佳（例如角色ID太小、顏色相近或地圖會遮擋），可開啟此選項(組隊血條辨識可能更容易被系統偵測腳本)。 |
建議在空曠場景且畫面無其他角色的情況下擷取，避免背景雜訊影響後續辨識精度。
截圖工具（v3.2.0 新增）
內建一鍵截圖小工具，免開小畫家就能截下繩子、梯子、傳送點等模板圖片，自動存到對應資料夾。
位於 GUI 右側「🎯 截圖工具」頁籤。提供兩步驟對話框引導：先框選大概範圍，再用 8 倍放大微調細節。
使用流程
- 切到 GUI 右側「🎯 截圖工具」頁籤。
- 點上方綠色卡內的「🪢 截 rope」或「🌀 截 teleport」。
- 程式自動找到遊戲視窗並截圖，彈出「步驟 1/2」框選對話框。
- 用滑鼠拖曳紅色虛線框選範圍（可以框比實際稍大，下一步可微調）。
- 點「下一步：微調 ▶」進入「步驟 2/2」精修編輯器。
- 透過 4 條滑桿（上 / 下 / 左 / 右）或拖綠框 4 角微調，即時看到尺寸燈號。
- 確認尺寸燈號為綠色「✓ 完美」後，按「💾 儲存」。
- 圖片自動命名為
{資料夾}_{時間戳}.png並存到對應資料夾。
即時尺寸燈號
| 燈號 | 意義 | 建議 |
|---|---|---|
| 🟢 ✓ 完美 | 尺寸落在建議範圍內 | 可直接儲存 |
| 🟡 ~ 接近 | 尺寸接近建議範圍邊緣 | 仍可使用，建議再微調 |
| 🔴 ✗ 超出建議 | 尺寸明顯偏離建議範圍 | 請拖滑桿縮小或放大 |
rope/ 繩索 / 梯子模板
讓腳本辨識畫面上的「繩子」或「梯子」，才知道要往上爬。
- 建議尺寸：寬 3 – 9 px、高 72 – 112 px
- 繩子：截「中下段」一小截，不要從最頂端開始（從中間往下 1/3 ~ 1/2 處）。寬度只要繩子本身。
- 梯子：只截「半邊（左半或右半）」即可，不要整個梯子。同樣取中下段。
- 禁忌：不要包含角色、怪物、背景物件。同一張地圖可多截幾張不同位置增加穩定度。
teleport/ 地圖傳送點模板
用來辨識地圖上的「傳送點 / 隱藏傳點」。命中後腳本會自動走過去並觸發傳送，飛到地圖其他區域。
📌 目前內建：101 地圖（黃色箭頭傳點）。其他地圖需自行新增。
- 建議尺寸：寬 10 – 80 px、高 10 – 80 px
- 截法 A：截「傳送點本身的特徵」（黃色箭頭、發光光點、特殊地板紋路、傳送門圖示）。
- 截法 B：截「該區塊的固定背景」（牆面、地形等不會變化的部分）。
- 命名建議：
t{地圖名}_1.png（接續現有命名規則）
千萬不要截到會動的東西！角色、怪物、NPC、特效閃爍都會導致辨識不穩、誤觸發傳送，請務必只截「靜態」的部分。
儲存後是否需要重啟？
需要重啟「腳本」，但不需要重啟 UI。圖片只在腳本啟動時載入一次，新增 / 刪除的圖片不會即時生效。
正確流程：儲存圖片 → 按「停止」→ 按「開始」即可。
正確流程：儲存圖片 → 按「停止」→ 按「開始」即可。
警告圖片偵測（v3.2.0 新增）
把指定圖片丟進 assets/warning/ 資料夾，腳本執行時會背景掃描螢幕，命中任一張就發出 3 秒嗶嗶聲提醒。
常見用途：偵測 GM 訊息、特定字眼、警告圖示等，第一時間提醒使用者注意螢幕。
使用方式
- 切到 GUI 右側「🚨 警告偵測」頁籤。
- 點「📁 開啟警告圖片資料夾」按鈕，會自動開啟
assets/warning/。 - 把要偵測的圖片（PNG / JPG / BMP）丟進去。
- 按「開始」啟動腳本，警告偵測會自動載入並背景掃描。
- 命中時：連續 3 秒嗶嗶聲（1500Hz）+ console 顯示命中圖片名稱。
- 同一警告 10 秒內不重複響，避免狂叫。
截圖規範
- 解析度必須是 1280×720（與遊戲視窗一致）。
- 從遊戲畫面直接擷取，不要縮放、不要重新存檔。
- 只裁切關鍵特徵區域（如 GM 字樣、特定字眼、特殊圖示）。
- 避免裁切到會變動的元素（時鐘、HP 條、玩家名）。
- 圖片尺寸建議 30 – 200 px 寬，太小不穩定、太大反應慢。
數量建議
| 圖片數 | 對腳本影響 | 備註 |
|---|---|---|
| 1 – 5 張 | 幾乎零影響 | CPU < 1%，最佳區間 |
| 6 – 10 張 | 仍順暢 | CPU 約 1 – 2% |
| 10 張以上 | 建議刪減 | 每秒掃描可能變慢 |
注意事項
- 命中分數需 ≥ 0.7 才會觸發（與專案標準一致）。
- 若誤報太多 → 圖片裁更精準，或調高
WARNING_DETECTION_THRESHOLD。 - 若應該命中卻沒響 → 檢查 console 的
[警告偵測]分數。 - 響聲使用 Windows 系統 Beep，不需音效檔；確認系統音量沒有靜音。
- 資料夾為空時，腳本啟動會略過警告偵測，不會報錯。
- 新增圖片後需要重啟「腳本」（按停止再按開始），不需重啟 UI。
全局設定
影響腳本整體運行效能與停止條件的底層設定。
| GUI 欄位 | 預設值 | 說明 |
|---|---|---|
| DETECTION_INTERVAL | 0.01 秒 | 主迴圈的輪詢間隔（0.01 – 0.1 秒）。數值越小反應越快但 CPU 占用越高，建議維持預設 0.01。電腦效能較弱時可調高至 0.03 – 0.05。 |
| VIRTUAL_BOUNDARY_MARGIN | 150 px | 角色距螢幕邊緣多少像素時觸發虛擬邊界（50 – 500 px），自動往反方向移動，防止角色走至邊緣卡住。 |
| STOP_NO_MONSTER_TIMEOUT | 120.0 秒 | 連續多少秒沒有偵測到任何怪物時，腳本自動停止（10 – 300 秒）。適合偵測地圖清空或走錯地圖的情況。 |
| ENABLE_CLIFF_DETECTION | true | 偵測到地形高低差時自動跳躍，防止卡邊，建議保持開啟。 |
快捷鍵參考
程式全域快捷鍵，以及所有 KEY 欄位可填入的按鍵名稱。
程式全域快捷鍵
| 按鍵 | 功能 |
|---|---|
| F1 | 啟動腳本 |
| F2 | 停止腳本 |
KEY 欄位可用鍵名
在所有「KEY」類設定欄位中，點擊欄位後直接按鍵盤即可自動填入，或手動輸入以下鍵名：
字母
abcdefghijklmnopqrstuvwxyz
數字
0123456789
特殊按鍵
altctrlshiftspaceentertabesc
方向與導覽鍵
updownleftrighthomeendpageuppagedowninsertdeletebackspace
功能鍵
f3f4f5f6f7f8f9f10f11f12
F1 與 F2 為程式保留的啟動 / 停止快捷鍵，請避免將這兩個鍵設定為技能或攻擊按鍵。
常見問題
最常遇到的問題與解決方法。
啟動問題
| 問題 | 解決方式 |
|---|---|
| 程式無法啟動 | 確認程式資料夾放在全英文路徑，路徑中不可含有中文、空格或特殊符號。 |
| 「認證服務不可用」 | 伺服器可能在冷啟動（首次請求約需 30 秒），請稍候後再試一次。 |
| 序號驗證失敗 | 確認複製的序號完整，沒有多餘空格或換行符號。 |
| 序號已過期 | 請至購買頁面續購新方案，或透過 Discord 聯絡客服。 |
執行問題
| 問題 | 解決方式 |
|---|---|
| 找不到遊戲視窗 | 確認遊戲已開啟且使用視窗模式執行。 |
| 角色不動、不攻擊 | 1. 確認已下載並勾選目標怪物。 2. 確認已完成角色定位設置。 3. 查看 Log 頁籤的錯誤訊息。 |
| 補血 / 補魔沒反應 | 確認 HEALTH_MONITOR_HEAL_KEY / MP_KEY 與遊戲快捷鍵完全一致，且主開關已開啟。 |
| 被動技能沒自動施放 | 確認 ENABLE_PASSIVE_SKILLS（主開關）與對應技能的 ENABLE_PASSIVE_SKILL_X 均已開啟並保存。 |
| 繩子不攀爬 | 確認 ENABLE_ROPE_CLIMBING 已開啟，並嘗試調整 ROPE_MIN/MAX_DISTANCE 的數值範圍。 |
| 腳本自動停止 | 查看 Log 頁籤，確認是否為無怪物超時（STOP_NO_MONSTER_TIMEOUT）或死亡偵測觸發。 |
| CPU 使用率過高 | 將 DETECTION_INTERVAL 調高至 0.03，並將 HEALTH_MONITOR_FPS_LIMIT 降低至 5。 |
仍無法解決？
請優先透過 Discord 聯繫，回覆速度最快。