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

ResourcePackManager セットアップ

このページでは単一サーバー（スタンドアロン）構成のセットアップを扱います。BungeeCord／Velocityネットワークを運用している場合は、代わりにプロキシネットワークを参照してください。プロキシには同じ ResourcePackManager.jar をインストールしますが、独自の設定を生成し、プロキシ側の役割を果たします。

ResourcePackManager 2.xは単一のユニバーサルjarとして配布されます。同じ ResourcePackManager.jar がBukkit／Paperバックエンドと Velocity／BungeeCordプロキシで動作し、ローダーからプラットフォームを検出します。resourcepackmanager-velocity-*.jar / resourcepackmanager-bungee-*.jar を別々に展開する必要はありません。プロキシ配下のバックエンドに保存済みまたは初期導出されたネットワークキーがない場合、プロキシへコピーするため自身のjarを plugins/ResourcePackManager/proxy-extension/ResourcePackManager.jar に用意します。同じファイルを便利な場所に配置したものです。

バックエンドのプラグイン記述子はBukkit API 1.21.4 を宣言しているため、Bukkit／PaperサーバーはMinecraft 1.21.4以降である必要があります。同梱のGeyserカスタムエンティティ拡張はGeyser 2.11以降を対象としています。

  1. ResourcePackManager.jar をサーバーの plugins/ フォルダーに置きます。（これはVelocity／BungeeCordプロキシで使うのと同じjarです。プロキシ専用のjarはありません。）
  2. サーバーを一度起動して、設定ファイル、ミキサー、ブループリント、出力フォルダーを生成します。
  3. 以下を希望するかを決めます：
    • セルフホスト（既定：有効）
    • MagmaGuyの無料auto-hostフォールバック（既定：有効）
    • クライアントへの強制適用
    • ミキサーフォルダー内の手動カスタムパック
  4. 設定を変更した後や、手動でカスタムパックを追加した後は /rspm reload を実行します。

既定では検証付きセルフホストを先に試し、検証失敗または検証の利用不可ではmagmaguy.com経由のリモートホストへ切り替えます。両方の自動経路が失敗した場合、新しい配信URLは通知できません。セットアップ完了と判断する前に、最終状態とクライアントでのダウンロードを確認してください。

ホスティングが成功すると、コンソールに次のような行が表示されます：

[ResourcePackManager] Resource pack is live via self-hosting — http://play.example.com:25566/rspm.zip

RSPMは意図的にコンソールを静かに保ちます — 途中の手順ではなく結果だけを報告し、自力で回復できる状況について警告を出しません（セルフホストのプローブが失敗し、その後フォールバックが成功したのなら、それは障害ではなく成功です）。診断が必要な場合は、/rspm verbose on を実行する（または config.yml で verboseLogging: true に設定する）してからリロードしてください。トラブルシューティングを参照してください。

RSPMが生成するフォルダー​

plugins/ResourcePackManager/ の配下：

フォルダー用途
mixer/完成した .zip パックをここに置くとマージされます。priorityOrder では .zip を含む正確なファイル名で参照してください。
resource_pack/未圧縮のパック（assets/、pack.mcmeta などを含むフォルダーツリー）をここに置きます。RSPMがそれをzip化し、既定の priorityOrder の先頭にある ResourcePackManager の優先度エントリとしてマージします。
blueprint/RSPMがマージに提供する既定の pack.png と pack.mcmeta を保持します。マージされたパックのアイコンや pack.mcmeta の説明を変えたいときはこれらを編集してください。フォルダーは起動のたびに blueprint.zip へ再圧縮されます。
output/完成した成果物：ResourcePackManager_RSP.zip、およびBedrock変換が生成した場合の ResourcePackManager_Bedrock.zip と rspm_geyser_mappings.json。
compatible_plugins/サポートされているプラグイン統合ごとに1つのYAML。
data_compliance//rspm data_compliance_request がダウンロードを書き出す場所。
proxy-extension/プロキシ配下のバックエンドに保存済みまたは初期導出されたネットワークキーがない場合に作られます。プロキシへ置くための実行中の ResourcePackManager.jar のコピーを含みます。フォルダーが残っていても未連携のままとは限りません。
geyser-extension/拡張の自動インストールが有効で、FloodgateがローカルにありGeyser-Spigotがない場合にエクスポートされます。外部Geyserの extensions/ へコピーする際はコンソールの正確なパスに従ってください。update/ 内を指す場合もあります。このエクスポートは外部パック配信を設定しません。

