ZH Installation

安裝與第一次啟動

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

系統與資料需求

• Windows x64；
• 已完整解壓縮的發行壓縮檔；
• 合法取得的 Ultima Online 遊戲資料；
• 所選遊戲伺服器的位址、連接埠與有效帳號。

可執行客戶端是 Windows x64 NativeAOT 應用程式。一般執行客戶端不需要另外安裝 .NET SDK；只有從原始碼建置時才需要開發工具。

選擇套件版本

目錄	用途
client	含 Bad Newbie、Basic Runtime、Basic IDE 與 API Manual 的完整客戶端
client-without-yoko	僅含 Bad Newbie，不含 Basic 功能的客戶端
project	完整版本原始碼
project-without-yoko	不含 Basic 的原始碼
open-font-pack	可選用的開放授權字型
verification	建置、測試與封裝驗證資料

不要把兩個客戶端目錄混在一起，也不要用舊壓縮檔的 IDE、Runtime 或執行檔覆蓋新目錄。

安裝步驟

1. 將壓縮檔解壓縮到新的、可寫入的獨立資料夾。
2. 進入 client；若不需要 Basic，則進入 client-without-yoko。
3. 執行 ClassicUO.exe。
4. 如果程式要求遊戲資料路徑，選擇合法取得且與伺服器相容的 Ultima Online 資料目錄。
5. 設定伺服器、連接埠、帳號與角色設定檔。
6. 進入遊戲後開啟 Options，按需求設定 Bad Newbie；變更後按 Apply。

請把客戶端放在目前使用者可寫入的目錄。若放在受保護的系統資料夾，設定檔、FPS、AutoLoad 選擇或其他設定可能無法保存。

驗證下載內容

若發行頁同時提供 .sha256.txt，請比較 ZIP 的 SHA-256：

Get-FileHash .\ClassicUO-BadNewbie-BasicIDE.zip -Algorithm SHA256

計算值必須與同一發行項目提供的校驗值完全一致。不要使用來源不明或校驗失敗的壓縮檔。

完整版本的 Basic 第一次啟動

1. 開啟 Options → Basic IDE。
2. 在 AutoLoad 欄位選擇目前角色要使用的檔案。
3. 按 Apply。
4. 開啟 Basic IDE，建立或開啟腳本。
5. 確認腳本包含 SUB Main() 與 END SUB。
6. 使用 Run Current Script、Start Script (SUB Main) / Run Without Debugging 或 Start Debugging。

新建且尚未命名的 IDE 檔案在 Save 時會寫入 Autoload\Scripts；從磁碟開啟的檔案會存回原路徑。

更新前備份

更新客戶端前，請備份自己的：

• 角色設定檔與一般設定；
• Autoload 內自行建立的 AutoLoad 檔案；
• Autoload\Scripts；
• Fonts 中加入的 .ttf／.otf；
• 不含密碼等敏感資料的必要自訂內容。

建議把新發行版解壓到全新資料夾，再只匯入確定需要的個人資料。這可避免舊版元件或快取造成 API Manual 空白、狀態不同步及快捷鍵異常。

下一頁：Bad Newbie