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

ResourcePackManager セットアップ

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

ResourcePackManager 2.xは、単一のユニバーサルjarとして配布されます。まったく同じ ResourcePackManager.jar が、Bukkit／Paperバックエンドと Velocity／BungeeCord／Waterfallプロキシの両方で動作し、実行中のローダーからプラットフォームを自動検出します。resourcepackmanager-velocity-*.jar / resourcepackmanager-bungee-*.jar という別々のファイルや、どこかに展開・コピーするための同梱「プロキシ拡張」はもうありません。

推奨セットアップ（スタンドアロン）​

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

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

主要コマンド​

  • /rspm setup — ゲーム内のGUIセットアップメニューを開きます（プラグインの更新状況、推奨プラグイン、自動更新トグル、wiki・Discord・あなたのNightbreakアカウントトークンへのクリック可能なリンクを備えた情報ボタン）
  • /rspm reload — マージされたパックを再構築し、再ホストします
  • /rspm status — パックの状態、ホスティングモード、ネットワークキー、統合などの完全な診断ダンプを表示します
  • /rspm itemsadder configure — RSPMによるホスティング向けにItemsAdderを自動設定します（後述）
  • /rspm itemsadder dismiss — あなたのプレイヤーUUIDに対してItemsAdderの警告を恒久的に非表示にします
  • /rspm data_compliance_request — このサーバー向けにリモートで保存されているデータをすべてダウンロードします

ルートコマンドは /resourcepackmanager で、エイリアスとして /rspm が使えます。RSPMは、セットアップメニューがリンクする共有のMagmaCore／Nightbreakサブコマンド（例：/rspm recommendedplugins、/rspm downloadall）もいくつか継承しています。

権限：

  • /rspm setup には resourcepackmanager.setup が必要で、プレイヤー専用です（インベントリGUIを開くため、コンソールからは実行できません）。
  • /rspm reload、/rspm status、/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がプロキシモードを検出している（プロキシネットワークを参照）。

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

セットアップの検証​

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

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

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

次に読むページ​