Artale GUI 操作手冊

Artale Script 完整使用說明

v2.4.0
序號驗證

本手冊僅供授權用戶閱覽。
請輸入您的啟動序號以繼續。

快速開始

從零開始下載、安裝並第一次啟動 Artale Script。

系統需求

最低配置

  • 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 固態硬碟
  • 穩定寬頻連線

安裝步驟

  1. 下載最新版 Artale Script 壓縮檔。
  2. 解壓縮至一個全英文路徑的資料夾，例如 C:\ArtaleScript。
  3. 確認遊戲 MapleStory Worlds - Artale（繁體中文版） 已開啟並以視窗模式執行。
  4. 在解壓縮後的資料夾中，雙擊 start_gui.bat 啟動程式。
  5. 在左側登入欄輸入您的啟動序號，按下登入即可開始使用。
重要：程式資料夾路徑不能包含中文、空格或特殊符號，這是最常見的啟動失敗原因。

教學影片

完整示範角色定位工具、怪物下載及基本參數設定流程，建議初次使用前先觀看。

序號啟動

啟動程式後需要輸入序號登入，才能使用所有功能。

登入步驟

  1. 啟動 start_gui.bat，程式主視窗開啟。
  2. 在左側面板找到「序號登入」欄位，將您的啟動序號（UUID）貼入。
  3. 按下「登入」按鈕，稍候片刻完成驗證。
  4. 左側狀態列顯示「已登入」後，即可啟動腳本。
每次啟動程式都需要連線驗證，請確保網路正常。序號有效期限請參考購買方案說明。

介面總覽

程式主視窗分為左側控制面板與右側功能頁籤兩大區域。

左側面板

區塊說明
序號登入輸入 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_MONITORtrue血量魔力監控的主開關，建議保持開啟。關閉後補血補魔功能完全停止。
HEALTH_MONITOR_HP_THRESHOLD0.5HP 觸發閾值（0.0 – 1.0）。0.5 表示 HP 低於 50% 時觸發補血。數值越大越早補血。
HEALTH_MONITOR_MP_THRESHOLD0.5MP 觸發閾值，邏輯同上。
HEALTH_MONITOR_HEAL_KEYpageup補血按鍵。點擊欄位後按下鍵盤按鍵即可自動填入，須與遊戲快捷鍵完全一致。
HEALTH_MONITOR_MP_KEYpagedown補魔按鍵，設定方式同上。
HEALTH_MONITOR_HEAL_COOLDOWN1.0 秒兩次補血之間的最短間隔（秒）。
HEALTH_MONITOR_MP_COOLDOWN1.0 秒兩次補魔之間的最短間隔（秒）。
HEALTH_MONITOR_FPS_LIMIT10血量偵測的截圖頻率（每秒幾次，1 – 60）。10 FPS 通常已足夠，數值過高會增加 CPU 負擔。
HEALTH_MONITOR_AUTO_DETECT_BARStrue自動偵測 HP / MP 條在畫面上的位置，通常保持開啟即可。
HEALTH_MONITOR_DEBUG_OUTPUTtrue在 Log 頁籤顯示血量偵測的即時數值，方便確認偵測是否正常，排查問題時開啟。

被動技能設定

設定需要定時施放的 Buff 或主動技能，程式依照冷卻時間自動按下對應按鍵。

主開關與隨機延遲

GUI 欄位預設值說明
ENABLE_PASSIVE_SKILLSfalse被動技能系統的主開關。必須開啟後，下方各技能設定才會生效。
PASSIVE_SKILL_RANDOM_DELAY_MIN1.0 秒每次技能施放前隨機等待的最短時間（秒）。加入隨機延遲使行為更自然，避免固定節奏。
PASSIVE_SKILL_RANDOM_DELAY_MAX5.0 秒每次技能施放前隨機等待的最長時間（秒），必須大於等於最短時間。

技能 1 – 4

每個技能欄位各有三個設定項，以技能 1 為例，其餘 2–4 依此類推：

GUI 欄位預設值說明
ENABLE_PASSIVE_SKILL_1false是否啟用技能 1 的自動施放。
PASSIVE_SKILL_1_KEY"1"技能 1 的按鍵，點擊後直接按鍵盤自動填入，須與遊戲快捷鍵一致。
PASSIVE_SKILL_1_COOLDOWN100.0 秒技能 1 的自動施放間隔（秒），建議設定略短於遊戲實際冷卻時間。
範例：Buff 技能綁在 5，遊戲冷卻 90 秒。
→ 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_DURATION0.1 秒按下攻擊鍵的持續時間（0.1 – 100.0 秒）。單次施放技能設短（0.1 秒），需要長按的技能或是怪物需攻擊較多下可調長該值。
ATTACK_COOLDOWN0.0 秒兩次攻擊觸發之間的最短等待時間（秒）。
ATTACK_RANGE_X600 px怪物偵測範圍半徑（像素）。怪物在此範圍內才觸發攻擊動作。

