跳至主要内容

ResourcePackManager 設定

本頁涵蓋單一伺服器（獨立）的設定方式。若你運行 BungeeCord / Waterfall / Velocity 網路，請改參閱代理網路——代理設定不同，且需要自己的 jar 檔。

建議的設定（獨立）​

  1. 將 ResourcePackManager.jar 放入伺服器的 plugins/ 資料夾。
  2. 啟動伺服器一次，讓設定檔、mixer、blueprint、output 與 proxy-extension 資料夾自動產生。
  3. 決定你想要：
    • 自我託管（預設開啟）
    • MagmaGuy 的免費自動託管作為回退（預設開啟）
    • 強制用戶端接受
    • 在 mixer 資料夾中手動加入自訂資源包
  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-unzip 下的 protection_1、protection_2 與 protection_3
  • 派發 /iazip
  • 在暫停 5 秒後重新載入 ResourcePackManager

若 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 extension jars — 內附的 Velocity/Bungee jar 路徑（即使在獨立伺服器上也會解壓——日後若加入代理會很方便）
  • Integrations — Floodgate / Geyser-Spigot 的偵測結果、線上玩家數

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

下一步​