AssetRipper WikiUnityアセットの独立ガイド
日本語
トラブルシューティング

AssetRipper ファイルが読み込まれない: 状態別の確認手順

AssetRipper ファイルが読み込まれないと表示されても、選んだフォルダーが空なのか、選択階層が違うのか、読み込みが続いているのかはメッセージだけでは判断できません。まず処理状態を記録し、調査が許可されたUnityデータを一つ試してから、バージョンを変える前にログを保存します。

AssetRipper ファイルが読み込まれない: まず処理状態を確認

入力を選んだ後、処理が終了したのか、まだ進行中なのかを確認してください。終了後に「No files loaded」と表示された場合は、選択場所やデータの種類を調べます。画面の段階が変化している間は、フォルダーが空だとは限りません。再起動する前に状態を記録します。

問題が起きた工程を分けると、次の確認先が明確になります。フォルダー選択はデータ認識より前、読み取りエラーはファイルに到達した後、書き出し時のクラッシュは読み込み後です。それぞれ必要な証拠が異なるため、空の読み込みに書き出し対策を当てはめないでください。

表は診断結果ではなく、次の確認を選ぶための目安です。表示メッセージ、選択パス、小さな入力テストを合わせて見れば、フォルダー名や待ち時間だけで判断するより状況を整理しやすくなります。

見えている状態分かること次に確認すること
終了後に No files loaded と表示認識された結果が表示されていないパスを見直し、既知の入力を試す
処理が続いているアプリが作業中の可能性がある現在の段階を記録し、変化を確認する
assets ファイルの読み取りエラーファイルには到達したが読み取れなかった読み取りエラー用の案内を見てログを保存する
書き出し中にアプリが終了読み込み後の工程で問題が起きている書き出しの確認項目と使用リソースを記録する

選択したフォルダーと直下の内容を調べる

フォルダー名だけではAssetRipperが中身を認識できるか分かりません。最上位にランチャー、説明書、プラットフォーム別フォルダー、別のアーカイブがあり、Unityデータはさらに下にある場合があります。別のビルドを試す前に、選択場所の中身を確認してください。

一度に一つの階層をたどり、試したパスをメモします。Data、Content、StreamingAssetsといった名前は手がかりですが、すべてのプロジェクトに当てはまる決まった配置ではありません。調査する権限があるデータだけを使ってください。

下のイラストは、展開、起動、入力選択の一般的な流れを示します。実際の画面を撮影したものではなく、Unityの必須フォルダー構成を示すものでもありません。

01

選択したパスを記録する

選んだファイルやフォルダーと、その親フォルダーを控えます。公開報告ではアカウント名などの個人情報を除きます。

02

上下の階層を確認する

選択先にファイルがあるか、子フォルダーしかないかを見ます。データが子フォルダーにあれば、その場所を個別に試してください。

03

既知の入力を選ぶ

調査が許可されたUnityビルドから、種類を説明できる小さな入力を使います。画像、ランチャー、READMEが読み込み対象とは限りません。

04

選択だけを変える

より具体的なパスを選び、AssetRipperのビルドと出力設定はそのままにして繰り返します。

アーカイブの展開から書き出したファイルの確認までを示す、5段階の編集用イラスト
アーカイブから出力までの一般的な流れです。AssetRipperの実画面ではありません。

アーカイブを完全に展開し、関連ファイルをまとめて保つ

入力がZIPなどの圧縮ファイルに入っている場合は、ファイルを選ぶ前に展開します。ファイル管理画面で圧縮内容を見られても、アプリが元のアーカイブを指定されていることがあります。書き込み可能な場所に展開し、処理完了後に展開先を確認してください。

最初のテストでは近くにあるファイルを一緒に保ちます。ファイルの移動、補助データの改名、別ビルドの混在は、必要な対応関係を失わせることがあります。元データを保存し、やり直せる新しいコピーを使います。

展開エラーが出たり内容が不足して見えたりする場合は、許可された元データからコピーを作り直します。暗号化、アクセス制御、独自保護はフォルダー選択の問題ではありません。保護を回避してはいけません。

症状

ZIPや別の圧縮ファイルを選んでいる

考えられる原因: 必要なファイルが通常のフォルダーにまだ展開されていない可能性があります。

試すこと: 展開完了を待ってから、展開先のフォルダーを選びます。

症状

展開先に説明書、画像、ランチャーしかない

考えられる原因: Unityデータの保存場所ではない可能性があります。

