CustomizingItemBag

Overview

CustomizingItemBag.xml defines crystal bags: lookup tables that determine which crystals are available for a given equipment type, gamble grade and rarity combination.

Version support

Version	Status
v92	Full
v90	-
v86	-

---

DSL support

Entity: customizingItemBags Operations: create, update, delete, upsert

---

Quick recipes

Create

spec:
  version: "1.0"

customizingItemBags:
  create:
    - requiredEquipmentType: EQUIP_WEAPON
      gambleItemGrade: 1
      rareGrade: 3
      bagItems:
        - conversionSmallGroup: 100
          templateId: "80001"
          name: "Crystal of Wrath"
        - conversionSmallGroup: 101
          templateId: "80002"
          name: "Crystal of Fury"

Update

Updates replace the entire bag item list (clear-and-replace semantics).

spec:
  version: "1.0"

customizingItemBags:
  update:
    - requiredEquipmentType: EQUIP_WEAPON
      gambleItemGrade: 1
      rareGrade: 3
      changes:
        bagItems:
          - conversionSmallGroup: 200
            templateId: "80010"
            name: "Crystal of Might"

Delete

All three composite key fields are required.

spec:
  version: "1.0"

customizingItemBags:
  delete:
    - requiredEquipmentType: EQUIP_WEAPON
      gambleItemGrade: 1
      rareGrade: 3

Upsert

Creates the bag if it does not exist, or replaces its items if it does. Applying the same upsert twice produces identical output.

spec:
  version: "1.0"

customizingItemBags:
  upsert:
    - requiredEquipmentType: EQUIP_WEAPON
      gambleItemGrade: 1
      rareGrade: 3
      bagItems:
        - conversionSmallGroup: 100
          templateId: "80001"
          name: "Crystal of Wrath"

---

Properties reference

CrystalBag (root element)

Property	Type	Since	Required	Description
requiredEquipmentType	EquipmentType	v92	Yes	Equipment type this bag applies to
gambleItemGrade	int	v92	Yes	Gamble item grade tier
rareGrade	int	v92	Yes	Rarity grade tier
bagItems	list[BagItem]	v92	No	Crystals available in this bag

BagItem

Each item represents a crystal available for selection within the bag.

Property	Type	Since	Required	Description
conversionSmallGroup	int	v92	Yes	Conversion small group identifier
templateId	string	v92	Yes	Crystal template identifier
name	string	v92	Yes	Crystal display name

Enum types

EquipmentType

Value	Since
EQUIP_WEAPON	v92
EQUIP_ARMOR_BODY	v92
EQUIP_ACCESSORY	v92

---

XML structure

CrystalBags
└── CrystalBag (requiredEquipmentType, gambleItemGrade, rareGrade)
    └── BagItem (conversionSmallGroup, templateId, name)

---

Notes

• CrystalBag uses a composite key of requiredEquipmentType + gambleItemGrade + rareGrade. All three fields are required for update, delete and upsert operations.
• Bag items use clear-and-replace semantics: supplying a new bagItems list replaces all existing items.
• Related schemas: CustomizingItem (for crystal definitions referenced by templateId).