ResourcePackManager セットアップ

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

ResourcePackManager 2.xは、単一のユニバーサルjarとして配布されます。まったく同じ ResourcePackManager.jar が、Bukkit／Paperバックエンドと Velocity／BungeeCord／Waterfallプロキシの両方で動作し、実行中のローダーからプラットフォームを自動検出します。resourcepackmanager-velocity-*.jar / resourcepackmanager-bungee-*.jar という別々のファイルを展開する必要はもうありません。（このバックエンドが、一度もキーを付与していないプロキシの背後にあるとRSPMが検出した場合、プロキシへコピーしやすいように自身の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 を実行します。

これで基本的なセットアップは完了です。既定の設定では、RSPMはまずセルフホストを試み、何かおかしければ自動的にMagmaGuyのCDNにフォールバックします。

うまくいったかどうかは、コンソールの1行でわかります：

[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が外部プロセスである場合にのみ現れます。そのGeyserの extensions/ フォルダーに置くためのjarのコピーが入っています。

主要コマンド

• /rspm setup — ゲーム内のGUIセットアップメニューを開きます（プラグインの更新状況、推奨プラグイン、自動更新トグル、wiki・Discord・あなたのNightbreakアカウントトークンへのクリック可能なリンクを備えた情報ボタン）
• /rspm recommendedplugins — 共有のNightbreak推奨プラグインメニューを表示します
• /rspm downloadpluginupdate — 利用可能なResourcePackManagerの更新を次回の再起動用にダウンロードします
• /rspm downloadall — このプラグインが公開しているすべての利用可能な更新をダウンロードします（現時点ではResourcePackManagerの更新）
• /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 reload、/rspm status、/rspm verbose、/rspm itemsadder <configure|dismiss>、/rspm data_compliance_request には resourcepackmanager.* が必要です。

ItemsAdder

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

次を使用します：

/rspm itemsadder configure

このヘルパーは関連するItemsAdderの設定を更新し、ItemsAdderのパックを再生成し、その後ResourcePackManagerをリロードします。具体的には：

• 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を必要とします）
• /iareload、続いて /iazip をディスパッチします
• ItemsAdderがリロードと再生成を終える時間を確保するため、約15秒後にResourcePackManagerをリロードします

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

Bedrock / GeyserMC サポート

RSPMはマージされたJavaパックをGeyserMC向けのBedrockパックに自動変換します。変換はどのプラグインの1.21.4以降のアイテム定義パックでも処理でき、3Dの持ち物アイテム、カスタム防具、モデル付き装備に対応します（FreeMinecraftModelsだけではありません）。

bedrockConversionEnabled は既定で true のため、GeyserMCが入ったサーバーに新しくインストールすれば、そのまま動作します。

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

このサーバーにGeyser-Spigotがインストールされている場合、RSPMは自分自身をGeyser拡張として plugins/Geyser-Spigot/extensions/ にもインストールします。これがカスタムBedrockエンティティをアーマースタンドではなくきちんと描画させる仕組みです。使われるのは同じ ResourcePackManager.jar なので追加ダウンロードは不要ですが、有効化にはサーバーの再起動が1回必要です。RSPMがその拡張をインストール／ステージングしないようにするには、config.yml で geyserExtensionAutoInstall: false を設定してください。Geyser拡張とカスタムエンティティを参照してください。

完全なパイプライン、出力パス、表示オフセットの調整についてはBedrock／Geyser変換を参照してください。

セットアップの検証

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

• Plugin meta — バージョンとデプロイモード（standalone vs network-backend）。ネットワークバックエンドでは、秘密を含まない短いネットワークキーのフィンガープリントと、そのキーの出どころ（provided by the proxy ／ saved on this server ／ adopted from Floodgate's key ／ まだ未設定）も表示されます
• Java Pack — ミックス済みか、サイズ、SHA1の先頭
• Bedrock Pack — 変換済みか、マッピングの有無、変換がスキップされた場合の診断ヒント
• Hosting — どの配信経路が有効か（self-hosted／remote／まだ準備中）、クライアントが見るURL、解決された外部ホスト、自動検出された公開IP
• Proxy deployment — ネットワークプロキシ用jarが同じ ResourcePackManager.jar であることのリマインダー。ネットワークではそれをプロキシの plugins/ フォルダーにコピーします
• Integrations — Floodgate／Geyser-Spigotの検出状況、オンラインプレイヤー数

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

次に読むページ

• FAQ — よくある質問
• Bedrock／Geyser変換 — コンバーターの詳細と調整
• Geyser拡張とカスタムエンティティ — 拡張のインストールとGeyserのバージョン要件
• セルフホスト — 組み込みHTTPサーバー、ポート解決
• プロキシネットワーク — BungeeCord／Waterfall／Velocityを運用している場合
• API — コードからプラグインのパックを登録する