主要コマンド​

  • /rspm setup — ゲーム内のGUIセットアップメニューを開きます（プラグインの更新状況、推奨プラグイン、自動更新トグル、wiki・Discord・あなたのNightbreakアカウントトークンへのクリック可能なリンクを備えた情報ボタン）
  • /rspm recommendedplugins — 共有のNightbreak推奨プラグインメニューを表示します
  • /rspm downloadpluginupdate — 利用可能なResourcePackManagerの更新を次回の再起動用にダウンロードします
  • /rspm downloadall — このプラグインが公開しているすべての利用可能な更新をダウンロードします（現時点ではResourcePackManagerの更新）
  • /rspm applypluginupdate — 共有のNightbreakコマンドセットによって登録されますが、RSPMは常に ResourcePackManager updates need a server restart: its Geyser extension only loads when Geyser starts. と表示して拒否します。ダウンロードした更新を適用するにはサーバーを再起動してください。
  • /rspm reload — プラグインの初期化を再開し、パック準備をスケジュールします。変更のないパックでは既存のホスティング登録を再利用できます
  • /rspm status — パックの状態、ホスティングモード、ネットワークキーのフィンガープリント、統合などの完全な診断ダンプを表示します
  • /rspm verbose [on|off] — config.yml を開かずに詳細な診断ログをオン／オフします。引数なしの場合はトグルします。選択は config.yml の verboseLogging に書き戻されるため、再起動をまたいで保持されます。エイリアスは /rspm verboselogging です。
  • /rspm itemsadder configure — RSPMによるホスティング向けにItemsAdderを自動設定します（後述）
  • /rspm itemsadder dismiss — あなたのプレイヤーUUIDに対してItemsAdderの警告を恒久的に非表示にします
  • /rspm data_compliance_request — このサーバー向けにリモートで保存されているデータをすべてダウンロードします

ルートコマンドは /resourcepackmanager で、エイリアスとして /rspm が使えます。上記の更新系コマンドと推奨プラグインのコマンドは、RSPMが登録する共有のMagmaCore／Nightbreakコマンドです。

権限：

  • /rspm setup と /rspm recommendedplugins には resourcepackmanager.setup が必要です。/rspm setup はインベントリGUIを開くためプレイヤー専用です。
  • /rspm downloadpluginupdate、/rspm downloadall、/rspm applypluginupdate、/rspm reload、/rspm status、/rspm verbose、/rspm itemsadder <configure|dismiss>、/rspm data_compliance_request には resourcepackmanager.* が必要です。

ItemsAdder​

現在推奨されるItemsAdderの手順は、もはや手動のみではありません。

次を使用します：

/rspm itemsadder configure

このヘルパーはItemsAdderの関連設定を更新してパック再生成を要求し、RSPMが新しいエクスポートをマージするのを待ちます。具体的には：

  • resource-pack.hosting.no-host.enabled: true に設定します
  • resource-pack.zip.protect-file-from-unzip の protection_1、protection_2、protection_3 を無効化します
  • resource-pack.zip.compress-json-files: false に設定します（RSPMはミキサーとBedrockコンバーターのために、未圧縮でパース可能なモデルJSONを必要とします）
  • 20サーバーティック後に /iareload、さらに100ティック後に /iazip を実行します
  • RSPMのウォッチドッグが再生成されたItemsAdderのエクスポートを検出してマージを完了するのを待ち、RSPM merged the regenerated ItemsAdder export. Use /rspm status to check hosting. と報告します。マージに失敗した場合は、エクスポートをマージできなかったことを報告し、RSPMが再試行します。

