メインコンテンツまでスキップ

Resource Pack Manager トラブルシューティング

このページは、ResourcePackManagerのコードベースで現在確認されている動作のみを扱います。

プレイヤーがリソースパックを受信しない​

まず以下を確認してください：

  • ResourcePackManagerがホストされたパックを自動送信するには、autoHost が有効である必要があります
  • マージされたパックが存在し、正常にアップロードされている必要があります
  • プレイヤーは参加時、または現在の実行中に新しいアップロードが完了した後にのみパックを受信します

必要に応じて：

  1. /rspm reload を実行します。
  2. アップロードまたはリモートサーバーのエラーがないかコンソール出力を確認します。
  3. リロード完了後にテストプレイヤーで再参加します。

オートホスティングの代わりにセルフホスティングを使用している場合、ResourcePackManagerはカスタムURLをプッシュしません。その設定では、独自のサーバーサイドパック配信フローが必要です。

ItemsAdderがインストールされているが、そのコンテンツが最終パックに含まれていない​

これは通常、ItemsAdderがResourcePackManagerがその出力を読み取ったりホストしたりできない設定のままであることを意味します。

以下を使用してください：

/rspm itemsadder configure

このコマンドは現在以下を行います：

  • resource-pack.hosting.no-host.enabled を有効化
  • protection_1、protection_2、protection_3 を無効化
  • /iazip を実行
  • その後すぐにResourcePackManagerをリロード

コマンドがItemsAdderがすでに独自のパックをホストしていると通知した場合、まずItemsAdderのホスティングを手動で無効にしてからコマンドを再実行してください。

マージされたパックが無効またはアップロードに失敗する​

ResourcePackManagerのオートホスト統合は、以下のサーバーサイドエラータイプを明示的に処理します：

  • 必要なファイルの欠落
  • ファイルが大きすぎる
  • 無効なファイル形式
  • セッションの欠落
  • リモートサーバーが利用不可

これらに遭遇した場合：

  1. /rspm reload を実行してパックを再構築します。
  2. ソースパックの1つが不正、暗号化、またはその他の理由で読み取れないかどうかを確認します。
  3. 最終的なマージパックのルートに有効な pack.mcmeta と pack.png がまだ含まれているか確認します。

プラグインは正常に抽出できないパックをスキップし、その場合はコンソールに警告をログします。

あるプラグインのアセットが別のプラグインのアセットを上書きしている​

これは以下の priorityOrder で制御されます：

plugins/ResourcePackManager/config.yml

上位のエントリが下位のエントリに優先します。

マージ不可能なファイルの場合、ResourcePackManagerは低優先度のファイルを置き換えます。マージ可能なJSONファイルの場合、代わりにコンテンツをマージします。現在マージ可能なJSONカテゴリは：

  • sounds.json
  • 言語ファイル
  • minecraft/models/item のバニラアイテムモデルJSON
  • アトラスファイル
  • フォントファイル

最後のマージで何が起こったかを調べる必要がある場合は、以下を確認してください：

plugins/ResourcePackManager/collision_log.txt

GUIテキストやフォントベースの要素がおかしく見える​

フォントファイルはResourcePackManagerがマージするJSONカテゴリの1つですが、2つの異なるフォントシステムがMinecraftでうまく動作することは保証されません。

フォント駆動のメニューやHUDがおかしく見える場合：

  1. 優先させたいパックが上位になるように priorityOrder を変更します。
  2. /rspm reload を実行します。
  3. collision_log.txt を確認して、期待した場所で衝突が発生したことを確認します。

リソースパックの変更がすぐに反映されない​

ResourcePackManagerにはサポートされているパックソース用のウォッチドッグがあります。

変更されたパックが3秒間変更されないままになるまで待ち、すべての監視対象パックが安定したらリミックスが即座に行われます。

別のプラグインのパックを積極的に再生成している場合は、ファイル書き込みが停止してから数秒待ってください。疑わしい場合は、アップストリームプラグインが完了した後に /rspm reload を実行してください。

オートホスティングがリモートサーバーに到達できない​

ResourcePackManagerの組み込みホストは以下と通信します：

https://magmaguy.com/rsp/

この接続が失敗すると、プラグインは通信警告をログし、正常に再接続するまでオートホストできません。

オプションは：

  1. サーバーの送信HTTPS接続を修正する
  2. リモートサービスが再び到達可能になるまで待つ
  3. autoHost を無効にして、生成されたZIPを代わりにセルフホストする

マージされたパックをセルフホストしたい​

コードでサポートされている設定は：

  1. autoHost: false に設定します。
  2. ResourcePackManagerに既存のフォルダへ追加コピーを書き込ませたい場合は resourcePackRerouting を設定します。
  3. ResourcePackManager_RSP.zip を自分でホストします。

resourcePackRerouting は plugins ディレクトリからの相対パスで解決され、対象フォルダはすでに存在している必要があります。

このサーバーに保存されているリモートデータを確認する必要がある​

以下を使用してください：

/rspm data_compliance_request

アクティブなリモートホスティングセッションがある場合、ResourcePackManagerはレスポンスを以下にダウンロードします：

plugins/ResourcePackManager/data_compliance

リモートセッションがない場合、コマンドはリクエストするリモートデータがないことを報告します。