RefreshLoot

插件

· 作者 114514h

一个用于刷新世界内容器物品的插件

0 本站下载 0 关注 更新于 1 年前

最新 1.0.0 · 1.21.8 · Bukkit / Paper

一键开服(送7天)

RefreshLoot - 物资刷新插件

插件信息

  • 名称: RefreshLoot
  • 版本: 1.0.0
  • 作者: 114514h
  • 支持版本: Minecraft 1.21.4
  • API 版本: Spigot 1.21

功能描述

RefreshLoot 是一个旨在刷新世界中容器内物品的插件。管理员可以使用命令来刷新世界内所有容器的随机槽位,包括箱子、陷阱箱、大型箱子、木桶、熔炉、漏斗等。

主要特性

  • 智能刷新:随机选择容器槽位进行物品刷新。
  • 清空容器:可选择在刷新前清空容器中的所有物品。
  • 配置重载:支持热重载配置文件,无需重启服务器。
  • 多种容器支持:兼容箱子、陷阱箱、大型箱子、木桶、熔炉、漏斗等。
  • 异步处理:避免服务器卡顿,确保流畅运行。
  • 高度可配置:自定义刷新物品、数量、容器类型等。

命令

  • /refreshloot 或 /rloot - 刷新世界中所有容器的随机槽位。
  • /refreshloot reload 或 /rloot reload - 重新加载配置文件。
  • 权限:refreshloot.admin (默认 OP 权限)

配置说明

基本设置

settings:
  debug: false                    # 是否启用调试模式
  refresh-interval: 300           # 刷新间隔(秒)
  random-slots: 3                 # 每次刷新时随机刷新的槽位数量
  clear-containers: true          # 是否在刷新前清空容器内容

清空容器说明:

  • clear-containers: true - 在添加新的随机物品之前清空容器中的所有物品。
  • clear-containers: false - 保留容器中现有的物品,仅在随机选择的槽位中添加新物品。
  • 推荐设置为 true 以获得更好的刷新效果。

容器配置

每种容器类型都可以单独配置:

  • enabled: 是否启用该容器类型的刷新。
  • refresh-slots: 每次刷新时刷新的槽位数量。
  • items: 可能刷新的物品列表。

物品格式

物品配置格式:MATERIAL:min-max

  • DIAMOND:1-3 - 钻石,数量 1-3。
  • BREAD:2-5 - 面包,数量 2-5。
  • IRON_SWORD:1 - 铁剑,固定数量 1。

重要提示:在 Minecraft 1.21.4 中,金质装备的名称已更改:

  • GOLD_HELMET → GOLDEN_HELMET
  • GOLD_CHESTPLATE → GOLDEN_CHESTPLATE
  • GOLD_LEGGINGS → GOLDEN_LEGGINGS
  • GOLD_BOOTS → GOLDEN_BOOTS

请参阅 MATERIAL_NAMES.md 文件获取详细的物品名称列表。

支持的容器类型

  • Chest (chest) - 普通箱子
  • Trapped Chest (trapped_chest) - 陷阱箱
  • Large Chest (large_chest) - 大型箱子
  • Barrel (barrel) - 木桶
  • Furnace (furnace) - 熔炉、高炉、烟熏炉
  • Hopper (hopper) - 漏斗

安装方法

  1. 将编译好的 RefreshLoot-1.0.0.jar 文件放入服务器的 plugins 文件夹中。
  2. 重启服务器或使用 /reload 命令。
  3. 插件将自动生成配置文件 config.yml。
  4. 根据需要修改配置文件。
  5. 使用 /rloot 命令开始刷新容器。

重载功能

插件支持在不重启服务器的情况下热重载配置文件:

使用方法

/rloot reload

重载特性

  • 即时生效:修改配置文件后,更改立即生效。
  • 安全重载:包含错误处理,防止重载期间插件失效。
  • 调试信息:当启用调试模式时,显示重载配置状态。
  • 异步处理:重载过程不会阻塞服务器的主线程。

何时重载

  • 修改容器配置后。
  • 调整物品刷新列表后。
  • 更改插件设置后。
  • 更新消息配置后。

注意事项

  • 插件会扫描世界中的所有区块以查找容器,这在大型世界中可能需要较长时间。
  • 建议在服务器负载较低的时段使用刷新命令。
  • 在配置文件中为每种容器类型自定义物品和数量。
  • 启用调试模式可查看详细的刷新信息。

权限

  • refreshloot.admin - 允许使用物资刷新命令(默认 OP 权限)

支持的容器类型

  • 箱子 (chest) - 普通箱子
  • 陷阱箱 (trapped_chest) - 陷阱箱
  • 大箱子 (large_chest) - 双箱子
  • 木桶 (barrel) - 木桶
  • 熔炉 (furnace) - 熔炉、高炉、烟熏炉
  • 漏斗 (hopper) - 漏斗

安装方法

  1. 将编译好的 RefreshLoot-1.0.0.jar 文件放入服务器的 plugins 文件夹
  2. 重启服务器或使用 /reload 命令
  3. 插件会自动生成配置文件 config.yml
  4. 根据需要修改配置文件
  5. 使用 /rloot 命令开始刷新容器

重载功能

插件支持热重载配置文件,无需重启服务器:

使用方法

/rloot reload

重载功能特点

  • 实时生效: 修改配置文件后立即生效
  • 安全重载: 包含错误处理,重载失败不会影响插件运行
  • 调试信息: 启用调试模式时显示重载后的配置状态
  • 异步处理: 重载过程不会阻塞服务器主线程

重载时机

  • 修改容器配置后
  • 调整刷新物品列表后
  • 更改插件设置后
  • 更新消息配置后

## 注意事项
- 插件会扫描世界中的所有区块来查找容器,在大世界中可能需要较长时间
- 建议在服务器负载较低时使用刷新命令
- 可以通过配置文件自定义每种容器刷新的物品和数量
- 启用调试模式可以查看详细的刷新信息

## 权限
- `refreshloot.admin` - 允许使用物资刷新命令(默认OP权限)

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源