試すこと: 子フォルダーを調べ、ビルドに含まれる許可済み入力を一つ試します。

  • 小さなテストが成功するまで元のアーカイブを変更しない。
  • 書き込み可能なローカルパスを使い、別ビルドのファイルを混ぜない。
  • 展開エラーとAssetRipperの読み込みメッセージを分けて記録する。

許可された既知の入力で条件をそろえて試す

大きなゲームやプロジェクトには、この確認に関係しないファイルが多数含まれることがあります。同じ入力元にある既知のUnityファイル、または小さなフォルダーから始めます。結果が出たら関連フォルダーや依存データを一つずつ足します。結果が出ない場合は入力を変えず、種類とログを先に確認します。

比較できるよう、AssetRipperのビルドと元データのコピーを保ち、空の出力フォルダーを使います。一度に一つの条件だけ変えてください。バージョン、パス、権限をまとめて変えると、どれが結果に影響したのか分からなくなります。

01

小さな基準入力を決める

内容を説明でき、調査の許可があるファイルか小さなフォルダーを選び、元データは変更しません。

02

空の出力先を用意する

空き容量があり書き込み可能な別フォルダーを選びます。途中までの出力は再利用しません。

03

状態が分かるまで観察する

処理終了、警告、継続中のどれかを記録します。入力ごとに共通の待ち時間はないため、状態とログの変化を見ます。

04

基準テストの後に範囲を広げる

成功したら関連データを一つ足します。失敗したら最小の再現入力を保管します。

ビルドやパスを変える前にログを保存する

再起動する前に、画面の正確なメッセージと関連するログ行を保存します。選択したファイルやフォルダー、処理が終了したか、段階が進んだかを記録してください。一時停止と完了後の空結果は別の観察です。

公式Issueには、古いAssetRipperで特定の読み込みがEditor Format Conversionの段階に留まった事例があります。これはその事例の説明であり、現在のバージョンにも同じ問題があることや、待ち続ければ必ず直ることを示しません。使用中のバージョン、入力、ログで比較してください。

基準を記録した後なら、別の公式ビルドとリリースノートを比較できます。不明な配布サイトから取得したり、読み込みのためにOSの保護機能を無効にしたりしないでください。

警告、データファイル、選択フォルダーを関連付けて示す編集用イラスト
複数の条件を変える前に、入力と実際に見えた状態を記録します。

役立つ安全なIssue報告を準備する

許可された小さな入力でもNo files loadedが続く場合は、他の人が再現できる情報をまとめます。AssetRipperのバージョンまたは配布チャンネル、OSとCPU構成、入力の種類、止まった工程、正確なメッセージ、短いログ抜粋を含め、期待した結果と実際の結果を説明してください。

再現用データは小さくし、個人情報を除きます。権利者のあるゲームデータ、アカウント情報、認証情報、個人パス、共有許可のないファイルは添付しないでください。入力を共有できない場合は種類と構造だけを説明し、追加で必要な証拠を保守担当者に確認します。

  • アプリのバージョンと配布チャンネル
  • OSとプロセッサ構成
  • ファイルまたはフォルダーの種類と選択階層
  • 処理が終了、停止、継続のどれだったか
  • 正確なメッセージ、関連ログ、小さなテスト結果
よくある質問

ファイルが読み込まれない場合の質問

AssetRipperでファイルが読み込まれないのはなぜですか?

選んだ場所に認識可能なUnityデータがない、入力がアーカイブ内に残っている、または処理が続いている可能性があります。ビルドを変える前に状態を確認し、許可された入力を一つ試してください。

ファイルとフォルダーのどちらを選べばよいですか?

入力元で案内されている手順に従い、選んだパスに目的のUnityデータがあることを確認します。広い親フォルダーで結果が出なければ、他の設定を変えずに具体的な子フォルダーを試します。

読み込みにはどのくらい待てばよいですか?

すべての入力に共通する待ち時間はありません。状態やログが変化するかを見ます。同じ段階から動かない場合は空結果と決めつけず、その状態を保存してください。

最新のAssetRipperなら解決しますか?

リリースノートを確認するか、同じ入力で比較するまでは修正されたと考えないでください。現在のビルドを記録し、公式の配布元から得たビルドを条件をそろえて試します。

暗号化または保護されたファイルを別のフォルダーから開けますか?

いいえ。フォルダーを変えても暗号化、DRM、アクセス制御、権限を回避できません。調査が許可されたデータだけを使い、保護でアクセスできない場合は停止します。

Issue報告には何を書けばよいですか?

バージョン、OS、入力の種類、フォルダー階層、正確なメッセージ、関連ログ、小さなテストの結果を記します。個人パスを削除し、共有できないデータは添付しません。