> For the complete documentation index, see [llms.txt](https://changelog.matrixemulator.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://changelog.matrixemulator.com/welcome/server/muserver/data/item/itemstack.md).

# ItemStack

<mark style="color:green;">Defines which items can be stacked in the inventory (such as jewels and potions) and, optionally, whether a full stack is automatically converted into another item.</mark>

| Column      | Accepted values            | Description                                                                                                                                                                                |
| ----------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Index       | Number (item code)         | The item that can be stacked.                                                                                                                                                              |
| Level       | Number, or `*`             | Restricts the rule to a specific level of that item. `*` = applies to any level (used when there is no rule for the exact level).                                                          |
| MaxStack    | Number from 1 to 255       | Maximum number of items that can be stored in a single stack.                                                                                                                              |
| CreateIndex | Number (item code), or `*` | If specified, when the stack reaches **exactly** `MaxStack`, the entire stack is automatically converted into one unit of this item. `*` = no conversion; the item simply stacks normally. |
| Comment     | Text after `//`            | Free comment (typically the item name), ignored by the game.                                                                                                                               |

### <mark style="color:yellow;">Notes</mark>

* Any item not listed in this file cannot be stacked and always occupies its own inventory slot.
* Automatic conversion (`CreateIndex`) occurs only when the stack reaches **exactly** `MaxStack`. This is how, for example, 24 **Card Pieces** become a different item, or 5 **Symbols of Kundun** become 1 **Jewel of Chaos** (see each row's destination item in the file).
* Items such as **Box of Kundun** use multiple entries for the same `Index` (`7179`), one for each item level (`+1` through `+5`). This makes it possible to assign a different `MaxStack` for each level, even though the default configuration uses `255` for all of them.