> For the complete documentation index, see [llms.txt](https://docs.candy-smith.com/main/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.candy-smith.com/main/match-3-kit-home-design/customization/item-setup.md).

# Item setup

<figure><img src="/files/JFhbfvIb4ppUVHec5ywq" alt="" width="335"><figcaption></figcaption></figure>

`Item` is the base runtime component for match-3 pieces.

### Inspector fields

| Field                             | Type             | Description                                                                             |
| --------------------------------- | ---------------- | --------------------------------------------------------------------------------------- |
| **Destroy or damage FX**          | `GameObject`     | Visual effect played when the item is destroyed or damaged.                             |
| **Size in squares**               | `Vector2Int`     | Logical size of the item in board cells. Most items use `1×1`.                          |
| **Item Behaviour**                | `ItemBehaviour`  | Defines how the item behaves (matching, switching, explosions, neighbour damage, etc.). |
| **Item score**                    | `int`            | Score awarded when the item is destroyed.                                               |
| **Spawn amount**                  | `SpawnAmountObj` | Maximum number of bonus objects that can be spawned simultaneously.                     |
| **Outline Glow Material**         | `Material`       | Material used for the outline glow effect.                                              |
| **Base Speed**                    | `float`          | Initial falling speed.                                                                  |
| **Max Speed Multiplier**          | `float`          | Maximum falling speed multiplier.                                                       |
| **Acceleration Rate**             | `float`          | Acceleration applied while the item is falling.                                         |
| **Pre Win Coin Animation Prefab** | `GameObject`     | Prefab used for the pre-win coin animation.                                             |
| **Current Type**                  | `ItemsTypes`     | Default item type.                                                                      |
| **Plus Time**                     | `GameObject`     | Prefab for the time bonus object.                                                       |
| **Static On Start**               | `bool`           | Prevents the item from falling when the level starts.                                   |
| **Direct Sprite Renderer**        | `SpriteRenderer` | Optional sprite renderer used directly by the item.                                     |
| **FX Sound**                      | `AudioClip`      | Sound played when the destruction FX is triggered.                                      |
| **FX Sound Delay**                | `float`          | Delay before playing the FX sound.                                                      |
| **Appear Sound**                  | `AudioClip`      | Sound played when the item appears.                                                     |
| **Appear Sound Delay**            | `float`          | Delay before playing the appearance sound.                                              |

### Notes

* Inspector values define the default configuration of the item prefab.
* Runtime systems may change the item's type, color, and state during gameplay.
* Most gameplay behaviour is controlled through **Item Behaviour**.