トラブルシューティング

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

API Manual が空

1. client-without-yoko ではなく、フル版 client を使っていることを確認します。
2. ClassicUO.exe だけを別フォルダーへコピーして起動しないでください。
3. Basic IDE／API payload がフルクライアントの他ファイルと同じセットにあることを確認します。
4. IDE と ClassicUO を閉じ、フルクライアントのフォルダーから再起動します。
5. 古いアーカイブの IDE、extension、Runtime を現在のフォルダーへ上書きしないでください。
6. Output／Logs で Runtime metadata または local Theia host の読み込みエラーを確認します。

画面自体は開くのに API navigation が完全に空の場合、frontend は起動したが Runtime catalog を受信できていないことが多いです。

Run で launch.json が開く

Basic extension の Run Current Script、Start Script (SUB Main) / Run Without Debugging、Start Debugging を使ってください。一般の Theia／VS Code コマンドは、対応する debug configuration がない場合に launch.json を開くことがあります。

Already running: Main

Runtime が同じスクリプトの Main インスタンスを active として保持しています。Explorer で正しいスクリプトを選び Stop を実行します。UI 表示が古い場合は IDE を閉じて開き直し、実行中の ClassicUO Runtime から状態を再取得してください。停止前に同じ entry point を二重起動しないでください。

F10／F11 が動作しない

step command は debugger が実行可能な文で停止中の場合だけ使えます：

1. Start Debugging を実行；
2. F9 で breakpoint を置くか、最初の停止まで待つ；
3. F10、F11、Shift+F11 を使用。

スクリプトが完全に stopped の場合、selected script is not running は正常なメッセージです。

末尾までスクロールしないと実行できない

これは古いコンポーネントの不具合です。現在の文書は開くか変更した時点で全体が索引化されます。IDE、language extension、Runtime が同じフルクライアントから来ていることを確認してください。

緑または黄色の状態点がない

• Explorer で対象スクリプトを選択；
• Output で起動成功を確認；
• 状態の Reload／Refresh を実行；
• IDE が同じ ClassicUO インスタンスへ接続しているか確認；
• 2 つの別クライアントで同じ IDE payload を共有しない。

緑は running、黄は paused、黒／通常テーマ色は選択中かつ stopped です。

Basic コマンドでクライアントが一時停止する

• 長い loop に UO.Wait(...) を追加；
• 待機のない active infinite loop を削除；
• 各 iteration で大規模な同期検索をしない；
• 重い処理を yielding 可能な小さな段階へ分割；
• Macro、Runtime、IDE が同じクライアント一式であることを確認。

Basic Auto Load に procedure がない

• Options → Basic IDE で正しい AutoLoad を選び Apply；
• ファイルが Autoload 直下にあることを確認；
• 拡張子が .sc、.inj、.bas、.txt のいずれかを確認；
• procedure 構文が完全であることを確認；
• Macros ページを開き直して一覧を再読込。

フォントが黒くなる

Use original game/source color を有効にして Apply を押します。この設定はカスタムフォントでも元の動的 UO hue を維持します。改善しない場合は、古い font renderer や設定ファイルの混在を確認してください。

NPC／モンスターのキャスト表示がない

NPC/Monster の個別設定が有効、長さが 0 より大きい、位置と色が見える、対象が表示範囲内であることを確認します。サーバーが必要な speech、action code、animation を送らない場合は、すべての遠隔キャストを検出できません。

キャスト名がインジケーターから離れる

self／Other Player／NPC/Monster の同じグループ設定を使っているか、古い UI ファイルが混ざっていないかを確認します。文字は実際の glyph 幅で再測定され、バーの横に配置される必要があります。

Texture not found for sprite

現在の Ultima Online データに対象 sprite がないことを示します。クライアントは失敗結果を cache し、fallback を使います。重要なオブジェクトなら、ローカル client data とサーバーの互換性を確認してください。

FPS が既定値へ戻る

Apply 済みか、クライアントフォルダーに書き込み権限があるか、別フォルダーの設定を混ぜていないかを確認します。FPS はインストール全体の設定で、キャラクター変更では変化しない想定です。

Auto Open Doors が動かない

オプションが適用済み、ドアが作用距離内、サーバーが操作を許可していることを確認します。クライアントは移動前に具体的な door serial を使い、同じドアへの短時間の連続操作を制限します。

問い合わせ時に含める情報

• client と client-without-yoko のどちらか；
• 正確な再現手順；
• Output／Logs の関連エラー；
• アカウント、パスワード、非公開サーバー情報を除いた最小スクリプト；
• 常に発生するか、特定 shard／データだけか。