For the complete documentation index, see llms.txt. This page is also available as Markdown.

📑EventItemBagManager

Registration of GameServer "bags" (reward packages) and their contents.

Column
Accepted values ​​
Description

Index

Fixed number, unique per bag

Identifies the bag. Must also match a filename within the Data\EventItemBag\ folder (see notes).

ItemIndex

Item number, or *

The item that triggers this bag when used/opened by the player. * = the bag is not triggered by an item.

ItemLevel

Number (item level/option), or *

The item level that must match the ItemIndex. * = any item level triggers it.

MonsterClass

Monster class number, or *

The monster that may drop this bag upon death. * = the bag is not triggered by a monster.

SpecialValue

Number, or *

Internal code used by server systems (Blood Castle, Chaos Castle, Illusion Temple, Imperial Guardian, Double Goer, Crywolf, Lottery, Gift, etc.) to release this bag. * = the bag is not triggered by a special system.

Comment

Free text after //

Note for the person editing the file only — not read by the game.

Notes

  • 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.

Last updated