跳至主要內容

ResourcePackManager 設定

本頁涵蓋單一伺服器（獨立）的設定方式。若你運行 BungeeCord / Waterfall / Velocity 網路，請改參閱代理網路——你會在代理上安裝同一個 ResourcePackManager.jar，但它會產生自己的設定並扮演代理端的角色。

ResourcePackManager 2.x 以單一通用 jar 形式發佈。完全相同的 ResourcePackManager.jar 可在 Bukkit/Paper 後端以及 Velocity / BungeeCord / Waterfall 代理上執行——它會依其執行所在的載入器自動偵測平台。不再有獨立的 resourcepackmanager-velocity-*.jar / resourcepackmanager-bungee-*.jar 檔案，也不再有需要解壓並複製到任何地方的內附「proxy extension」。

建議的設定（獨立）​

  1. 將 ResourcePackManager.jar 放入伺服器的 plugins/ 資料夾。（這與你在 Velocity / BungeeCord 代理上會使用的是同一個 jar——沒有獨立的代理 jar。）
  2. 啟動伺服器一次，讓設定檔、mixer、blueprint 與 output 資料夾自動產生。
  3. 決定你想要：
    • 自我託管（預設開啟）
    • MagmaGuy 的免費自動託管作為回退（預設開啟）
    • 強制用戶端接受
    • 在 mixer 資料夾中手動加入自訂資源包
  4. 修改設定或手動加入自訂資源包後，執行 /rspm reload。

順利情況下就這樣即可。在預設設定下，RSPM 會先嘗試自我託管，若有任何異常便會自動回退至 MagmaGuy 的 CDN。

核心指令​

  • /rspm setup — 開啟一個遊戲內的 GUI 設定選單（外掛更新狀態、推薦外掛、自動更新切換，以及一個帶有可點擊連結的資訊按鈕，連往 wiki、Discord 與你的 Nightbreak 帳號 token）
  • /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 需要未壓縮、可解析的模型 JSON 供混合器與 Bedrock 轉換器使用）
  • 派發 /iareload，然後 /iazip
  • 約 15 秒後重新載入 ResourcePackManager，讓 ItemsAdder 有時間重新載入並重新產生

若 ItemsAdder 已被設定為託管自己的資源包（自我託管、外部託管或 lobfile），輔助工具會停止，並提示你先手動停用 ItemsAdder 託管。

Bedrock / GeyserMC 支援​

RSPM 會自動將合併後的 Java 資源包轉換為適用於 GeyserMC 的 Bedrock 資源包。轉換支援任何外掛的 1.21.4+ 物品定義資源包——不再僅限於 FreeMinecraftModels——包括 3D 手持物品、自訂盔甲與模型裝備。

bedrockConversionEnabled 預設為 true，因此在已安裝 GeyserMC 的伺服器上全新安裝即可直接運作。

對於獨立伺服器，當下列任一條件成立時轉換便會啟動：此伺服器上已安裝 Geyser-Spigot、此伺服器上已安裝 Floodgate，或 RSPM 偵測到代理模式（請參閱代理網路）。

完整管線、輸出路徑及顯示偏移調整，請參閱 Bedrock / Geyser 轉換。

驗證設定​

在主控台或以 OP 身份執行 /rspm status。輸出分為以下幾個區塊：

  • Plugin meta — 版本 + 佈署模式（獨立 vs 網路後端）
  • Java Pack — 是否已混合、大小、SHA1 前綴
  • Bedrock Pack — 是否已轉換、對應檔是否存在；若略過轉換會附上診斷提示
  • Hosting — 目前啟用的交付路徑（自我託管 / 遠端 / 尚未就緒）、用戶端會看到的 URL、解析後的外部主機、自動偵測的公開 IP
  • Proxy deployment — 提醒你網路代理 jar 就是同一個 ResourcePackManager.jar；在網路上，將它複製到代理的 plugins/ 資料夾
  • Integrations — Floodgate / Geyser-Spigot 的偵測結果、線上玩家數

若有任何問題，請參閱疑難排解。

下一步​