操作手冊 · v1.0.0 Beta

新楓之谷：經典版腳本操作手冊

18 個章節，從安裝到疑難排解，含每一個參數的預設值與可填範圍。輸入授權序號即可閱讀。

輸入授權序號

手冊僅供授權用戶閱讀。

還沒有序號？查看訂閱方案　·　回到產品介紹

快速開始

從解壓縮到角色開始自己打怪，大約十分鐘。

只有七個步驟。把下面這串跑完，腳本就會動了——其餘章節都是「想再調細一點」才需要看的。
還沒有序號？第 4 步改按「免費試用」就好，做法見免費試用。

七步上手

遊戲設定改成 1366 × 768 視窗模式。
把角色帶到你要練功的地圖，站好。
啟動腳本，看到「使用者帳戶控制」請按「是」。
左側輸入序號，按「登入」。
右邊切到「設定」→「角色定位設置」→ 擷取角色圖片。
「怪物設置」→ 搜尋並下載這張地圖的怪 → 回「已下載」勾起來。
「攻擊設置」填你的攻擊鍵、「血量與魔力配置」填補血補魔鍵 → 按右上角「保存設定」 → 按「開始(F1)」。

系統需求

項目	最低	建議
作業系統	Windows 10 64-bit	Windows 10 / 11 64-bit
處理器	Intel Core i5 或 AMD 同級	Intel Core i5 以上
記憶體	8 GB	16 GB 以上
硬碟	一般硬碟即可	SSD
網路	穩定連線（授權驗證用）	穩定寬頻

安裝

到下載中心下載程式壓縮檔。
解壓縮到全英文路徑的資料夾，例如 C:\ScrilabClassic。
先把《新楓之谷：經典版》開起來，登入到遊戲畫面。
執行主程式。會跳出使用者帳戶控制（UAC），請按「是」。

UAC 一定要按「是」。按了「否」的話，腳本會照常運行、日誌也一切正常，但角色完全不會動，而且不會出現任何錯誤訊息。這是最常見的「我的腳本壞了」。
不小心按到否的話：關掉程式重開，或直接對程式按右鍵 →「以系統管理員身分執行」。

遊戲端一定要先設好

項目	請設成
解析度	1366 × 768（這是必要條件，設錯腳本不會動作）
顯示模式	視窗模式
視窗位置	不要被其他視窗蓋住，也不要最小化
遊戲畫面	按下「開始」時要停在正常的遊戲畫面，不要在選角或載入畫面

免費試用

沒有序號也能先跑一輪，看看合不合用。

沒有序號也可以先跑跑看。不用付款、不用註冊、不用填 Email，打開程式按一顆按鈕就開始。

怎麼開始

先把遊戲設成 1366 × 768 視窗模式，角色帶到練功地圖站好（跟正式使用一樣，這兩件事不能省）。
啟動腳本，看到「使用者帳戶控制」按「是」。
左側面板「登入」按鈕旁邊就是「免費試用」，按下去。
狀態變成「訪客試用中」，下方會出現橘色的剩餘時間倒數。
按「開始(F1)」即可。程式會先幫你切到好上手的練功地圖。

試用能用什麼

跑的是同一套腳本——打怪、走位、爬繩、補血補魔、避人換頻、自動組隊、死亡與閒置自動停，全都在。

設定分頁也是開的：攻擊鍵、角色定位、移動邏輯、換設定檔，該調的都能調，跟正式使用一樣。

試用的限制

項目	說明
時間	一次大約 20 分鐘，實際以畫面上的倒數為準。時間到腳本會自動停止並登出。
次數	每台電腦每天一次。隔天會恢復。
怪物下載	「怪物設置」裡的「怪物搜尋」分頁不會出現，試用期間無法下載新的怪物圖片，請從「已下載」裡選程式已經備好的怪。
起始地圖	按下「免費試用」時，如果目前的設定檔不在下面這幾張之內，會自動幫你切一張過去：弓箭手村訓練場 I 弓箭手村訓練場 II 弓箭手村訓練場 III 弓箭手村東部草叢切過去之後你要自己換成別張也可以，只是角色定位與選怪要重做，二十分鐘可能有點趕。
名額	每天開放的試用份數有上限，額滿的話要等隔天。

