CollectionGiftTable

Overview

CollectionGiftTable.xml defines collection gift entries: drop tables for gatherable resource nodes (mining, herbing, etc.), each containing a single drop bag with one or more drop items.

Version Support

Version	Status
v92	Full
v90	-
v86	-

---

DSL Support

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

---

Quick Recipes

Create

spec:
  version: "1.0"

collectionGifts:
  create:
    - giftNum: 99001
      dropBagDropRate: 10000
      dropItems:
        - itemTemplateId: 1001
          dropRate: 0.5
          maxNum: 3
          minNum: 1
        - itemTemplateId: 1002
          dropRate: 0.3
          maxNum: 1
          minNum: 1

Update

spec:
  version: "1.0"

collectionGifts:
  update:
    - giftNum: 99001
      changes:
        dropBagDropRate: 20000
        dropItems:
          - itemTemplateId: 1001
            dropRate: 0.8
            maxNum: 5
            minNum: 2

Delete

spec:
  version: "1.0"

collectionGifts:
  delete:
    - 99001
    - 99002

Upsert

spec:
  version: "1.0"

collectionGifts:
  upsert:
    - giftNum: 99001
      dropBagDropRate: 10000
      dropItems:
        - itemTemplateId: 1001
          dropRate: 0.5
          maxNum: 3
          minNum: 1

---

Properties reference

CollectionGift (Root Element)

Property	Type	Since	Required	Description
giftNum	int	v92	Yes	Unique identifier (primary key)

DropBag (1:1 structural child)

Each CollectionGift contains exactly one DropBag. In the DSL, DropBag attributes are flattened onto the CollectionGift level.

Property	Type	Since	Required	Description
dropBagDropRate	int	v92	No	Drop rate for the bag as a whole

DropItem (children of DropBag)

Each DropBag can contain up to 10 DropItem entries. Items are identified by itemTemplateId within their parent bag.

Property	Type	Since	Required (create)	Description
itemTemplateId	int	v92	Yes	Item template ID (identifier within drop bag)
dropRate	decimal	v92	Yes	Drop probability for this item
maxNum	int	v92	Yes	Maximum quantity dropped
minNum	int	v92	Yes	Minimum quantity dropped

---

XML Structure

CollectionGiftTable
└── CollectionGift (giftNum)
    └── DropBag (dropRate)
        └── DropItem (itemTemplateId, dropRate, maxNum, minNum) [max 10]

Example XML output

<CollectionGiftTable>
  <CollectionGift giftNum="99001">
    <DropBag dropRate="10000">
      <DropItem dropRate="0.5" itemTemplateId="1001" maxNum="3" minNum="1" />
      <DropItem dropRate="0.3" itemTemplateId="1002" maxNum="1" minNum="1" />
    </DropBag>
  </CollectionGift>
</CollectionGiftTable>

---

Notes

• DropBag is 1:1. Each CollectionGift always has exactly one DropBag. The DSL flattens the DropBag’s dropRate attribute as dropBagDropRate on the CollectionGift level.
• DropItem identification. DropItems are identified by itemTemplateId within their parent DropBag (composite key: giftNum + itemTemplateId).
• DropItem limit. Each DropBag supports a maximum of 10 DropItem entries.
• Single file. All CollectionGift entries reside in CollectionData/CollectionGiftTable.xml.
• No filter support. This entity does not support updateWhere operations.