ZH AutoLoad

AutoLoad、巨集與腳本保存

Home · BASIC · UO API · A–Z · Examples · Languages

目錄規則

Autoload\
├─ autoload.sc
├─ MyCombat.inj
├─ Crafting.bas
└─ Scripts\
   ├─ Healer.sc
   └─ Hunter.sc

Autoload 頂層只放 AutoLoad 檔案與 Scripts 目錄。AutoLoad 支援 .sc、.inj、.bas、.txt，檔名可自訂。一般 IDE 腳本放在 Autoload\Scripts。

為角色選擇 AutoLoad

1. 開啟 Options → Basic IDE。
2. 在 AutoLoad 欄位選擇檔案。
3. 按 Apply。

選擇值以 YokoAutoloadFile 儲存在角色設定檔，每個角色可使用不同檔案；預設值是 autoload.sc。進入遊戲場景時，只會讀取選定檔案並啟動其中的 SUB Main()，其他頂層 AutoLoad 檔案不會自動開始。

若清單未顯示新檔案，確認副檔名受支援、檔案位於 Autoload 頂層，然後重新開啟或重新整理設定頁。

Basic Auto Load 巨集動作

在 Options → Macros → Classic 中加入 Basic Auto Load：

• 清單只讀取目前角色選定 AutoLoad 的 procedures；
• 選擇要執行的 procedure；
• 將巨集綁定按鍵或按鈕；
• 儲存設定檔；
• 按下綁定鍵後，由共用 Basic Runtime 執行該 procedure。

若角色切換到另一個 AutoLoad，procedure 清單也會隨之變更。不要把舊名稱 Basic Load 當成目前功能名稱。

Basic Example

Basic Example 是保存在一般巨集設定檔中的獨立完整腳本，不需要在 Autoload 建立另一個檔案。基本格式：

SUB Main()
    UO.Print('Example macro')
END SUB

使用方式：

1. 在巨集中加入 Basic Example；
2. 開啟編輯器；
3. 保留 SUB Main() 與 END SUB，在中間編寫命令；
4. 綁定按鍵；
5. 儲存角色的普通巨集設定；
6. 按下按鍵，由 Runtime 執行此腳本。

編輯器使用深色背景、明亮文字、可見 caret 與清楚的 selection。若整個編輯區看起來全黑，通常代表混用了舊 UI 檔案或主題資源。

IDE Save 行為

檔案來源	Save 目的地
新建、未命名檔案	Autoload\Scripts
已從磁碟開啟的檔案	原始完整路徑
Save All	所有已修改文件各自的目的地

IDE 不會自動把一般新檔案建立成頂層 AutoLoad。若要建立新 AutoLoad，請明確把檔案放在 Autoload 頂層，然後在 Options → Basic IDE 選擇它。

執行穩定性

Basic Auto Load 與 Basic Example 透過共用 Runtime 排程，不應在巨集按下時長時間阻塞遊戲執行緒。但腳本中的無限迴圈、密集搜尋或缺少 yielding 仍會使客戶端延遲。所有重複迴圈應加入合理的 UO.Wait(...)。

快速檢查

• AutoLoad 選擇在重新登入同一角色後仍保留；
• 不同角色可保存不同選擇；
• Basic Auto Load 只顯示選定檔案的 procedures；
• 綁定鍵確實執行所選 procedure；
• Basic Example 內容跟隨普通巨集設定檔保存；
• 新 IDE 檔案進入 Autoload\Scripts，已開啟檔案不會被另存到錯誤位置。