跳至主要内容

ResurrectionChest 設定檔和權限

權限​

權限用途預設值
resurrectionchest.use允許玩家註冊箱子並將死亡掉落物路由到其中true
resurrectionchest.model.free允許玩家使用免費的 FreeMinecraftModels 箱子視覺效果true
resurrectionchest.model.premium允許玩家使用進階的 FreeMinecraftModels 箱子視覺效果op

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

設定項​

config.yml 目前公開以下面向使用者的設定：

  • 告示牌觸發文字
  • 箱子建立、銷毀、箱子缺失、死亡和移除訊息
  • 世界黑名單
  • storeXP
  • xpPercentageKept
  • FreeMinecraftModels 視覺效果的死亡箱子名稱標籤文字
  • 免費和進階模型名稱設定
  • 粒子效果設定
  • enableParticleEffects（boolean）— 啟用或停用死亡箱子上的粒子效果
  • deathChestRemovedMessage（string）— 死亡箱子被移除時顯示的訊息
  • 高相容性模式
  • 耐久度損失設定

經驗值處理​

當 storeXP 啟用時：

  • ResurrectionChest 在遊戲過程中追蹤玩家目前的總經驗值
  • 死亡時，儲存 追蹤的總經驗值 * xpPercentageKept
  • 將掉落的經驗值設定為 0
  • 當擁有者下次打開註冊箱子時歸還儲存的經驗值

重要例外：

  • 如果 keepInventory 處於啟用狀態，ResurrectionChest 不做任何事。
  • 如果 keepLevel 處於啟用狀態，經驗值儲存分支提前退出，並保持原版等級處理不變。

溢出處理​

如果箱子沒有空閒槽位放置物品：

  • 該物品留在正常的死亡掉落列表中
  • 玩家收到箱子已滿的警告

FreeMinecraftModels 整合​

如果安裝了 FreeMinecraftModels，ResurrectionChest 可以在真實箱子上方生成視覺箱子模型。

目前行為：

  • 當玩家擁有 resurrectionchest.model.premium 時，優先使用進階視覺效果
  • 否則，當玩家擁有 resurrectionchest.model.free 時，使用免費視覺效果
  • 視覺模型根據箱子大小在單箱和雙箱變體之間切換
  • 真實箱子仍然是儲存後端

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

基於原始碼的注意事項​

目前原始碼還顯示了一些在 config.yml 中公開但在此儲存庫的其他地方未明確使用的設定條目：

  • 高相容性模式
  • 耐久度損失設定
  • particleEffect1
  • particleEffect2

相比之下，particleEffect3 是在目前程式碼中有明顯活躍使用的粒子設定。