中途關掉程式不會浪費。下次打開再按一次「免費試用」，會接續你還沒用完的時間。
不過時間本身不會暫停——這是「當天的一份試用」，不是「累積 20 分鐘的使用時數」。

試用結束之後

腳本會自動停止，並且登出回到未登入狀態。
想繼續用就到定價頁選一個方案，拿到序號之後改用「登入」。
明天還想再試一次也可以，按鈕會恢復。

按下「免費試用」卻被拒絕，通常是這台電腦今天已經試過、或當天名額發完了，兩種都是隔天恢復。其餘的錯誤訊息會直接顯示在畫面上。

序號登入

沒有登入就不能啟動腳本，也看不到設定分頁。

怎麼登入

啟動程式，主視窗左側就是「登入驗證」區。
把你的授權序號貼進「序號」欄位。輸入框是密碼模式，看不到內容是正常的。
想讓程式記住的話，勾選旁邊的「記住」。
按「登入」，等待驗證。
狀態變成綠色的「狀態: 已登入」就完成了，「開始(F1)」按鈕會同時解鎖。

登入之後看得到什麼

用戶：你的顯示名稱。
權限：腳本執行、配置修改。沒有「配置修改」權限時，設定分頁會顯示「您沒有修改配置的權限」；沒有「腳本執行」權限則無法按「開始」。
到期：授權到期日。
登入次數：累計登入次數。

幾條規則

狀況	結果
同一組序號在別台電腦登入	舊的連線會被中止。這是防止序號被共用的設計。
Artale 腳本與經典版腳本同時開	可以。兩者算不同的程式，各自維持一個連線。
執行中網路短暫斷線	不會馬上被踢，短時間內會自己恢復。
授權過期或被停用	會強制登出並跳出提示，腳本一併停止。

每次啟動都需要連線驗證，執行期間也需要保持網路暢通。

介面總覽

左邊控制、右邊調參數，就這兩塊。

主視窗結構。① 產品頁連結　② 序號登入與「記住」　③ 免費試用（不需序號，按下去會出現剩餘時間倒數）　④ 腳本狀態燈與啟停按鈕（等同 F1／F2）　⑤ 即時日誌　⑥ 設定分頁（登入後才會出現內容）　⑦ 底部狀態列。

左側面板

區塊	內容
Logo	點一下會開啟產品網頁。
登入驗證	序號輸入框、「記住」勾選，下面是並排的「登入」與「免費試用」兩顆按鈕，再下方顯示登入狀態與帳號資訊。試用中會多出一條橘色的剩餘時間倒數。
腳本控制	狀態指示燈、「開始(F1)」與「停止(F2)」按鈕、運行時間。兩顆按鈕分別等同鍵盤的 `F1` 與 `F2`。

右側分頁

分頁	內容
即時日誌	腳本每一步在做什麼都寫在這裡，出問題時第一個要看的地方。下方有「清空日誌」按鈕與「自動滾動」勾選。
設定	所有參數。必須先登入，否則只會顯示「請先登入以使用配置設定功能」。

底部狀態列

顯示目前的登入帳號與腳本狀態，掃一眼就知道現在是什麼情況。

設定分頁的組成

設定分頁：最上面是設定檔切換列，接著是控制列，下面九個區塊各自可以展開收合。改完任何一項都要按右上角的「保存設定」。

改完任何設定都要按右上角的「保存設定」。按下去會先跳出一個確認視窗，把你改了哪幾項列出來讓你核對，確認之後才真正寫入。沒按保存就直接啟動腳本，跑的還是舊設定。

設定檔管理

不同角色、不同地圖各存一份，切換一秒完成。

