# Item State Asset

## Item State Asset

### Creating Item States

To create a new Item State asset:\
Right-click inside your Project folder →\
**Create > Game Creator > Inventory Extended > Item State**

Each Item State asset is linked to a single Item.

* Only **one Item State asset per Item** is allowed
* Each asset can contain **multiple States**

***

### What are Item States?

Item States allow a single item to have multiple variations without creating duplicate items.

This is useful for systems like:

* Durability (e.g., Normal Sword → Broken Sword)
* Quality (e.g., Low Quality → High Quality)
* Conditional variations based on item data

Instead of creating multiple items, you define different **States** that modify how the item looks and behaves.

***

### How States Work

States are evaluated using conditions.

* States are checked **from top to bottom**
* The **first State that matches its conditions** is applied
* Once a match is found, no further States are evaluated

#### Example

* If *Durability > 0* → Normal Sword
* If *Durability = 0* → Broken Sword

If the durability reaches 0, the Broken Sword state will be returned.

***

### State Configuration

Each State can override and modify the following:

* **Title**
* **Description**
* **Sprite**
* **Title Color**
* **Price Modifier**
* **Can Sell**
* **Can Drop**
* **Pickup Audio Clip**
* **Use Audio Clip**
* **Conditions** 

***

### Conditions

Conditions determine when a State becomes active.

These are typically based on Runtime Item Properties, for example:

* Durability
* Quality
* Custom properties

Example condition setup:

* *If Runtime Item Property (Durability) ≤ 0 → Broken State*

This allows dynamic behavior without replacing the item itself.

***

### Recommended Usage

Use Item States to keep your inventory system clean and scalable:

* Avoid creating duplicate items for variations
* Centralize item behavior into a single asset
* Easily expand systems like durability, quality, or item progression

***

{% hint style="info" %}

### Note

* **Price Modifier**, **Can Sell** are not yet used in the included examples, but they can already be used with **Inventory 2’s default examples** with minor setup adjustments
  {% endhint %}


---

# 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://docs.fullscreen.no/info/game-creator-2-assets/inventory-extended/item-state-asset.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.