BuyList

Overview

ItemSellList.xml defines buy list catalogs: item collections that NPC merchants offer for sale. Each list entry contains purchasable items with optional price revision overrides. BuyList uses regional variant files (suffixed _CN, _JP, _KR, _NAEU, _RUS, _THA, _TW).

Version support

Version	Status
v92	Full
v90	-
v86	-

---

DSL support

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

---

Properties reference

List (root entry)

Attribute	Type	Since	Required	Description
id	int	v92	Yes	Unique list identifier (primary key)
desc	string	v92	No	Internal description
needMedalItemId	int	v92	No	Medal item ID required to access this list
needPointNpcGuildId	int	v92	No	NPC guild ID whose points are required
needGuildCoin	bool	v92	No	Whether guild coins are required
items	list[Item]	v92	No	Purchasable items in this list

Item (nested under List)

Attribute	Type	Since	Required	Description
itemId	int	v92	Yes	Item template ID
priceRevision	int	v92	No	Price revision override

---

XML structure

ItemSellList (root)
└── List (id, desc?, NeedMedalItemId?, NeedPointNpcGuildId?, needGuildCoin?)
    └── Item (itemId, priceRevision?)

---

DSL examples

Create

spec:
  version: "1.0"

buyLists:
  create:
    - id: 99001
      desc: "Custom weapon shop"
      needMedalItemId: 45001
      items:
        - itemId: 100001
          priceRevision: 1
        - itemId: 100002
          priceRevision: 2

Update

spec:
  version: "1.0"

buyLists:
  update:
    - id: 500
      changes:
        needMedalItemId: 45002
        items:
          - itemId: 200001
            priceRevision: 1

Delete

spec:
  version: "1.0"

buyLists:
  delete:
    - 99001

Upsert

spec:
  version: "1.0"

buyLists:
  upsert:
    - id: 99001
      desc: "Updated weapon shop"
      needGuildCoin: true
      items:
        - itemId: 100001
          priceRevision: 3

---

Regional variants

BuyList supports regional variant files. The base file is BuyList.xml, with suffixed variants for region-specific catalogs:

Suffix	Region
_CN	China
_JP	Japan
_KR	Korea
_NAEU	North America / Europe
_RUS	Russia
_THA	Thailand
_TW	Taiwan

Regional entries are purely additive — they add new List entries but do not override base entries.

---

Notes

• Items within a list use a clear-and-replace pattern on update: when items is specified in an update or upsert, all existing items are removed and replaced with the new list.
• The id field on List maps to ItemList.id references in BuyMenuList, linking catalogs to shop menu tabs.
• needMedalItemId and needPointNpcGuildId control access requirements: the player must hold the specified medal item or have sufficient NPC guild reputation points.