一個角色一份、一張地圖一份都可以。切換設定檔時，連角色圖片都會跟著換——這是它跟「一堆參數的組合」最大的差別。

基本操作

動作	怎麼做	說明
切換	設定檔列的下拉選單	切換後所有欄位會自動載入，但還沒生效——會出現黃色提醒，按「保存設定」才算套用。
新增	按「新增」	新設定檔的初始值是複製目前畫面上的值，角色圖片也會一起複製過去。
重命名	按「重命名」	角色圖片檔會跟著改名。「預設」不能重命名。
刪除	按「刪除」	會先問你一次。對應的角色圖片也會被刪掉。「預設」不能刪，也不能刪到一個都不剩。
保存	按「保存設定」	把目前畫面上的值寫進這個設定檔裡。

命名規則

不能是空白。
最多 50 個字。
不能包含 \ / : * ? " < > | 這些字元。
不能取名為 . 或 ..。
不能跟現有的設定檔同名，也不能叫「預設」（那是保留名稱）。
建議用地圖名或角色名，方便自己辨認。

建議的用法：一張常刷的地圖開一個設定檔。不同地圖要打的怪、要不要爬繩、要不要下跳差異很大，一組參數很難吃遍所有地圖。

切換設定檔之後如果角色定位怪怪的，回到「角色定位設置」重新擷取一次即可。

角色定位

先讓腳本認得你的角色，其他功能才會正常。

這是第一次使用時最重要的一步，沒做腳本不會動。要先讓腳本認得你的角色，它才知道要往哪邊走、往哪邊打。

框太大反而更容易失效——只要名字那一條就好。

操作步驟

確認遊戲正在執行、角色站在一個背景乾淨的位置（旁邊最好沒有怪物與其他玩家）。
在腳本的「設定」分頁展開「角色定位設置」。
按「開始擷取角色ID」。程式會自動把遊戲視窗叫到前景並截圖。
在跳出來的視窗裡，用滑鼠拖曳框選角色正下方的那條名字。
按「確認選擇」。看到「角色ID擷取成功！」就完成了。
建議重新啟動腳本（按停止再按開始），讓新的圖生效。

框選的訣竅

要	不要
只框名字那一條	把角色本體框進去（換裝就失效）
上下左右各留一點點邊	框得剛好貼齊字
背景單純的地方截	有怪物、其他玩家、特效的畫面
框選範圍大一點點	框太小（程式會擋下來要你重選）

面板上會顯示目前這個設定檔的角色圖片縮圖。狀態顯示「尚未設置角色ID」代表這個設定檔還沒截過，顯示「已載入現有角色ID」就是已經有了。

換了角色、改了名字、或角色外觀變了，就要重截一次。症狀通常是：腳本啟動之後角色只會原地小幅移動、或完全不攻擊。

怪物設定

先下載，再勾選——兩個步驟都要做。

怪物圖片不用自己截。程式內建下載器，打中文名字就能搜。

完整流程

展開「怪物設置」，切到「怪物搜尋」分頁。
在搜尋框輸入怪物的中文名字，例如「綠水靈」「豬」。清單一次顯示前 50 筆，搜尋越精準越好找。
把要打的怪勾起來。
確認「跳過死亡動畫」是勾選的（預設就是勾的）。
按「下載勾選怪物」，下方日誌會顯示進度。
下載完切回「已下載」分頁，把這次要打的怪勾起來。
按右上角「保存設定」。

「下載了」不等於「會去打」。下載只是把圖片存到硬碟，真正決定要打哪幾種的是「已下載」分頁裡的勾選。這兩步常被漏掉一步。

「已下載」分頁能做什麼

功能	說明
搜尋	在已下載的清單裡過濾，怪物一多的時候很有用。
全選 / 全不選	只會作用在目前有顯示出來的項目上。搭配搜尋可以做到「只全選某一類」。
刷新	重新掃描資料夾。手動丟圖片進去之後按這個。
清單顯示	格式是「中文名稱（資料夾名）- N 張圖片」。

