跳至主要内容

Resource Pack Manager 疑難排解

本頁僅涵蓋 ResourcePackManager 程式碼庫中目前已確認的行為。

玩家未收到資源包​

請先檢查以下內容：

  • 如果您希望 ResourcePackManager 自動傳送其託管的資源包，必須啟用 autoHost
  • 合併的資源包必須存在且已成功上傳
  • 玩家僅在加入時或在目前執行期間完成新上傳後接收資源包

如有需要：

  1. 執行 /rspm reload。
  2. 查看主控台輸出，檢查上傳或遠端伺服器錯誤。
  3. 重新載入完成後，用測試玩家重新加入。

如果您使用自託管而非自動託管，ResourcePackManager 不會為您推送自訂 URL。在該設定中，您仍然需要自己的伺服器端資源包分發流程。

ItemsAdder 已安裝，但其內容在最終資源包中缺失​

這通常意味著 ItemsAdder 的設定仍然阻止 ResourcePackManager 讀取或託管其輸出。

使用：

/rspm itemsadder configure

該指令目前會：

  • 啟用 resource-pack.hosting.no-host.enabled
  • 停用 protection_1、protection_2 和 protection_3
  • 執行 /iazip
  • 稍後重新載入 ResourcePackManager

如果指令提示 ItemsAdder 已在託管自己的資源包，請先手動停用 ItemsAdder 的託管，然後重新執行該指令。

合併的資源包無效或上傳失敗​

ResourcePackManager 的自動託管整合明確處理以下伺服器端錯誤類型：

  • 缺少必要檔案
  • 檔案過大
  • 檔案格式無效
  • 缺少會話
  • 遠端伺服器不可用

如果遇到以上情況：

  1. 執行 /rspm reload 重建資源包。
  2. 檢查是否有來源資源包格式錯誤、已加密或無法讀取。
  3. 檢查最終合併的資源包根目錄是否仍包含有效的 pack.mcmeta 和 pack.png。

外掛會跳過無法正常解壓的資源包，並在主控台記錄警告。

一個外掛的資源覆蓋了另一個外掛的資源​

這由以下檔案中的 priorityOrder 控制：

plugins/ResourcePackManager/config.yml

上方的條目優先於下方的條目。

對於不可合併的檔案，ResourcePackManager 替換低優先順序的檔案。對於可合併的 JSON 檔案，它會合併內容。目前可合併的 JSON 類別為：

  • sounds.json
  • 語言檔案
  • minecraft/models/item 中的原版物品模型 JSON
  • 圖集檔案
  • 字型檔案

如果您需要檢查上次合併期間發生了什麼，請查看：

plugins/ResourcePackManager/collision_log.txt

GUI 文字或基於字型的元素顯示異常​

字型檔案是 ResourcePackManager 合併的 JSON 類別之一，但這並不保證兩個不同的字型系統在 Minecraft 中能正常協同運作。

如果基於字型的選單或 HUD 顯示異常：

  1. 變更 priorityOrder，使您希望優先的資源包排在更高位置。
  2. 執行 /rspm reload。
  3. 檢查 collision_log.txt 確認衝突發生在預期位置。

資源包變更未立即顯示​

ResourcePackManager 有一個針對受支援資源包來源的監視器。

它等待已變更的資源包保持不變 3 秒，然後一旦所有被監視的資源包都穩定，重新合併會立即發生。

如果您正在積極重新產生另一個外掛的資源包，請在檔案寫入停止後等待幾秒鐘。如有疑問，請在上游外掛完成後執行 /rspm reload。

自動託管無法連線遠端伺服器​

ResourcePackManager 的內建主機與以下位址通訊：

https://magmaguy.com/rsp/

如果該連線失敗，外掛會記錄通訊警告，並在成功重新連線之前無法自動託管。

您的選擇是：

  1. 修復伺服器的出站 HTTPS 連線
  2. 等待遠端服務恢復可用
  3. 停用 autoHost 並改為自託管產生的 zip 檔案

我想自託管合併的資源包​

程式碼支援的設定是：

  1. 設定 autoHost: false。
  2. 如果您希望 ResourcePackManager 將額外副本寫入現有資料夾，請設定 resourcePackRerouting。
  3. 自行託管 ResourcePackManager_RSP.zip。

resourcePackRerouting 相對於 plugins 目錄解析，目標資料夾必須已經存在。

我需要檢查此伺服器儲存了哪些遠端資料​

使用：

/rspm data_compliance_request

如果自動託管有活躍的遠端會話，ResourcePackManager 會將回應下載到：

plugins/ResourcePackManager/data_compliance

如果沒有遠端會話，指令會報告沒有可請求的遠端資料。