跳到主要内容

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 是在当前代码中有明显活跃使用的粒子设置。