Manual ZH - LIHACHTETAN/ClassicUO-BadNewbie-BasicIDE GitHub Wiki
ClassicUO — 繁體中文指南
Home · BASIC · UO API · A–Z · Examples · Languages
詳細指南
- 安裝與第一次啟動
- Bad Newbie 功能與設定
- Age of Power 概覽
- 伺服器主控台指令
- 任務
- 製作
- 資源
- Basic Runtime 與 IDE
- AutoLoad、巨集與腳本保存
- API Manual 與 Inspector
- 從原始碼建置與測試
- 疑難排解
關於此版本
ClassicUO - Bad Newbie & Basic IDE Edition 是非官方的 Windows x64 組建，整合 ClassicUO、Bad Newbie 進階設定、Basic IDE Runtime、獨立的 Eclipse Theia IDE 視窗，以及依目前 Runtime 實際註冊內容產生的 API Manual。
本套件不包含 Ultima Online 遊戲資料，也不是 Electronic Arts、Broadsword、Ultima Online 或 ClassicUO 團隊的官方產品。
套件內容
client— 含 Bad Newbie 與 Basic 的完整可執行客戶端；project— 完整版本原始碼；client-without-yoko— 僅含 Bad Newbie 的客戶端；project-without-yoko— 不含 Basic 的原始碼；open-font-pack— 可選用的開放授權字型；verification— 建置與測試報告。
安裝
- 將發行壓縮檔解壓縮到可寫入的獨立資料夾。
- 選擇
client或client-without-yoko。 - 執行
ClassicUO.exe。 - 依提示選擇合法取得的 Ultima Online 資料目錄。
- 設定伺服器與帳號。
請將壓縮檔的 SHA-256 與相鄰 .sha256.txt 檔案中的值比較。
Bad Newbie
開啟 Options → Bad Newbie，可設定：
- 視野距離與領地線；
- 最多增加五格繞路範圍的障礙迴避；
- 自己、其他玩家、NPC／怪物各自獨立的施法指示器；
0–200像素的指示條長度，0代表隱藏；- 介面、journal、chat、overhead、名稱、傷害、tooltip、hover 卡片與施法標籤的獨立字型、大小與顏色；
- 從
Fonts資料夾載入.ttf與.otf； - 支援角色、物品、backpack、巢狀容器、裝備與地圖 tile 的 hover 卡片；
- Info Bar、AutoLoot、AutoBuy 與 AutoSell。
啟用 Use original game/source color 後，更換字型仍會保留原本的動態 UO hue，不會讓文字變成黑色。
Hover 卡片只顯示客戶端確實可取得的資料，包括伺服器名稱、本機標籤、serial、graphic/body/tile ID、hue、數量、座標、container、layer 與收到的屬性。未傳送的隱藏伺服器數值不會被猜測。
Basic Runtime
Basic 的進入點：
SUB Main()
UO.Print('Basic 已啟動')
END SUB
檔案開啟或變更時會立即索引完整文件，不需要捲動到底部。多個腳本可以平行執行，並各自擁有 running、paused、stopped 與 debugging 狀態。
長時間迴圈中請使用 UO.Wait(...)，讓客戶端介面保持回應。
Basic IDE
IDE 使用 Eclipse Theia 與 Monaco，包含 Explorer、Editor、Outline、Problems、Output、Debug Console、API Inspector、Variables、Watch、Call Stack 與 API Manual。
狀態顏色：綠色—執行中，黃色—暫停，黑色／主題一般顏色—已選取且停止。
| 動作 | 按鍵 |
|---|---|
| 執行目前腳本 | F5 |
不偵錯啟動 SUB Main |
Ctrl+F5 |
| 開始偵錯 | F4 |
| 驗證語法 | F6 |
| 暫停／繼續 | F7 |
| Continue | F8 |
| 切換 breakpoint | F9 |
| Step Over | F10 |
| Step Into | F11 |
| Step Out | Shift+F11 |
| 停止 | Shift+F5 |
| 重新啟動偵錯 | Ctrl+Shift+F5 |
| 顯示游標符號文件 | Ctrl+F1 |
逐步命令只有在偵錯器停在指令時才能使用，目前執行列會被醒目顯示。
AutoLoad 與巨集
AutoLoad 檔案直接放在 Autoload，一般腳本放在 Autoload\Scripts。支援 .sc、.inj、.bas 與 .txt。
在 Options → Basic IDE 選擇目前檔案；每個角色會分別保存此設定。進入遊戲場景時，只會啟動所選 AutoLoad 的 SUB Main()。
在 Options → Macros → Classic：
- Basic Auto Load 會列出所選 AutoLoad 的程序，並可綁定按鍵；
- Basic Example 會把完整的
SUB Main() ... END SUB腳本保存在一般巨集設定檔中。
IDE 的新未命名檔案會存到 Autoload\Scripts；已開啟的檔案會存回原始路徑。
API Manual
Runtime 註冊是唯一可信來源。Manual 顯示實際簽章、參數、預設值、回傳／效果、允許值、資料路徑與有效的 Basic 範例。使用者自訂的 SUB 與 FUNCTION 只顯示在 Outline。
API 稽核結果：遺漏、未註冊、無效簽章、重複項目與無效範例皆為 0。
快速疑難排解
- API Manual 空白：確認使用完整
client，且沒有覆蓋舊版 IDE 檔案。 Already running: Main：重新啟動前先停止既有執行個體。- F10/F11 無法使用：先啟動 Debug，並在 breakpoint 停下。
- 客戶端暫停回應：在迴圈中加入
UO.Wait(...)。 - NPC 指示器未出現：檢查 NPC/Monster 選項、非零長度、視野與伺服器事件。
使用自動化前請確認遊戲伺服器規則。請勿公開帳號密碼、私人設定檔、日誌或受保護的遊戲資料。