選怪的建議

只勾這張地圖真的會出現的怪。勾越多，反應越慢。
如果某隻怪常常打不到，可以先只勾它，觀察日誌確認狀況。

怪物圖片存在 assets/monsters/ 底下，一種怪一個資料夾。直接搬資料夾就能在不同電腦之間帶著走。

攻擊設置

打哪一顆鍵、打多久、隔多久打一次、怪在上面要不要跳。

主攻擊

介面欄位	預設值	說明
主攻擊 · 按鍵 `ATTACK_KEY`	z	你在遊戲裡打怪用的那顆技能鍵。點一下欄位再直接按鍵盤就會填入，必須跟遊戲的快捷鍵完全一致。
主攻擊 · 機率 `PRIMARY_ATTACK_CHANCE`	1.0	每次出手用主攻擊的機率，範圍 0.0–1.0。沒有要用副攻擊的話就維持 1.0。
攻擊範圍 `ATTACK_RANGE_X`	400 px	怪物要進到這個橫向範圍內才會出手。技能打得遠可以調大，近距離職業調小比較不會空揮。必須大於 0。
攻擊持續時間 `ATTACK_HOLD_DURATION_MIN / MAX`	1.5 ~ 2.5 秒	按住攻擊鍵的時間，每次在這個區間內隨機取值。單發技能可以設短（例如 0.1 ~ 0.2），需要連續攻擊的設長。兩個值都必須在 0.1–100.0 之間。
攻擊冷卻 `ATTACK_COOLDOWN`	0 秒	兩次攻擊之間最少要等多久。0 代表不額外等待。不能是負數。

副攻擊（雙技能職業用）

介面欄位	預設值	說明
次攻擊 · 啟用 `ENABLE_SECONDARY_ATTACK`	關閉	打開之後才會依機率交替使用兩顆技能。
次攻擊 · 按鍵 `SECONDARY_ATTACK_KEY`	v	第二顆攻擊技能的按鍵。
次攻擊 · 機率 `SECONDARY_ATTACK_CHANCE`	0.0	範圍 0.0–1.0。建議與主攻擊機率加起來等於 1.0，例如 0.7 / 0.3。

跳躍攻擊

介面欄位	預設值	說明
跳躍攻擊 · 按鍵 `JUMP_KEY`	alt	遊戲裡的跳躍鍵。
跳躍攻擊 · 模式 `JUMP_ATTACK_MODE`	original	怪在上方平台時要怎麼處理： `original`　先跳起來再攻擊（通用） `mage`　用位移技能上去再攻擊（法師類） `disabled`　不跳，只打同一層的怪

選 mage 的話，記得到「移動邏輯配置」把「位移移動」的按鍵設好，兩邊用的是同一顆位移技能鍵。

在單層平坦地圖選 disabled 反而更順，不會為了打不到的怪一直亂跳。

移動邏輯

走位、跳躍、位移技能、下跳、爬繩、傳送點、防卡。

這一區的每一項都是獨立開關。地圖是平的就把爬繩、下跳關掉。

走位的花樣

介面欄位	預設值	說明
跳躍移動 · 啟用 `ENABLE_JUMP_MOVEMENT`	關閉	移動時偶爾用跳的代替走的。
跳躍移動 · 機率 `JUMP_MOVEMENT_CHANCE`	0.05	觸發機率，範圍 0.0–1.0。
位移移動 · 啟用 `ENABLE_DASH_MOVEMENT`	開啟	移動時使用位移／瞬移類技能。
位移移動 · 按鍵 `DASH_SKILL_KEY`	x	位移技能的按鍵。
位移移動 · 機率 `DASH_MOVEMENT_CHANCE`	0.7	觸發機率，範圍 0.0–1.0。沒有位移技能的職業請把「啟用」關掉。

隨機下跳

