# Drop

### 🐟Fishing Drop Configuration

```json
{
    "id": "COD_1",
    "chance": 50.0,
    "health": 1,
    "exp": 5,
    "vanilla_experience": 0,
    "weight": "1-4",
    "random_durability": false,
    "random_enchant": false,
    "catch_info": true,
    "rarity_info": true,
    "price": 0.32,
    "level": 0,
    "item": {
        "material": "PUFFERFISH",
        "display_name": "§x§5§E§D§6§3§ADewdrop Puffer"
    },
    "commands": [],
    "conditions": {
        "time": "NIGHT",
        "weather": "RAIN"
    },
    "not_discovered_tips": [
        "<gray>Conditions:",
        "<gray>- Raining",
        "<gray>- Night"
    ]
}
```

```json
{
    "link_id": "COD_1"
}
```

#### `id`

**Type:** `String`\
Unique identifier of the drop. Used internally for catalogs, discovery tracking, and references.

***

#### `link_id`

**Type:** `String`\
Link to an already created drop config.

***

#### `chance`

**Type:** `Double`\
Chance to catch this drop, expressed as a percentage.

Example:

* `50.0` → 50% chance

***

#### `health`

**Type:** `Integer`\
Amount of points required to successfully complete the fishing mini-game for this drop.

***

#### `exp`

**Type:** `Integer`\
Fishing profession experience (Catalog) granted upon successful catch.

***

#### `vanilla_experience`

**Type:** `Integer`\
Amount of vanilla Minecraft experience awarded to the player.

***

#### `weight`

**Type:** `String`\
Defines the weight range of the caught fish.

Format:

"min-max"

Example:

* `"1-4"` → random value between 1 and 4

Weight may be used for:

* price calculation
* lore display

***

#### `random_durability`

**Type:** `Boolean`\
Applies a random durability value if the item supports durability.

***

#### `random_enchant`

**Type:** `Boolean`\
Applies random enchantments to the item upon catch.

***

#### `catch_info`

**Type:** `Boolean`\
Adds informational lore to the caught item.

Typically includes:

* catch date
* player\_name

***

#### `rarity_info`

**Type:** `Boolean`\
Adds rarity information to the item lore.

***

#### `price`

**Type:** `Double`\
Price per **single unit of weight** or **per item**, depending on economy settings.

Common formula:

price × weight

***

#### `level`

**Type:** `Integer`\
Minimum required fishing profession level to catch this drop.

***

#### `item`

**Type:** `LiteItem`\
Defines the item rewarded to the player. [LiteItem](/paw-studio-docs/overview/liteitem.md)

***

#### `commands`

**Type:** `List<String>`\
Commands executed when the drop is successfully caught.

Player placeholders are supported.

Example:

"commands": \["eco give %player\_name% 10","broadcast %player\_name% caught a rare fish!"]

***

#### `conditions`

**Type:** `Object`\
Conditions required for this drop to be catchable.

Supported values:

* `time`: `DAY`, `NIGHT`, `DAWN`, `SUNSET`,
* `weather`: `RAIN`, `STORM`
* `moon`: `FULL_MOON`, `HALF_MOON`
* `height`: `min_y`, `max_y`

If conditions are not met, the drop is unavailable.

***

#### `not_discovered_tips`

**Type:** `List<String>`\
Lore shown in the **Catalog UI** if the item has not yet been discovered by the player.

Typically used to hint at catch conditions.

***

### 🐟Weight&#x20;

* Weight - generates a random weight. The weight must be specified as a range like `1-10`. Weight can be displayed in lore. Weight affects the price of the fish (price \* weight). This function adds two NBT weight data and id data to an item (`{"litefish:id" "%id%", "litefish": %weight%d}`). The closer the number is to the acceptable limit, the lower the chance. Below is a table for generating weights from 1 to 10 (values ​​have been rounded to the nearest whole number to shorten the table).&#x20;

| Weight | Count ( 1.000.000 gen) | Percent |
| ------ | ---------------------- | ------- |
| 1      | 131455                 | 13.1%   |
| 2      | 233766                 | 23.4%   |
| 3      | 190647                 | 19.1%   |
| 4      | 151188                 | 15.1%   |
| 5      | 115485                 | 11.5%   |
| 6      | 82629                  | 8.3%    |
| 7      | 53628                  | 5.4%    |
| 8      | 29745                  | 3.0%    |
| 9      | 10679                  | 1.1%    |
| 10     | 778                    | 0.1%    |


---

# 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://paw-studio.gitbook.io/paw-studio-docs/litefish/drop.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.
