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

# 📏Size System

LiteSize allows you to control the size of entities and create dynamic size-based gameplay.

Entity size is represented as a percentage of its default size:

* `0.5` → **50%**
* `1.0` → **100%** (default)
* `2.0` → **200%**
* `5.0` → **500%**

### Random Entity Size

LiteSize can automatically assign a random size to newly spawned entities.

You can configure:

* Which entities are affected
* One or multiple size ranges
* The chance of each range being selected
* Minimum and maximum size for each range

#### Configuration

<pre class="language-yaml"><code class="lang-yaml"><strong>random_size:
</strong>  enable: true
  entities:
    ALL:
      - chance: 100
        min: 0.5
        max: 2
    CHICKEN:
      - chance: 90
        min: 0.5
        max: 1.5
      - chance: 10
        min: 5
        max: 5
</code></pre>

#### How It Works

The `ALL` rule applies to all entities unless a specific entity has its own configuration.

In the example above, chickens have their own rules:

* **90% chance** → size between **50% and 150%**
* **10% chance** → exactly **500%** size

This makes it possible to create rare oversized creatures while keeping normal creatures within a reasonable size range.

For example, a server could have mostly normal-sized chickens with a small chance of spawning an extremely large one.

> Multiple size ranges can be configured for the same entity, allowing you to create different rarity tiers.