> 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/entity-in-a-bottle.md).

# 🍾Entity in a Bottle

LiteSize allows players to capture small entities inside a bottle and store them as an item.

A captured entity retains its **type and exact size**, allowing it to be released later at the same size.

### How It Works

1. Reduce an entity to the required size.
2. Use an empty bottle on the entity.
3. If the entity meets the configured size requirement, it is captured.
4. The empty bottle is converted into an **Entity in a Bottle**.
5. Throw the bottle to release the entity.
6. The entity is spawned with the same size it had when captured.

### Configuration

```yaml
bottle_entity:
  enable: true
  size_required: 0.5
  empty_bottle:
    material: GLASS_BOTTLE
  full_bottle:
    material: SPLASH_POTION
    display_name: <1>Entity in a Bottle
    lore:
      - '<1>Entity Type: <2>%type%'
      - '<1>Size: <2>%size%'
    effects:
      - HIDE_ADDITIONAL_TOOLTIP
  insert_animation:
    sound:
      name: minecraft:item.bottle.fill_dragonbreath
    particle:
      name: minecraft:cloud
      amount: 10
      speed: 0.1
      offset:
        y: 0.5
```

#### Size Requirement

`size_required` defines the maximum size an entity can have to be captured.

```yaml
size_required: 0.5
```

With this setting, only entities with a size of **50% or smaller** can be captured.

#### Stored Information

The generated bottle stores:

* **Entity type**
* **Entity size**

The information is also displayed in the item's lore using placeholders:

```
Entity Type: %type%
Size: %size%
```

#### Entity Release

The captured entity is stored inside a **Splash Potion** item. When the bottle is thrown, LiteSize reads the stored entity data and spawns the original entity with its original size.

This allows players to collect unusual or rare-sized creatures and release them whenever they want.