RefScope は、Godot プロジェクトのファイルについて「どのファイルから参照されているか」と「そのファイルが何を読み込むか」を1つのドックで答えるアドオンです。移動・改名・削除の前に、参照が残らないかを確認できます。 ■ 導入 1. addons/refscope をプロジェクトへコピーします。 2. プロジェクト → プロジェクト設定 → プラグイン で「RefScope」を有効にします。 3. エディタ上部の「RefScope」タブを開きます。 ■ できること ・一覧から選ぶ、Godotのファイルシステムで選んでいるファイルを使う、パスを入力する、のいずれかで対象を決めます。 ・Referenced by は、そのファイル名を含むファイルを一覧し、パスではなくIDで指している参照には印を付けます。 ・References は、そのファイルが読み込むもの（シーン・リソースの依存、スクリプトが引用するパスやID）を一覧します。 ・Find text は、プロジェクト内のテキストを語句で検索し、その行を表示します。 ・結果をダブルクリックすると開きます。パスのコピーもできます。 ・ファイルを追加・改名・編集したあとは Rescan で一覧を作り直します。 ■ 移動したときにIDが効く理由 Godot の中でファイルを移動すると、エディタは参照を古いパスではなく内部IDへ書き換えます。古いパスを本文検索しても見つかりません。RefScope はそのIDも照合するので、移動を生き延びた参照も一覧に残り、ID一致として表示されます。 ■ 速度 プロジェクトの索引はエディタを止めないよう小さな単位で作られ、進捗が表示されます。1,408ファイルのプロジェクトで全体の走査は0.2秒弱、エディタが止まったのは1フレーム数ミリ秒まででした。 ■ 動作環境 Godot 4.4 以降（standard ビルド）。Windows 11 の Godot 4.4〜4.7 で確認しています。macOS と Linux は未確認です。プロジェクトを読むだけで、ファイルは変更しません。 ■ 制限 プロジェクト内のテキストファイル（GDScript・C#・シーン・リソースなど）を走査します。実行時に変数から組み立てる参照や、データの中に保存されたパスは見つかりません。「参照が見つからない」は「削除して安全」ではありません。8 MiB を超えるファイルは走査しません。非常に大きいプロジェクトでは最初の走査に時間がかかり、変更後は再走査が必要です。 ■ コマンドライン（任意） ビルド処理やコーディングエージェントから、エディタを開かずに同じ2つの問いを実行できます。参照が残っているときにチェックを失敗させることもできます。出力はJSON 1行です。具体的なコマンドは説明書にあります。 ■ 連絡先 onpont@gmail.com へ、Godot のバージョン・OS・導入したアドオンのバージョンを添えてご連絡ください。有料のサポート窓口はありません。