介面欄位	預設值	說明
隨機下跳 · 啟用 `ENABLE_DOWN_JUMP`	開啟	在多層平台地圖，偶爾從目前的平台往下跳到下一層。單層平坦地圖請關掉。
隨機下跳 · 機率 `DOWN_JUMP_CHANCE`	1.0	範圍 0.0–1.0。
隨機下跳 · 冷卻 `DOWN_JUMP_COOLDOWN`	5.0 秒	兩次下跳之間最少間隔幾秒。不能是負數。

爬繩與梯子

介面欄位	預設值	說明
爬繩功能 · 啟用 `ENABLE_ROPE_CLIMBING`	開啟	自動爬上畫面上的繩子與梯子。
距離 `ROPE_DISTANCE`	65 px	距離繩子多遠就起跳。爬不上去可以調大一點、跳過頭就調小。範圍 10–300。
冷卻 `ROPE_COOLDOWN_TIME`	60.0 秒	兩次爬繩之間最少間隔幾秒。不能是負數。
爬繩時間 `ROPE_MAX_CLIMBING_DURATION`	15.0 秒	爬超過這個時間就放棄，避免卡在繩子上。範圍 1.0–20.0。

你刷的地圖如果繩子樣式特別、腳本抓不到，可以自己補一張圖進去，做法見「自己補圖片」那一節。

傳送點

介面欄位	預設值	說明
傳送點 · 啟用 `ENABLE_TELEPORT_DETECTION`	開啟	自動使用地圖上的傳送點。地圖沒有傳送點的話開著也不影響。
傳送點 · 冷卻 `TELEPORT_COOLDOWN_TIME`	5.0 秒	兩次使用傳送點之間的間隔。不能是負數。

防卡功能

介面欄位	預設值	說明
防卡功能 `ENABLE_CLIFF_DETECTION`	開啟	角色遇到地形高低差時自動跳過去。地圖有高低差、或有開爬繩功能，就一定要打開，否則角色可能卡在斷層邊緣或繩子上原地不動。

血量與魔力

血少了自己吃紅，魔少了自己吃藍。

先確認你遊戲裡補血、補魔藥水放在哪一格快捷鍵，再把同一顆鍵填進來。兩邊不一致的話，腳本會按到別的東西。

介面欄位	預設值	說明
總開關 `ENABLE_HEALTH_MONITOR`	開啟	關掉之後補血補魔完全停止，掛久了很容易死。建議保持開啟。
閾值 · HP `HEALTH_MONITOR_HP_THRESHOLD`	0.5	血量低於這個比例就補。0.5 = 低於 50%。範圍 0.0–1.0，建議 0.4–0.6。
閾值 · MP `HEALTH_MONITOR_MP_THRESHOLD`	0.5	魔力低於這個比例就補。範圍 0.0–1.0，建議 0.3–0.5。
按鍵 · 補血 `HEALTH_MONITOR_HEAL_KEY`	pageup	補血藥水的快捷鍵。
按鍵 · 補藍 `HEALTH_MONITOR_MP_KEY`	pagedown	補魔藥水的快捷鍵。
冷卻 · 補血 `HEALTH_MONITOR_HEAL_COOLDOWN`	1.0 秒	兩次補血之間最少間隔幾秒，避免一次灌掉一整排藥水。不能是負數。
冷卻 · 補藍 `HEALTH_MONITOR_MP_COOLDOWN`	1.0 秒	同上。
強制補血（忽略冷卻） `HEALTH_MONITOR_FORCE_HEAL`	關閉	打開之後不管冷卻直接補。除非你的職業很脆，否則不建議開——藥水消耗會明顯變快。

掛機時把遊戲內的視窗都關掉（商店、背包、任務欄），畫面底部的血魔條不要被蓋住，補給才會正常運作。

被動技能

BUFF、召喚獸這類要定時補的技能，交給它。

這裡設定的是「需要定時按一下」的技能：BUFF、召喚獸、增益之類。