跳躍設定

GUI 欄位預設值說明
JUMP_KEY"alt"跳躍鍵，須與遊戲快捷鍵一致。
JUMP_ATTACK_MODE"original"攻擊前的跳躍方式：
original：先跳再攻擊（通用型）
mage：使用瞬移技能再攻擊（法師適用）
disabled：不跳，直接攻擊

副攻擊

GUI 欄位預設值說明
ENABLE_SECONDARY_ATTACKfalse啟用雙攻擊模式，程式依機率在主副攻擊鍵之間切換。
SECONDARY_ATTACK_KEY"c"副攻擊技能的按鍵。
PRIMARY_ATTACK_CHANCE1.0使用主攻擊的機率（0.0 – 1.0）。
SECONDARY_ATTACK_CHANCE0.0使用副攻擊的機率，兩者之和請設定為 1.0。

移動邏輯

設定角色在地圖上尋找怪物時的移動方式。

衝刺 / 瞬移移動

GUI 欄位預設值說明
ENABLE_DASH_MOVEMENTtrue啟用瞬移移動。法師職業開啟後機率性瞬移移動。
DASH_SKILL_KEY"x"瞬移技能的按鍵。
DASH_SKILL_COOLDOWN3.0 秒瞬移技能冷卻時間（秒）。
DASH_MOVEMENT_CHANCE0.7移動時使用瞬移的機率（0.0 – 1.0）。0.7 表示 70% 機率使用瞬移移動。

跳躍移動

GUI 欄位預設值說明
ENABLE_JUMP_MOVEMENTfalse啟用跳躍移動，在高差較多的地圖較高機率跳到各種平台上方。
JUMP_MOVEMENT_CHANCE0.2移動時跳躍的機率（0.0 – 1.0）。

下跳

GUI 欄位預設值說明
ENABLE_DOWN_JUMPfalse啟用隨機向下跳（下穿平台），適合多層地圖。
DOWN_JUMP_CHANCE1.0觸發下跳的機率（0.0 – 1.0）。
DOWN_JUMP_COOLDOWN30.0 秒兩次下跳之間的冷卻時間（秒）。

繩子攀爬

GUI 欄位預設值說明
ENABLE_ROPE_CLIMBINGtrue自動偵測並攀爬繩子，有多層平台的地圖建議開啟。
ROPE_MIN_DISTANCE65 px觸發攀爬的最小偵測距離（像素）。角色需在此距離內才會嘗試爬繩(該值針對無速度加乘之狀態設定，如有速度激發等加速效果請多次嘗試調高該值以提高爬繩成功機率)。
ROPE_MAX_DISTANCE80 px觸發攀爬的最大偵測距離（像素）(該值針對無速度加乘之狀態設定，如有速度激發等加速效果請多次嘗試調高該值以提高爬繩成功機率)。
ROPE_COOLDOWN_TIME60.0 秒兩次攀繩之間的冷卻時間（秒），避免反覆攀繩造成卡住。
ROPE_MAX_CLIMBING_DURATION15.0 秒單次攀繩的最長持續時間（1.0 – 20.0 秒），超過後自動鬆開繩子。
繩子圖片自訂：若啟用繩子攀爬後，角色仍無法正確偵測地圖上的繩子，請自行截圖遊戲中的繩子圖片，放入程式的 assets\rope 資料夾內，程式將自動載入辨識。

其他移動設定

GUI 欄位預設值說明
ENABLE_CLIFF_DETECTIONtrue偵測到地形高低差時自動跳躍，防止角色卡在高差邊緣，建議保持開啟。
ENABLE_TELEPORT_DETECTIONfalse自動偵測並使用傳送點，適合多傳點地圖(101)。
TELEPORT_COOLDOWN_TIME5.0 秒兩次使用傳送門之間的冷卻時間（秒）。
傳送點圖片自訂：若地圖含有傳送點且有使用需求，請自行截圖遊戲中的傳送點圖片，放入程式的 assets\teleport 資料夾內，程式將自動載入辨識。

定時休息

程式自動在「掛機打怪」與「進入自由市場休息」之間交替，模擬自然的遊戲行為。

運作流程

  1. 腳本啟動後進入掛機階段，持續時間在 FARMING_MIN 至 FARMING_MAX 之間隨機決定。
  2. 掛機時間到後自動移動至自由市場並停止攻擊，進入休息階段。
  3. 休息時間在 REST_MIN 至 REST_MAX 之間隨機決定，時間到後回到掛機地圖繼續打怪。
  4. 若啟用 ENABLE_STOP_AFTER_CYCLES，完成指定循環次數後腳本自動停止。

