Reputation Item

Version support

Version	Status
v92	Full
v90	-
v86	-

---

ReputationItem.xml defines NPC guild reputation shops: each guild has a list of items purchasable with reputation points.

Guild entries are identified by npcGuildId.

---

DSL support

Entity: reputationItems Operations: create, update, delete, upsert File organization: SingleFile — ReputationItem.xml

---

Quick recipes

Create

spec:
  version: "1.0"
  schema: v92

reputationItems:
  create:
    - npcGuildId: 610
      items:
        - id: 1
          name: "Reputation Potion"
          desc: "Restores 500 HP"
          grade: 1
          reputationPoint: 100
        - id: 2
          name: "Reputation Scroll"
          desc: "Increases EXP gain"
          grade: 2
          reputationPoint: 250

Update

spec:
  version: "1.0"
  schema: v92

reputationItems:
  update:
    - npcGuildId: 610
      changes:
        items:
          - id: 1
            name: "Enhanced Potion"
            reputationPoint: 150

Delete

spec:
  version: "1.0"
  schema: v92

reputationItems:
  delete:
    - npcGuildId: 610

Upsert

spec:
  version: "1.0"
  schema: v92

reputationItems:
  upsert:
    - npcGuildId: 620
      items:
        - id: 1
          name: "Guild Token"
          grade: 1
          reputationPoint: 50

---

Properties reference

NPC guild attributes

Attribute	Type	Since	Required	Description
npcGuildId	int	v92	Yes	Unique NPC guild identifier
items	list[Item]	v92	No	Reputation shop items. See Item.

---

Nested elements

Item

Defines a purchasable item in the guild reputation shop. When items is specified, all existing item elements are replaced (clear-and-replace).

Attribute	Type	Since	Required	Description
id	int	v92	No	Item entry identifier
name	string	v92	No	Item name
desc	string	v92	No	Item description
grade	int	v92	No	Item grade/tier
reputationPoint	int	v92	No	Reputation point cost

---

XML structure

ReputationItem.xml
└── NpcGuild (0..∞)
    @id (key)
    └── SellItem
        └── Item (0..∞)
            @id @name @desc @grade @reputationPoint

---

Common pitfalls

• SellItem wrapper: In XML, items are nested under a SellItem wrapper element inside each NpcGuild. The DSL flattens this — specify items directly on the guild entry.
• Item replacement: Specifying items replaces all existing Item elements under that guild’s SellItem wrapper.
• ID attribute: The YAML alias is npcGuildId, which maps to the XML id attribute on the NpcGuild element.