介面欄位	預設值	說明
總開關 `ENABLE_PASSIVE_SKILLS`	關閉	必須先打開，下面四個技能的設定才會生效。
技能 1 · 按鍵 `PASSIVE_SKILL_1_KEY`	1	技能的快捷鍵。
技能 1 · 冷卻 `PASSIVE_SKILL_1_COOLDOWN`	120.0 秒	每隔幾秒施放一次。建議設得比遊戲實際冷卻短一點，確保 BUFF 不會斷。技能 1 最小 0.1 秒，技能 2–4 最小 1.0 秒。
技能 1 · 啟用 `ENABLE_PASSIVE_SKILL_1`	關閉	單獨開關這一顆技能。
技能 2 / 3 / 4 `PASSIVE_SKILL_2~4_*`	同上	設定方式與技能 1 完全相同，預設按鍵分別是 2、3、4。
隨機延遲 `PASSIVE_SKILL_RANDOM_DELAY_MIN / MAX`	1 ~ 5 秒	冷卻結束之後再隨機等這個區間的時間才按下去，讓施放時機不要每次都一樣。兩個值都不能是負數。

設定範例：BUFF 綁在 5，遊戲冷卻 90 秒。
總開關打開 → 技能 1 啟用 → 按鍵填 5 → 冷卻填 85。
保存之後，腳本大約每 85–90 秒會補一次 BUFF。

總開關關著的話，就算個別技能勾了「啟用」也不會動。這是最常見的「為什麼我的 BUFF 沒放」。

紅點偵測與換頻

有人來搶怪，腳本自己換到別的頻道。

有其他玩家進到你的地圖、而且待著不走超過設定的時間，腳本就會自己換一個頻道，換完再把隊伍建回來。

介面欄位	預設值	說明
紅點偵測 · 啟用 `ENABLE_RED_DOT_DETECTION`	開啟	關掉之後不會換頻，有人來也會繼續打。
紅點偵測 · 最小 `RED_DOT_MIN_TIME`	20.0 秒	要待多久才算數（下限）。必須大於 0。
紅點偵測 · 最大 `RED_DOT_MAX_TIME`	50.0 秒	同上的上限。實際門檻會在最小與最大之間隨機取，不會每次都在同一個秒數換頻。必須大於 0。

設太短會很煩。只是路過的人也會被算成入侵，結果一直在換頻。20–50 秒是比較耐用的區間；真的很在意就往下調，但別調到 5 秒。

幾件要知道的事

換到哪一頻是隨機的，也不需要你設定要回哪個伺服器。
換頻完成後會自動重新建立隊伍。
換頻中途如果沒成功，會記在日誌裡，腳本不會亂點。
定時休息期間不會偵測，也不會換頻。

定時休息

掛久了會自己下線，休息完自己回來。

掛滿一段時間就自己下線休息，休息夠了再自己回到遊戲繼續。不是站在原地發呆。

介面欄位	預設值	說明
掛機 · 啟用 `ENABLE_SCHEDULED_REST`	關閉	打開才會有定時休息。
掛機 · 最小 / 最大 `SCHEDULED_REST_FARMING_MIN / MAX`	40 / 60 分鐘	每一輪掛機的時間會在這個區間內隨機取。兩個值都至少 1 分鐘。
休息 · 最小 / 最大 `SCHEDULED_REST_REST_MIN / MAX`	8 / 15 分鐘	每一輪休息的時間，一樣是隨機取。兩個值都至少 1 分鐘。
循環停止 · 啟用 `ENABLE_STOP_AFTER_CYCLES`	關閉	打開之後，跑滿指定的輪數就會自動停止腳本。
循環停止 · 次數 `SCHEDULED_REST_STOP_CYCLES`	5 次	跑幾輪「掛機＋休息」之後收工。至少 1 次。

休息結束後會回到你上次遊玩的那一隻角色。如果中途手動切換過角色，回來的會是切換後的那一隻——要跑一整晚的話，開始之前先確認角色是對的。

