Beneos FAQ - ブラックスクリーン / 「!」エラー
Foundry VTT でマップにブラックスクリーンや、大きな感嘆符付きの三角形が表示される場合、これはアセット(画像、動画、またはトークンファイル)を読み込めなかったことを示しています。
原因は何ですか?
この問題は、Foundry VTT が指定されたパスにあるファイルを見つけられない、またはアクセスできない場合に発生します。ほとんどの場合、問題はシーンそのものではなく、サーバー上の欠落した、またはアクセスできないアセットにあります。
-
参照先のファイルが手動で削除された
-
コンテンツが完全にインストールされていなかった
-
ダウンロードが中断された、または破損した
-
ファイルパスは存在するが、サーバーがファイルにアクセスまたは配信できない
多くの場合、ブラウザのコンソール(F12)を開いて、次のようなエラーを確認することで、これを判断できます:
404 (Not Found)
修正方法(ステップごと)
-
該当するコンテンツを削除
壊れたシーン、タイル、またはトークンを、Scene Browser または Actor ディレクトリから取り除きます。 -
コンテンツを再ダウンロード
Beneos Cloud または Moulinette からコンテンツを再度インストールします。
欠落しているコンテンツだけが再ダウンロードされます。 -
ワールドを再読み込み
再インストール後、すべての参照が更新されるよう Foundry VTT を再読み込みします。
問題が解決しない場合
同じアセットが繰り返し失敗する場合、原因は通常、ダウンロード速度ではなくダウンロードの品質に関係しています。
-
不安定な接続
大きな ZIP ファイル(特に WebM ファイルのようなアニメーションアセットを含むもの)は、伝送エラーの影響を受けやすいです。わずかなデータ破損でも、ファイル全体が壊れることがあります。 -
Wi-Fi の問題
無線接続は、パケットロスや不安定さが起きやすいです。
推奨される対応:
-
Wi-Fi の代わりに有線 LAN 接続を使う
-
該当するコンテンツを再ダウンロードする
同じシーンでまだ壊れていますか?
何度かクリーンにダウンロードしても、まったく同じシーンが一貫して失敗する場合、問題が私たちのパッケージングに起因している可能性がわずかにあります。
その場合:
-
問題を私たちに報告してください
-
該当するシーンの名前を含めてください
私たちが調査し、必要であれば修正します。
セルフホストのサーバー向け(VPS、Linux、AWS など)
Foundry VTT を自身のインフラで運用している場合、アセットの読み込み問題は、コンテンツそのものではなく、サーバーやネットワークの設定が原因であることがよくあります。
典型的な問題箇所は次のとおりです:
-
リバースプロキシの制限(nginx / Apache)
-
長いダウンロードでのタイムアウト
-
ブロックされた HTTP レンジリクエスト(大きなメディアファイルに必要)
-
TLS / HTTP2 の設定ミス
-
ファイアウォールまたはレート制限のルール
大きなアニメーションアセット(WebM ファイルなど)には次が必要です:
-
持続的接続のサポート
-
部分コンテンツ(HTTP 206)のサポート
-
長時間実行されるダウンロードを途中で終了させないこと
-
大きなバイナリファイルを過度にキャッシュまたは書き換えないこと
推奨されるトラブルシューティング:
-
失敗するアセットの URL を、
curlを使ってサーバー上で直接テストする -
拒否された、または中断された接続がないか、サーバーログを確認する
-
サイズ制限とタイムアウトについて、プロキシ設定を見直す
サーバーから直接アクセスしてもアセットが失敗する場合、問題はあなたのインフラ内にあり、そこで解決する必要があります。