跳至主要内容

ResurrectionChest 設定與權限

權限​

權限用途預設值
resurrectionchest.use允許玩家註冊一個箱子，並把死亡掉落導向其中true
resurrectionchest.model.free允許玩家使用 FreeMinecraftModels 的免費箱子視覺模型true
resurrectionchest.model.premium允許玩家使用 FreeMinecraftModels 的進階箱子視覺模型op

resurrectionchest.use 是實際箱子行為最重要的權限。模型權限只會影響可選的視覺效果。

設定範圍​

config.yml 目前提供這些面向使用者的設定：

  • 告示牌觸發文字
  • 箱子建立、破壞、箱子遺失、死亡與移除訊息
  • 世界黑名單
  • storeXP
  • xpPercentageKept
  • 用於 FreeMinecraftModels 視覺模型的死亡箱子 nametag 文字
  • 免費與進階模型名稱設定
  • 粒子效果設定
  • 高相容模式
  • 耐久損耗設定

XP 處理​

當 storeXP 啟用時：

  • ResurrectionChest 會在玩家遊玩期間追蹤其目前的總 XP
  • 在死亡時儲存 追蹤到的總 XP * xpPercentageKept
  • 將掉落 XP 設為 0
  • 當擁有者下次開啟自己已註冊的箱子時返還儲存的 XP

重要例外：

  • 如果 keepInventory 啟用，ResurrectionChest 不會做任何事。
  • 如果 keepLevel 啟用，XP 儲存分支會提早結束，並保留原版的等級處理。

溢位處理​

如果箱子沒有空槽位容納某個物品：

  • 該物品會留在一般死亡掉落清單中
  • 玩家會收到箱子已滿的警告

FreeMinecraftModels 整合​

如果已安裝 FreeMinecraftModels，ResurrectionChest 可以在真實箱子上方生成一個視覺箱子 prop。

目前行為：

  • 如果玩家擁有 resurrectionchest.model.premium，會優先使用進階視覺模型
  • 否則，如果玩家擁有 resurrectionchest.model.free，就使用免費視覺模型
  • 視覺模型會依照箱子大小在單箱與雙箱版本之間切換
  • 真實箱子仍然是實際的儲存後端

如果缺少 FreeMinecraftModels，或模型無法生成，底層真實箱子仍然會正常運作。

由原始碼確認的注意事項​

目前原始碼也顯示有一些出現在 config.yml 中、但在這個 repo 其他地方看不出明確用途的設定項目：

  • 高相容模式
  • 耐久損耗設定
  • particleEffect1
  • particleEffect2

相較之下，particleEffect3 是目前程式碼裡有明顯實際使用痕跡的粒子設定。