睡前的用法：打開定時休息 + 打開循環停止、設 5 次，大約跑 4–6 小時之後自己收工。
跑完最後一輪之後腳本會停在選擇角色畫面，不會再登入回遊戲——早上起來看到角色在選角畫面是正常的。

全局配置

三個影響整體行為的旋鈕。

介面欄位	預設值	說明
檢測間隔 `DETECTION_INTERVAL`	0.01 秒	數值越小反應越快、越吃 CPU。範圍 0.01–0.1，介面上的建議值是 0.03–0.05。電腦比較舊就往上調。
虛擬邊界 `VIRTUAL_BOUNDARY_MARGIN`	150 px	角色活動範圍距離畫面邊緣要留多少，避免走到地圖最邊緣卡住。範圍 50–500。地圖很窄就調小，很寬可以調大。
閒置超時 `STOP_NO_MONSTER_TIMEOUT`	90.0 秒	連續這麼久都沒怪可打就自動停止腳本。可填 10–300 秒，不想讓它太早停就往上調，最多 300。

閒置超時其實是保險絲。怪被別人清光、角色卡住、地圖切錯——這些情況都會讓它閒置。與其讓角色在原地站一整晚，不如停下來。

自動處理的事

不用你設定，但它會自己做的幾件事。

這些沒有出現在設定介面上，但腳本執行時會自己處理。知道它們存在，看日誌的時候才不會一頭霧水。

自動建立隊伍：啟動時與每次換頻完成之後，會自己開一個隊伍，避免被別人強制拉隊。已經在隊伍裡就跳過。
角色死亡自動停止：日誌會寫「停止條件觸發: 死亡檢測」。
閒置自動停止：長時間沒怪可打就停下來，日誌會寫「無怪物超時」。爬繩、傳送、定時休息期間不會誤觸發。
遊戲視窗跟隨：視窗被拖動之後會自動跟上，不用重開腳本。
截圖失敗提醒：連續抓不到畫面時會在日誌報錯，通常代表遊戲被最小化或被其他視窗蓋住了。
授權背景確認：定期確認授權還有效，被停用或在別台裝置登入時會強制登出並停止腳本。

腳本自己停下來的時候，左側狀態會變成「已停止」，原因寫在即時日誌裡。這是排查問題最快的入口。

自己補圖片

地圖的繩子或傳點抓不到時，自己補一張就好。

內建的繩子與傳送點圖片涵蓋了常見樣式。如果你刷的地圖比較特別、腳本爬不上去或看不到傳點，可以自己補一張進去。

先把圖截好

在遊戲裡按 Win + Shift + S，拖曳框選你要的範圍。
開「小畫家」，按 Ctrl + V 貼上。
用「選取」框出真正要保留的部分，按「裁剪」。
按 Ctrl + S 存成 PNG，檔名不要有中文與空白。

截圖時遊戲必須是 1366×768，而且過程中不要縮放、不要重新存檔。

繩子 / 梯子：放進 assets/rope/

繩子：截「中下段」一小截，不要從最頂端開始。寬度只要繩子本身，細細一條就好，高度大約一個角色高。
梯子：只截半邊（左半或右半）就好，不要整個梯子。同樣取中下段。
不要框到角色、怪物、背景物件。
同一張地圖可以多截幾張不同位置。

傳送點：放進 assets/teleport/

截傳送點本身的特徵（黃色箭頭、發光光點、特殊地板紋路），或是傳點所在位置的固定背景。
絕對不要截到會動的東西——角色、怪物、NPC、閃爍特效。
範圍盡量小、特徵越獨特越好。
檔名建議像 t地圖代號_1.png 這樣好認。

放完圖片要重啟腳本才會生效。正確做法：放圖片 → 按「停止」→ 按「開始」。不需要重開整個程式。

檔案與快捷鍵

東西放在哪、哪些可以自己搬。

快捷鍵

F1啟動腳本

F2停止腳本

