VillagerMenuItem

Overview

Defines villager shop menu entries for NPC merchants under VillagerData/VillagerMenuItem.xml. Each entry associates an item template with a shop type category (medal store or floating castle parts store).

Version support

Version	Status
v92	Full
v90	-
v86	-

---

DSL support

Entity: villagerMenuItems Operations: create, update, delete, upsert, updateWhere Regional variants: _CN, _JP, _KR, _NAEU, _RUS, _THA, _TW

---

Properties reference

Attribute	Type	Since	Required	Description
id	int	v92	Yes	Entry ID (primary key)
itemTemplateId	int	v92	No	Item template this entry references
type	VillagerMenuItemType	v92	No	Shop category. Defaults to MedalStore

---

Enum types

VillagerMenuItemType

Value	Since	Description
MedalStore	v92	Medal-based shop (default)
FloatingCastlePartsStore	v92	Floating castle parts shop

---

DSL examples

Create

spec:
  version: "1.0"
  schema: v92

villagerMenuItems:
  create:
    - id: 99001
      itemTemplateId: 12345
      type: MedalStore

Update

spec:
  version: "1.0"
  schema: v92

villagerMenuItems:
  update:
    - id: 99001
      changes:
        itemTemplateId: 99999

Delete

spec:
  version: "1.0"
  schema: v92

villagerMenuItems:
  delete:
    - 99001

Upsert

spec:
  version: "1.0"
  schema: v92

villagerMenuItems:
  upsert:
    - id: 99001
      itemTemplateId: 12345
      type: FloatingCastlePartsStore

Update where

spec:
  version: "1.0"
  schema: v92

villagerMenuItems:
  updateWhere:
    - filter:
        type: MedalStore
      changes:
        itemTemplateId: 99999

---

XML structure

VillagerMenuItems (root)
└── VillagerMenuItem (id, itemTemplateId, type)

---

Notes

• type defaults to MedalStore when omitted on create or upsert.
• Regional variants are stored under VillagerData/ (e.g., VillagerData/VillagerMenuItem_NAEU.xml).