# Random Drops

<div data-full-width="true"><figure><img src="/files/8Mk4HOl7w0WlK95BbfkP" alt=""><figcaption></figcaption></figure></div>

The **Random Drops** system allows users to define item drops from specific blocks with customizable chances, adding variety and excitement to gameplay. This guide explains how to configure the `random_drops.yml` file to suit your needs.

***

**File Structure**

The `random_drops.yml` file is divided into three main sections:

1. **Global Settings**:
   * Controls whether random drops are enabled and their overall probability.
2. **Chances**:
   * Defines specific items, the blocks they drop from, and the likelihood of their drops.

***

**Configuration Example**

Here’s an example configuration:

```yaml
chanced_drop: true
chance_to_drop: 10
chances:
  apple:
    blocks:
    - BIRCH_LEAVES
    - OAK_LEAVES
    - DARK_OAK_LEAVES
    chance: 60
  cabbage:
    blocks:
    - SHORT_GRASS
    - FERN
    - TALL_GRASS
    chance: 50
  tomato:
    blocks:
    - SHORT_GRASS
    - TALL_GRASS
    chance: 80
```

***

#### **1. Global Settings**

**`chanced_drop`**

* **Type**: Boolean (`true` or `false`)
* **Description**: Enables or disables the random drops system.
* **Example**:

  ```yaml
  chanced_drop: true
  ```

**`chance_to_drop`**

* **Type**: Integer (1–100)
* **Description**: Sets the overall chance (in percentage) of any random drop occurring when breaking a block.
* **Example**:

  ```yaml
  chance_to_drop: 10
  ```

  * In this example, there’s a 10% chance that a random drop will occur when breaking a block.

***

#### **2. Chances**

Each entry under the `chances` section represents an item and includes the following properties:

**`blocks`**

* **Type**: List
* **Description**: Specifies the blocks that can drop the item.
* **Example**:

  ```yaml
  blocks:
  - BIRCH_LEAVES
  - OAK_LEAVES
  - DARK_OAK_LEAVES
  ```

**`chance`**

* **Type**: Integer (1–100)
* **Description**: Sets the likelihood (in percentage) of the item dropping when a defined block is broken.
* **Example**:

  ```yaml
  chance: 60
  ```

  * In this example, there is a 60% chance of the item dropping if the block is broken.

***

#### **Adding or Modifying Drops**

**Step 1: Define a New Item**

Add a new entry under `chances` for the item you want to include. For example, to add a "pineapple" drop:

```yaml
pineapple:
  blocks:
  - SHORT_GRASS
  - FERN
  - TALL_GRASS
  chance: 65
```

**Step 2: Associate Blocks**

List all the blocks from which the item can drop under the `blocks` key.

**Step 3: Set Drop Chance**

Set the probability of the item dropping using the `chance` key.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://pm2plugins.gitbook.io/infinitecrops/features/random-drops.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