兩顆快捷鍵在腳本視窗有焦點時都可以用，等同左側的「開始」「停止」按鈕。

檔案位置

路徑	內容	可以手動改嗎
`user_config.json`	所有設定檔的參數。	可以，但建議在介面上改。手改完要重開程式。
`.saved_uuid`	你勾了「記住」之後存下來的序號。	不建議手動改。要換序號在程式裡登出再重新登入即可。
`assets/player/`	各設定檔的角色圖片。	建議用「角色定位設置」重新擷取，不要手動替換。
`assets/monsters/`	怪物圖片，一種怪一個資料夾。	可以。整個資料夾複製到別台電腦就能沿用。
`assets/rope/`	繩子與梯子的圖片。	可以，見「自己補圖片」。
`assets/teleport/`	傳送點的圖片。	可以，見「自己補圖片」。

換電腦的話，把 user_config.json 與整個 assets/ 資料夾一起複製過去，設定與怪物圖都會跟著走。角色圖片建議在新電腦上重新擷取一次比較保險。

疑難排解

照症狀查，大部分問題五分鐘內能解決。

出問題先看「即時日誌」。腳本每一步在做什麼都寫在那裡，八成的問題看日誌就知道原因。

症狀	怎麼處理
腳本在跑，但角色完全不動	沒有以系統管理員權限執行。關掉程式重開，看到「使用者帳戶控制」按「是」；或直接對程式按右鍵 →「以系統管理員身分執行」。
腳本在跑，但什麼都不做	遊戲解析度不是 1366×768。到遊戲設定改成 1366×768 視窗模式，重新啟動腳本。
日誌出現「找不到遊戲視窗」	先把遊戲開起來、登入到正常的遊戲畫面，再按「開始」。
角色只會原地小幅移動、不攻擊	角色圖片沒截、截錯，或角色外觀改過了。到「角色定位設置」重新擷取一次，只框角色正下方那條名字，截完按停止再按開始。
日誌說「沒有載入到任何怪物模板」	「怪物設置」裡沒有勾選任何怪。到「怪物設置 → 已下載」把要打的怪勾起來，按「保存設定」。
程式打不開，或日誌出現 DLL load failed	電腦缺少 Microsoft Visual C++ 執行元件。安裝 `https://aka.ms/vs/17/release/vc_redist.x64.exe` 後重開程式。
補血補魔沒反應	介面上填的按鍵跟遊戲快捷鍵不一致，或畫面底部的血魔條被遊戲內的視窗蓋住了。對照快捷鍵重填一次，並把商店、背包等視窗關掉。
角色爬不上繩子	先調整「距離」（預設 65，範圍 10–300）；還是不行就自己補一張繩子圖，見「自己補圖片」。
角色卡在斷層或繩子上	到「移動邏輯配置」把「防卡功能」打開，保存後重啟腳本。
一直在換頻道	紅點偵測的秒數設太短。把「最小 / 最大」往上調，建議至少 20 / 50 秒。
換頻換到一半停住	手動把遊戲畫面弄回正常的遊戲中狀態，重新啟動腳本。如果經常發生，請把日誌貼到 Discord 回報。
腳本自己停了	通常是死亡或閒置太久觸發的保護。看即時日誌寫的停止原因；如果是誤判，可以調整「閒置超時」的秒數。
突然被登出，說「會話已失效」	同一組序號在別的裝置登入、授權到期，或網路中斷太久。重新登入即可。如果不是你自己在別處登入，請到 Discord 聯繫我們。
日誌一直說截圖失敗	遊戲視窗被最小化、被其他視窗蓋住，或螢幕關閉了。保持遊戲視窗在前景且完整可見。

還是沒解決？

到 Discord 回報，並附上這三樣東西，我們會處理得快很多：

即時日誌的內容（把出問題前後那一段複製起來）。
當時在哪張地圖、角色是什麼職業。
你的設定：哪些功能開著、關鍵參數填了什麼。