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

ResourcePackManager セットアップ

このページでは単一サーバー(スタンドアロン)構成のセットアップを扱います。BungeeCord/Waterfall/Velocityネットワークを運用している場合は、代わりにプロキシネットワークを参照してください。プロキシのセットアップは別物で、専用のjarが必要になります。

推奨セットアップ(スタンドアロン)

  1. ResourcePackManager.jar をサーバーの plugins/ フォルダーに置きます。
  2. サーバーを一度起動して、設定ファイル、ミキサー、ブループリント、出力フォルダー、proxy-extensionフォルダーを生成します。
  3. 以下を希望するかを決めます:
    • セルフホスト(既定:有効)
    • MagmaGuyの無料auto-hostフォールバック(既定:有効)
    • クライアントへの強制適用
    • ミキサーフォルダー内の手動カスタムパック
  4. 設定を変更した後や、手動でカスタムパックを追加した後は /rspm reload を実行します。

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

主要コマンド

  • /rspm setup — 設定ファイルを直接編集するよう案内する一行メッセージを表示します(GUIメニューはありません)
  • /rspm reload — マージされたパックを再構築し、再ホストします
  • /rspm status — パックの状態、ホスティングモード、ネットワークキー、統合などの完全な診断ダンプを表示します
  • /rspm itemsadder configure — RSPMによるホスティング向けにItemsAdderを自動設定します(後述)
  • /rspm itemsadder dismiss — あなたのプレイヤーUUIDに対してItemsAdderの警告を恒久的に非表示にします
  • /rspm data_compliance_request — このサーバー向けにリモートで保存されているデータをすべてダウンロードします

ルートコマンドは /resourcepackmanager で、エイリアスとして /rspm が使えます。

権限:

  • /rspm setup には resourcepackmanager.setup が必要で、プレイヤー専用です(設定ファイルを指し示す一行メッセージを表示するだけです)。
  • /rspm reload/rspm status/rspm itemsadder <configure|dismiss>/rspm data_compliance_request はすべて resourcepackmanager.* が必要です。

ItemsAdder

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

次を使用します:

/rspm itemsadder configure

このヘルパーは関連するItemsAdderの設定を更新し、/iazip を実行し、その後ResourcePackManagerをリロードします。具体的には:

  • resource-pack.hosting.no-host.enabled: true に設定します
  • resource-pack.zip.protect-file-from-unzipprotection_1protection_2protection_3 を無効化します
  • /iazip をディスパッチします
  • 5秒の待機後に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 extension jars — 同梱されているVelocity/Bungee用jarのパス(スタンドアロンサーバーでも展開されます。後でプロキシを追加する場合に便利です)
  • Integrations — Floodgate/Geyser-Spigotの検出状況、オンラインプレイヤー数

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

次に読むページ