跳至主要內容

ResourcePackManager 設定

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

ResourcePackManager 2.x 以單一通用 jar 形式發佈。完全相同的 ResourcePackManager.jar 可在 Bukkit/Paper 後端以及 Velocity / BungeeCord / Waterfall 代理上執行——它會依其執行所在的載入器自動偵測平台。不再有獨立的 resourcepackmanager-velocity-*.jar / resourcepackmanager-bungee-*.jar 檔案需要解壓。（若 RSPM 偵測到此後端位於某個從未為它配發金鑰的代理之後，它會在 plugins/ResourcePackManager/proxy-extension/ResourcePackManager.jar 預備一份自身 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. 啟動伺服器一次，讓設定檔、mixer、blueprint 與 output 資料夾自動產生。
  3. 決定你想要：
    • 自我託管（預設開啟）
    • MagmaGuy 的免費自動託管作為回退（預設開啟）
    • 強制用戶端接受
    • 在 mixer 資料夾中手動加入自訂資源包
  4. 修改設定或手動加入自訂資源包後，執行 /rspm reload。

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

你會從主控台的一行訊息知道它成功了：

[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 會將其壓縮，並以 ResourcePackManager 這個優先級條目納入合併，該條目位於預設 priorityOrder 的最上方。
blueprint/存放 RSPM 貢獻給合併的預設 pack.png 與 pack.mcmeta。編輯它們即可變更合併後資源包的圖示或其 pack.mcmeta 描述；此資料夾會在每次啟動時重新壓縮成 blueprint.zip。
output/完成的成品：ResourcePackManager_RSP.zip，以及 Bedrock 轉換有產出時的 ResourcePackManager_Bedrock.zip 與 rspm_geyser_mappings.json。
compatible_plugins/每個受支援的外掛整合各一個 YAML。
data_compliance//rspm data_compliance_request 寫入其下載內容的位置。
proxy-extension/只有在後端位於某個從未為它配發金鑰的代理之後時才會出現。內含一份執行中的 ResourcePackManager.jar 副本，供放到代理上。
geyser-extension/只有在 Floodgate 位於本機、但 Geyser 是外部行程時才會出現。內含一份 jar 副本，供放進該 Geyser 的 extensions/ 資料夾。

核心指令​

  • /rspm setup — 開啟一個遊戲內的 GUI 設定選單（外掛更新狀態、推薦外掛、自動更新切換，以及一個帶有可點擊連結的資訊按鈕，連往 wiki、Discord 與你的 Nightbreak 帳號 token）
  • /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 需要未壓縮、可解析的模型 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 偵測到代理模式（請參閱代理網路）。

若此伺服器上已安裝 Geyser-Spigot，RSPM 也會把自己安裝到 plugins/Geyser-Spigot/extensions/ 作為 Geyser 擴充功能，這正是讓自訂 Bedrock 實體得以渲染而非顯示為盔甲架的關鍵。它就是同一個 ResourcePackManager.jar——不需要額外下載——但需要重新啟動伺服器一次才會生效。在 config.yml 中設定 geyserExtensionAutoInstall: false 可讓 RSPM 停止安裝與預備該擴充功能。請參閱 Geyser 擴充功能與自訂實體。

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

驗證設定​

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

  • Plugin meta — 版本 + 佈署模式（獨立 vs 網路後端）。在網路後端上，它還會印出一段簡短、不含機密的網路金鑰指紋，以及該金鑰的來源（由代理提供 / 儲存在此伺服器上 / 從 Floodgate 金鑰衍生 / 尚未設定）。
  • Java Pack — 是否已混合、大小、SHA1 前綴
  • Bedrock Pack — 是否已轉換、對應檔是否存在；若略過轉換會附上診斷提示
  • Hosting — 目前啟用的交付路徑（自我託管 / 遠端 / 尚未就緒）、用戶端會看到的 URL、解析後的外部主機、自動偵測的公開 IP
  • Proxy deployment — 提醒你網路代理 jar 就是同一個 ResourcePackManager.jar；在網路上，將它複製到代理的 plugins/ 資料夾
  • Integrations — Floodgate / Geyser-Spigot 的偵測結果、線上玩家數

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

下一步​