> 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/litesize/potions.md).

# 🧪Potions

LiteSize adds custom size potions that allow players to temporarily increase or decrease their size.

Potions can be brewed using **custom brewing recipes**, which can be configured individually for each potion.

All potion configurations are stored in the `potions` folder.

### Potion Configuration

Each potion has its own configuration file.

Example:

```yaml
duration: 60 # seconds
item:
  material: POTION
  display_name: <white>Potion of Shrinking
  lore:
  - <blue>Shrinking (01:00)
  - ''
  - '<dark_purple>When applied:'
  - <blue>-50% Size
  effects:
  - HIDE_ADDITIONAL_TOOLTIP
  nbt:
    id: potion_1
  color: '16777215'
scale:
  selected: STATIC # MULTIPLIER or STATIC
  value: '50'
potion_interaction:
  use_animation:
    sound:
      name: minecraft:item.bottle.empty
      pitch: 1
      volume: 1
    particle:
      name: minecraft:cloud
      amount: 10
      range: 0
      speed: 0.1
      offset:
        x: 0
        y: 0.5
        z: 0
  selected: 'ON'
recipe:
  required:
    type: SWIFTNESS
    duration: 0
    level: 1
  ingredient:
    material: BROWN_MUSHROOM

```

### Scale

```yml
scale:
  selected: MULTIPLIER # MULTIPLIER or STATIC
  value: '2'
```

The `scale` setting controls the size of an entity.

Defines how the `value` is applied.

* `STATIC` — sets the entity's size relative to its default size.
* `MULTIPLIER` — multiplies the entity's current size.

**STATIC**

Sets the entity size as a percentage of its default size.

Examples:

* `200` → **200%** of the default size (**×2**)
* `100` → **100%** of the default size (**×1**)
* `40` → **40%** of the default size (**×0.4**)

**MULTIPLIER**

Multiplies the entity's current size by the specified value.

Examples:

* `2` → **×2** of the current size
* `3` → **×3** of the current size
* `0.5` → **×0.5** of the current size (half the current size)

For example, if an entity is currently **150%** of its default size:

* `MULTIPLIER: 2` → **300%**
* `MULTIPLIER: 0.5` → **75%**

#### Brewing Recipes

Custom brewing recipes are fully configurable.

For example:

```yaml
recipe:
  required:
    type: SWIFTNESS
  ingredient:
    material: BROWN_MUSHROOM
```

This creates a recipe requiring a **Swiftness Potion** and a **Brown Mushroom** as the ingredient.

### Potion Interaction

The `potion_interaction` setting allows players to apply a potion directly to an entity.

Normally, a potion is consumed by the player when used. When this feature is enabled, using the potion on an entity with **Right Click** applies the potion effect to that entity instead.

```yml
potion_interaction:
  use_animation:
    sound:
      name: minecraft:item.bottle.empty
      pitch: 1
      volume: 1
    particle:
      name: minecraft:cloud
      amount: 10
      range: 0
      speed: 0.1
      offset:
        x: 0
        y: 0.5
        z: 0
  selected: 'ON' # ON / OFF / PERMISSION
```

Controls whether potion interaction is enabled.

* `ON` — players can apply potions to entities.
* `OFF` — potion interaction is disabled.
* `PERMISSION` — potion interaction is available only to players with the required permission.