# 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


---

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