設定參數

GUI 欄位預設值說明
ENABLE_SCHEDULED_RESTfalse定時休息系統主開關，需手動開啟才會生效。
SCHEDULED_REST_FARMING_MIN40 分鐘每次掛機的最短時長（≥ 1 分鐘）。
SCHEDULED_REST_FARMING_MAX60 分鐘每次掛機的最長時長（必須 ≥ 最短時長）。
SCHEDULED_REST_REST_MIN8 分鐘每次休息的最短時長（≥ 1 分鐘）。
SCHEDULED_REST_REST_MAX15 分鐘每次休息的最長時長。
ENABLE_STOP_AFTER_CYCLESfalse完成 N 個掛機 / 休息循環後自動停止腳本。
SCHEDULED_REST_STOP_CYCLES5停止前要完成的循環次數（需搭配上方開關）。

紅點偵測

當其他玩家進入地圖（HUD 出現紅點警示）時，程式自動換頻道以規避干擾。

GUI 欄位預設值說明
ENABLE_RED_DOT_DETECTIONtrue紅點偵測主開關，建議保持開啟。
RED_DOT_MIN_TIME5.0 秒偵測到紅點後，等待最少幾秒才執行換頻，避免誤觸。
RED_DOT_MAX_TIME6.0 秒偵測到紅點後，等待最長幾秒才執行換頻。
程式自動選擇隨機頻道切換。

怪物設定

程式使用圖像模板匹配偵測怪物，必須先至'怪物搜尋'下載目標怪物的圖像模板，腳本才會進行攻擊。

未下載怪物模板時，腳本啟動後不會進行任何攻擊動作，請務必先完成此步驟。

下載怪物模板

  1. 在「配置設定」展開「怪物設置」區塊。
  2. 在'怪物搜尋'搜尋框輸入您要掛機的地圖上的怪物名稱（中文或英文均可），點擊「搜尋」。
  3. 從搜尋結果清單中勾選要偵測的怪物。
  4. 點擊「下載勾選怪物」，圖像模板將自動下載並儲存至 assets/monsters/ 資料夾。
  5. 下載完成後即可在'已下載'中啟用該怪物作為攻擊目標。
同一地圖若有多種怪物，建議全部勾選後一次下載，避免遺漏導致部分怪物無法被偵測(總圖片張數請控制<100張，避免延遲嚴重)。

角色定位設定

程式透過比對角色名稱下方的名稱來定位角色位置，每個配置檔都需要獨立擷取一次。

若未完成角色定位，或圖像辨識失敗，程式無法判斷移動方向，可能導致角色站在原地或亂走，請確保每個配置檔都完成此設置。

擷取步驟

  1. 確認遊戲視窗已開啟，角色在地圖上（非戰鬥狀態）。
  2. 在「角色定位設置」區塊，點擊「開始擷取角色 ID」按鈕。
  3. 程式自動截取目前遊戲畫面。
  4. 用滑鼠框選角色名稱正下方的 ID （文字名稱）。
  5. 確認框選範圍後，圖像自動儲存至 assets/player/medal_{配置檔名稱}.png。
  6. 設定區塊中會顯示擷取預覽，確認圖像清晰完整即完成設置。

相關設定

GUI 欄位預設值說明
ENABLE_RED_BAR_DETECTIONfalse改以 HP 血條輔助定位角色。若ID辨識率不佳（例如角色ID太小、顏色相近或地圖會遮擋），可開啟此選項(組隊血條辨識可能更容易被系統偵測腳本)。
建議在空曠場景且畫面無其他角色的情況下擷取，避免背景雜訊影響後續辨識精度。

全局設定

影響腳本整體運行效能與停止條件的底層設定。

GUI 欄位預設值說明
DETECTION_INTERVAL0.01 秒主迴圈的輪詢間隔（0.01 – 0.1 秒）。數值越小反應越快但 CPU 占用越高，建議維持預設 0.01。電腦效能較弱時可調高至 0.03 – 0.05。
VIRTUAL_BOUNDARY_MARGIN150 px角色距螢幕邊緣多少像素時觸發虛擬邊界（50 – 500 px），自動往反方向移動，防止角色走至邊緣卡住。
STOP_NO_MONSTER_TIMEOUT120.0 秒連續多少秒沒有偵測到任何怪物時，腳本自動停止（10 – 300 秒）。適合偵測地圖清空或走錯地圖的情況。
ENABLE_CLIFF_DETECTIONtrue偵測到地形高低差時自動跳躍，防止卡邊，建議保持開啟。

快捷鍵參考

程式全域快捷鍵，以及所有 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 技術支援 scrilabstaff@gmail.com

請優先透過 Discord 聯繫，回覆速度最快。