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

# EventItemBagManager

<mark style="color:green;">Registration of GameServer "bags" (reward packages) and their contents.</mark>

<table><thead><tr><th>Column</th><th>Accepted values ​​</th><th width="250">Description</th></tr></thead><tbody><tr><td>Index</td><td>Fixed number, unique per bag</td><td>Identifies the bag. Must also match a filename within the <code>Data\EventItemBag\</code> folder (see notes).</td></tr><tr><td>ItemIndex</td><td>Item number, or <code>*</code></td><td>The item that triggers this bag when used/opened by the player. <code>*</code> = the bag is not triggered by an item.</td></tr><tr><td>ItemLevel</td><td>Number (item level/option), or <code>*</code></td><td>The item level that must match the <code>ItemIndex</code>. <code>*</code> = any item level triggers it.</td></tr><tr><td>MonsterClass</td><td>Monster class number, or <code>*</code></td><td>The monster that may drop this bag upon death. <code>*</code> = the bag is not triggered by a monster.</td></tr><tr><td>SpecialValue</td><td>Number, or <code>*</code></td><td>Internal code used by server systems (Blood Castle, Chaos Castle, Illusion Temple, Imperial Guardian, Double Goer, Crywolf, Lottery, Gift, etc.) to release this bag. <code>*</code> = the bag is not triggered by a special system.</td></tr><tr><td>Comment</td><td>Free text after <code>//</code></td><td>Note for the person editing the file only — not read by the game.</td></tr></tbody></table>

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

* The `Index` for each line requires a corresponding file within `Data\EventItemBag\`, named with exactly 3 digits followed by `-` and a name—e.g., `007 - Box of Kundun 1.txt` for Index `7`. This file defines the bag's items and drop rates; without it, the bag exists in the configuration but never yields any items.
* `ItemIndex` and `MonsterClass` are generic: any item or monster can serve as a trigger in a new line without requiring additional server-side setup.
* `SpecialValue` is different: numbers from `0` to `61` are already assigned to fixed server systems (Blood Castle, Chaos Castle, Illusion Temple, Imperial Guardian, Double Goer, Crywolf, Lottery, Gift, Starter Ring, Senior Mix, Lucky Coin, Cherry Blossom Mix, Chaos Card Mix, Santa Claus, MU Rummy)—do not reuse these numbers for other purposes. A new number (such as `200` or `201` at the end of the file) will only function if another system (Custom Mix, custom NPC, Lua script) is programmed to specifically call that number.
* A single line can combine multiple triggers (with `ItemIndex`, `MonsterClass`, and `SpecialValue` all populated); the bag activates if any one of these triggers occurs.