跳到主要内容

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 中、但在这个仓库的其他位置看不出明确用途的配置项：

  • 高兼容模式
  • 耐久损失设置
  • particleEffect1
  • particleEffect2

相比之下，particleEffect3 是当前代码中有明显实际使用痕迹的粒子设置。