> 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/fish-trap.md).

# Fish Trap

#### How They Work

* Each trap is linked to a **LootMap category**, determining the possible drops.
* The category is selected automatically depending on the location of the block, or it can be linked to any category in the config
* The trap also checks the nearby blocks — for example, **water or lava** — to select the appropriate fishing type.
* You can configure the **catch interval** in seconds, defining how often a `catch` event occurs.
* **Storage size** determines how many items the trap can hold.
* Players can open the trap and take items manually.

**Important:** Fish Traps **do not load chunks** or rely on tick updates. Loot generation happens **on trap opening**, taking into account the time since the last opening.

***

#### Configuration Files

All trap configurations are stored in:

```
plugins/LiteFish/traps
```

**Example Config**

```json
{
  "item": {
    "display_name": "<#0FDCFF>Fish Trap",
    "material": "SCULK_SHRIEKER"
  },
  "catch_time": 30,
  "storage_size": 10
}
```

* **item** — defines the trap item properties.
* **catch\_time** — seconds between automatic catches.
* **storage\_size** — maximum number of items the trap can store.

***

#### Active Traps

All **player-placed traps** are saved in:

```
plugins/LiteFish/data/traps
```