## 概述
CompostManager 是一款 Minecraft 插件，允许服务器管理员管理游戏中的可堆肥物品。它支持 Minecraft 1.14 及以上版本（堆肥箱首次添加的版本）。
## 功能
### 版本特定支持
> - 自动检测服务器版本
> - 仅加载该版本中可用的物品
> - 避免因较新版本物品而产生的错误
### 物品管理
> - 添加自定义可堆肥物品
> - 编辑现有物品
> - 移除自定义物品
> - 查看所有可堆肥物品
> - 配置堆肥几率和填充量
### 额外骨粉系统
> - 可配置的额外骨粉掉落
> - 多种额外类型：
> - 随机额外
> - 高几率额外
> - 高填充量额外
> - 可自定义金额和几率
## 指令
| 指令 | 描述 | 权限 |
|---------|-------------|------------|
| /compost add <物品> <几率> <填充> | 添加新的可堆肥物品 | compostmanager.command.add |
| /compost edit <物品> <几率> <填充> | 编辑现有物品 | compostmanager.command.edit |
| /compost remove <物品> | 移除自定义物品 | compostmanager.command.remove |
| /compost list | 显示所有可堆肥物品 | compostmanager.command.list |
| /compost reload | 重新加载配置 | compostmanager.command.reload |
### 参数
- 几率: 0.0 到 1.0 (例如: 0.65 = 65% 几率)
- 填充: 1 到 7 (添加到堆肥箱等级的数量)
### 配置文件
```
# 主要设置
use-default-items: true # 使用原版 Minecraft 物品
version:
auto-add-new-items: true # 自动添加新物品
show-version-warnings: true # 显示关于版本兼容性的警告
# 额外骨粉设置
bonus-bone-meal:
enabled: true
base-amount: 1
max-amount: 5
random-bonus:
enabled: true
max-bonus: 2
chance-multiplier: 0.5
high-chance-bonus:
enabled: true
required-chance: 0.85
bonus-chance: 0.3
bonus-amount: 1
high-fill-bonus:
enabled: true
required-fill: 5
bonus-chance: 0.3
bonus-amount: 1
```
### 默认物品
- 30% 几率物品：种子、树叶、草等。
- 50% 几率物品：干燥的海藻块、西瓜片等。
- 65% 几率物品：食物、蘑菇等。
- 85% 几率物品：烤熟的食物、干草块等。
- 100% 几率物品：蛋糕、南瓜等。
### 自定义游戏内物品
- 存储在 config 的 _custom-items_ 部分
- 持续重启服务器
- 可以在游戏中添加/移除/编辑
### 权限
```
compostmanager.admin:
description: 访问所有指令
children:
compostmanager.command.add: true
compostmanager.command.edit: true
compostmanager.command.remove: true
compostmanager.command.reload: true
compostmanager.command.list: true
```
### 安装
1. 将插件 JAR 放置在 plugins 文件夹中
2. 启动/重启服务器
3. 如果需要，编辑 config.yml
4. 使用 /compost 指令管理物品
### 注意事项
- 需要 Minecraft 1.14 或更高版本
- 更改会自动保存
- 所有指令都支持 Tab 自动补全
- 支持所有原版可堆肥物品
- 自定义物品在重启后仍然存在
## 支持
如果需要支持，请访问我们的 [Discord 服务器](https://discord.com/invite/krcaTEK5VD) 或在issue中提交任何 bug 或功能请求。