このヘルパーはResourcePackManagerをリロードしません。以前の設定処理がまだ保留中の間は開始を拒否し、編集中にItemsAdderの config.yml が変更された場合は保存せずに停止します。ItemsAdderが /iareload や /iazip を拒否した場合は、そのコマンドを手動で実行してください。マージのメッセージが確認するのはマージであってホスティングではありません。その後 /rspm status と実際のクライアントでのダウンロードを確認してください。

ItemsAdderが既に自前でパックをホストするよう設定されている場合（self-host、external-host、lobfileのいずれか）、ヘルパーは停止し、先に手動でItemsAdderのホスティングを無効化するよう案内します。

Bedrock / GeyserMC サポート​

RSPMは、マージされたJavaパック内の対応アセットをGeyserMC用Bedrockパックへ変換できます。任意のプラグインの1.21.4以降のアイテム定義を読み取り、対応する手持ち3Dアイテムや装備を処理します。ただし、すべてのモデルノード、条件、防具デザインの変換を保証するものではありません。下記の変換ガイドで対応範囲を確認してください。

bedrockConversionEnabled は既定で true です。変換にはBedrock対象の検出と対応する元アセットも必要で、起動時の登録には後述のGeyser再起動が必要な場合があります。

スタンドアロンサーバーでは、次のいずれかが真のときに変換が走ります：このサーバーにGeyser-Spigotがインストールされている、このサーバーにFloodgateがインストールされている、またはRSPMがプロキシモードを検出している（プロキシネットワークを参照）。

ローカルにGeyser-Spigotがあり geyserExtensionAutoInstall: true の場合、RSPMはユニバーサルjarを plugins/Geyser-Spigot/extensions/ にインストールまたは次回起動用に配置します。新しく配置した拡張を読み込むにはサーバーを再起動してください。カスタムBedrockエンティティには、対応する生成元がブリッジ経由でJavaエンティティを指定すること、定義の登録、正しいクライアントパックも必要です。geyserExtensionAutoInstall: false は今後の自動配置を止めますが、インストール済みjarを削除せず、配置済み更新も取り消しません。Geyser拡張とカスタムエンティティを参照してください。

完全なパイプライン、出力パス、手持ちアイテムのポーズについてはBedrock／Geyser変換を参照してください。

セットアップの検証​

公開HTTPSダウンロードアドレスを使う場合は自動ホストを有効に保ち、リバースプロキシの完全なパックURLを selfHostExternalUrl に指定します。リスナーと転送の設定はHTTPSとリバースプロキシを参照してください。

コンソールまたはOPとして /rspm status を実行します。出力は以下のセクションに分かれています：

  • プラグイン情報 — バージョンと配置モード（単体またはネットワークバックエンド）。ネットワークでは秘密を含まない短いキーのフィンガープリントと、その由来（プロキシから受信、サーバーに保存済み、Floodgateキーから導出、未設定）も表示します
  • Javaパック — マージ済みか、サイズ、SHA1の先頭
  • Bedrockパック — 変換済みか、マッピングの有無、変換を省略した場合の診断ヒント
  • ホスティング — 有効な配信経路（セルフホスト／リモート／準備中）、クライアント用URL、解決した外部ホスト、自動検出した公開IP、直近のセルフホストチェックの結果と、失敗した場合はその理由
  • プロキシへの配置 — 同じ ResourcePackManager.jar をネットワークのプロキシの plugins/ にコピーする旨の案内
  • 統合 — Floodgate／Geyser-Spigotの検出状況とオンラインプレイヤー数

配信URLが表示されたら実際のクライアントで参加し、パックを受け入れて既知のカスタムアイテムやモデルを確認してください。Bedrockではパック再構築後に再接続し、新しいマッピングやエンティティ定義の登録が必要な場合はGeyserを再起動します。状態表示とホスティングログが示すのは公開状態であり、クライアントでの描画ではありません。

何かおかしい場合はトラブルシューティングを参照してください。

次に読むページ​