> 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/rarity-system.md).

# Rarity System

### Rarity System

Each category can contain an unlimited number of **rarities**. During loot generation, the system first selects a rarity based on its configured chance, and then rolls an item from that specific rarity.

You can assign a **custom display name** to every rarity. If not specified, names are generated automatically.

***

#### Automatic Rarity Lore

The plugin allows you to automatically attach a rarity lore line to any item caught from that rarity.

**Config example:**

```json
"game.rarity_lore": "<insert_position:1>%rarity%"
```

| Key               | Description                                                                                                    |
| ----------------- | -------------------------------------------------------------------------------------------------------------- |
| `insert_position` | Defines where the text will be inserted. `1` means the lore will be placed at the very top of the item's lore. |
| `%rarity%`        | Placeholder that displays the name of the selected rarity.                                                     |

***

#### Enabling / Disabling Lore Injection

You can toggle automatic rarity lore addition globally:

**Path:**\
`/lfish menu → Settings → Rarity`

Setting **OFF** disables global rarity lore injection for all drops.

***

#### Per-Drop Configuration

Every drop can individually override this behavior.\
You can choose which items **should** or **should not** receive the rarity lore, regardless of the global setting.

This allows maximum flexibility — some drops can show rarity, others can remain clean