# 💩 肥料

以`quality_1`为例配置肥料设置

**肥料的唯一标识符**： 首先为每种肥料类型分配一个唯一的标识符。在此示例中，肥料名为`quality_1` 。该标识符对于区分游戏中不同的肥料类型至关重要。

**定义肥料类型和图标**：

* **`type`** ：设置为`QUALITY` ，表示该肥料可以提高所施用作物的质量。
* **`icon`** ：代表当玩家查看或使用此肥料时，将出现在游戏界面中的视觉图标。图标“뀆”是一个独特的符号，直观地代表了这种特定的肥料。

可用肥料类型及其效果：

```yaml
QUALITY: 更改星级作物掉落的权重
SOIL_RETAIN: 减缓水分消耗速度
SPEED_GROW: 加速作物生长
VARIATION: 作物有更高的变异概率
YIELD_INCREASE: 增加作物产量
```

```yaml
type: QUALITY  # 肥料的类型
```

**设置肥料的有效性**：

* **`chance`** ：这是影响肥料有效性或成功率的概率因子（此处设置为`1` ）。调整该值可以使肥料或多或少地更有可能产生其预期效果。
* **`times`** ：指定肥料保持有效的持续时间或游戏中的刻数。值为`28` 时，肥料将持续 28 个刻周期，对作物生长产生持续影响。

```yaml
chance: 1  # 影响肥料效果的概率因子
```

**分配唯一的物品 ID** ：

* **`item`** ：唯一的物品`quality_1`将此配置链接到游戏内的物品，确保当玩家使用此物品时，游戏将其识别为`quality_1`肥料。

```yang
item: quality_1  # 此肥料的唯一物品 ID
```

**指定应用时间和盆栽兼容性**：

* **`before-plant`** ：设置为 `true` 时，此参数确保肥料必须在种植任何作物之前施用。它强制进行战略规划，要求玩家提前准备土壤。
* **`pot-whitelist`** ：列出可以施用此肥料的所有种植盆类型。在此示例中，仅允许使用`default`种植盆，但您可以添加更多种植盆类型以扩展兼容性。

```yaml
before-plant: true  # 表示此肥料必须在种植作物之前施用
pot-whitelist:
  - default  # 可以使用此肥料的允许种植盆列表
```

**设置事件**： \
`events`部分是游戏真正发挥作用的地方。在这里，你可以定义游戏如何响应与肥料的不同互动。可用事件： `use` / `before_plant` / `wrong_pot`

```yaml
events:
  use:  # 施用肥料时触发的动作
    particle_action:
      type: particle
      value:
        particle: SCRAPE
        x: 0.5
        y: 1.3
        z: 0.5
        count: 5
        offset-x: 0.3
        offset-z: 0.3
    sound_action:
      type: sound
      value:
        source: player
        key: minecraft:item.hoe.till
        volume: 1
        pitch: 1
  wrong_pot:  # 如果肥料用于错误的种植盆类型时触发的动作
    sound_action:
      type: sound
      value:
        key: "minecraft:item.bundle.insert"
        source: 'player'
        volume: 1
        pitch: 1
    actionbar_action:
      type: actionbar
      value: '<red><bold>[X] 此肥料只能用于种植盆中。'  # 在动作栏上显示的消息
  before_plant:  # 如果肥料在种植后使用时触发的动作
    sound_action:
      type: sound
      value:
        key: "minecraft:item.bundle.insert"
        source: 'player'
        volume: 1
        pitch: 1
    actionbar_action:
      type: actionbar
      value: '<red><bold>[X] 你只能在种植作物之前使用此肥料。'
```

**设置要求**：\
&#x20;在`requirements`下，您可以配置玩家使用肥料之前必须满足的条件。

```yaml
requirements:
  requirement_1:
    type: permission
    value: xxx.xxx
```