ItemMedalExchange

Overview

ItemMedalExchange.xml defines medal exchange entries: item purchases using medals as currency, specifying the item being sold, the medal cost, and the medal currency type.

Version Support

Version	Status
v92	Full
v90	-
v86	-

---

DSL Support

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

---

Quick Recipes

Create

spec:
  version: "1.0"

exchanges:
  create:
    - itemId: 11001
      buyPriceMedal: 100
      medalItemId: 90001

Creates a new exchange entry where item 11001 can be purchased for 100 medals of type 90001.

Create Multiple Entries

spec:
  version: "1.0"

exchanges:
  create:
    - itemId: 11001
      buyPriceMedal: 100
      medalItemId: 90001
    - itemId: 11002
      buyPriceMedal: 250
      medalItemId: 90001
    - itemId: 11003
      buyPriceMedal: 500
      medalItemId: 90002

Creates multiple exchange entries. Items 11001 and 11002 use the same medal currency (90001), while item 11003 uses a different currency (90002).

Update

spec:
  version: "1.0"

exchanges:
  update:
    - itemId: 11001
      changes:
        buyPriceMedal: 150

Updates the medal price for an existing exchange entry.

Update Medal Currency

spec:
  version: "1.0"

exchanges:
  update:
    - itemId: 11001
      changes:
        medalItemId: 90003
        buyPriceMedal: 200

Changes both the medal currency type and price for an exchange entry.

Delete

spec:
  version: "1.0"

exchanges:
  delete:
    - 11001
    - 11002

Removes exchange entries for the specified item IDs.

Upsert

spec:
  version: "1.0"

exchanges:
  upsert:
    - itemId: 11004
      buyPriceMedal: 300
      medalItemId: 90001

Creates the exchange entry if item 11004 doesn’t exist in the exchange list, or updates it completely if it does.

---

Properties Reference

Exchange

Property	Type	Since	Required	Description
itemId	int	v92	Yes	Unique identifier of the item being sold in this exchange entry
buyPriceMedal	int	v92	Yes	Number of medals required to purchase this item
medalItemId	int	v92	Yes	Item template ID of the medal currency used for this exchange

---

XML Structure

ItemMedalExchange uses 2-level nesting:

ItemMedalExchange
└── ExchangeList
    └── Exchange (itemId, buyPriceMedal, medalItemId) [max unbounded]

Example XML:

<ItemMedalExchange>
  <ExchangeList>
    <Exchange itemId="11001" buyPriceMedal="100" medalItemId="90001" />
    <Exchange itemId="11002" buyPriceMedal="250" medalItemId="90001" />
    <Exchange itemId="11003" buyPriceMedal="500" medalItemId="90002" />
  </ExchangeList>
</ItemMedalExchange>

---

Common Pitfalls

• Item ID as Key: The itemId uniquely identifies each exchange entry. You cannot have multiple exchange entries for the same item ID—use different medal currencies or pricing tiers via separate item templates if needed.

• Medal Item ID Reference: The medalItemId must reference a valid item in ItemTemplate.xml that serves as the medal currency. Using an invalid ID will cause the exchange to fail at runtime.

• All Fields Required: Unlike some other schemas, all three fields (itemId, buyPriceMedal, medalItemId) are required for every exchange entry. Omitting any field will cause validation errors.

• Regional Variants: ItemMedalExchange supports regional file variants (_JP, _KR, _NAEU, etc.). Ensure you’re modifying the correct regional file for your target deployment.

• Positive Values Only: Both buyPriceMedal and medalItemId must be positive integers. Zero or negative values will cause validation failures.

• No Client Sync: This entity does not have a client-side DataCenter equivalent. Changes to ItemMedalExchange only affect server-side data.