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 — Basic を含む実行可能なフルクライアント；
• project — フル版のソースコード；
• client-without-yoko — Bad Newbie のみのクライアント；
• project-without-yoko — Basic を含まないソースコード；
• open-font-pack — オープンライセンスの任意フォント；
• verification — ビルドおよびテスト報告。

インストール

1. リリースアーカイブを、書き込み可能な別フォルダーへ展開します。
2. client または client-without-yoko を選びます。
3. ClassicUO.exe を起動します。
4. 正規に入手した Ultima Online データフォルダーを指定します。
5. サーバーとアカウントを設定します。

ZIP の SHA-256 を、隣接する .sha256.txt ファイルの値と比較してください。

Bad Newbie

Options → Bad Newbie を開きます。主な機能：

• 表示距離と領域ライン；
• 最大 5 タイルの追加経路を使う障害物回避；
• 自分、他プレイヤー、NPC／モンスターごとのキャスト表示；
• 0–200 ピクセルのバー長。0 は非表示；
• UI、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 started')
END SUB

ファイルを開くか変更すると文書全体がすぐに索引化されます。末尾までスクロールする必要はありません。複数スクリプトを並列実行でき、それぞれ独立した状態を持ちます。

長いループでは UO.Wait(...) を使用し、クライアント UI に制御を戻してください。

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
カーソル位置の API 文書	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 設定、長さ、表示距離、サーバーイベントを確認してください。

自動化を使用する前にサーバールールを確認してください。認証情報、個人プロファイル、ログ、保護されたゲームデータを公開しないでください。