> For the complete documentation index, see [llms.txt](https://paw-studio.gitbook.io/paw-studio-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://paw-studio.gitbook.io/paw-studio-docs/litefish/drop.md).

# 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%    |