# RefreshLoot - 物资刷新插件
## 插件信息
- **名称**: RefreshLoot
- **版本**: 1.0.0
- **作者**: 114514h
- **支持版本**: Minecraft 1.21.4
- **API版本**: Spigot 1.21
## 功能描述
RefreshLoot 是一个用于刷新世界内容器物品的插件。管理员可以使用命令来刷新世界内所有容器的随机槽位，包括箱子、陷阱箱、大箱子、木桶、熔炉、漏斗等。
### 主要特性
- **智能刷新**: 随机选择容器中的槽位进行物品刷新
- **容器清除**: 可选择在刷新前清除容器中的所有物品
- **配置重载**: 支持热重载配置文件，无需重启服务器
- **多种容器支持**: 支持箱子、陷阱箱、大箱子、木桶、熔炉、漏斗等
- **异步处理**: 避免服务器卡顿，确保流畅运行
- **高度可配置**: 可自定义刷新物品、数量、容器类型等
## 命令
- `/refreshloot` 或 `/rloot` - 刷新世界内所有容器的随机槽位
- `/refreshloot reload` 或 `/rloot reload` - 重新加载配置文件
- **权限**: `refreshloot.admin` (默认OP权限)
## 配置说明
### 基本设置
```yaml
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) - 普通箱子
- **陷阱箱** (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权限）