DarkRiftReward

Version support

Version	Status
v92	Full
v90	-
v86	-

---

DarkRiftReward.xml defines Dark Rift reward tables: mail parcel settings, point-threshold rewards, personal participation rewards, and NPC kill point values.

---

DSL support

Entity: darkRiftRewards Operations: create, update, upsert, delete File organization: SingleFile — DarkRiftReward.xml

---

Quick recipes

Create

spec:
  version: "1.0"
  schema: v92

darkRiftRewards:
  create:
    - darkRiftRewardId: 1
      rewardParcel:
        senderId: "@darkrift:sender"
        title: "@darkrift:reward_title"
        text: "@darkrift:reward_body"
      eachPointRewards:
        - id: 1
          min: 0
          max: 100
          itemTemplateId: 200001
          itemCount: 1
        - id: 2
          min: 101
          max: 500
          itemTemplateId: 200002
          itemCount: 3
      personalRewards:
        - id: 1
          min: 0
          max: 100
          itemTemplateId: 200010
          itemCount: 1
          reputationId: 609
          reputationPoint: 50
      npcKillPoints:
        - templateId: 88001
          point: 10
        - templateId: 88002
          point: 25

Update

spec:
  version: "1.0"
  schema: v92

darkRiftRewards:
  update:
    - darkRiftRewardId: 1
      changes:
        rewardParcel:
          senderId: "@darkrift:new_sender"
        eachPointRewards:
          - id: 1
            itemCount: 2

Delete

spec:
  version: "1.0"
  schema: v92

darkRiftRewards:
  delete:
    - 1

---

Properties reference

Root attributes

Attribute	Type	Since	Required	Description
darkRiftRewardId	int	v92	Yes	Entity identifier

Nested elements

Attribute	Type	Since	Description
rewardParcel	RewardParcel	v92	Mail delivery settings. See RewardParcel.
eachPointRewards	list[EachPointReward]	v92	Point-threshold rewards. See EachPointReward.
personalRewards	list[PersonalReward]	v92	Participation rewards. See PersonalReward.
npcKillPoints	list[NpcKillPoint]	v92	Kill point values. See NpcKillPoint.

---

Nested elements

RewardParcel

Mail parcel configuration for reward delivery.

Attribute	Type	Since	Required	Description
senderId	string	v92	Yes	Mail sender (localization key)
title	string	v92	Yes	Mail title (localization key)
text	string	v92	Yes	Mail body (localization key)

EachPointReward

Rewards granted based on accumulated point thresholds.

Attribute	Type	Since	Required	Description
id	int	v92	Yes	Reward tier identifier
min	int	v92	No	Minimum point threshold. Defaults to 1
max	int	v92	No	Maximum point threshold. Defaults to 1
itemTemplateId	int	v92	Yes	Reward item template
itemCount	int	v92	No	Number of items awarded

PersonalReward

Rewards granted to individual participants based on contribution.

Attribute	Type	Since	Required	Description
id	int	v92	Yes	Reward tier identifier
min	int	v92	No	Minimum contribution threshold. Defaults to 1
max	int	v92	No	Maximum contribution threshold. Defaults to 1
itemTemplateId	int	v92	Yes	Reward item template
itemCount	int	v92	No	Number of items awarded
reputationId	int	v92	No	Reputation faction ID
reputationPoint	int	v92	No	Reputation points awarded

NpcKillPoint

Point values assigned for killing specific NPCs.

Attribute	Type	Since	Required	Description
templateId	int	v92	Yes	NPC template identifier
point	int	v92	No	Points awarded per kill

---

XML structure

DarkRiftReward.xml
└── DarkRiftReward
    ├── Common
    │   └── RewardParcel
    │       @senderId @title @text
    ├── EachPointReward
    │   └── Reward (0..5)
    │       @id @min @max @itemTemplateId @itemCount
    ├── PersonalReward
    │   └── Reward (0..5)
    │       @id @min @max @itemTemplateId @itemCount @reputationId @reputationPoint
    ├── FailureReward (empty)
    └── NpcKillPoint
        └── Npc (0..∞)
            @templateId @point

---

Common pitfalls

• Singleton entity: Uses SingleFile organization. The darkRiftRewardId is for DSL operations only.
• Reward tier ranges: min and max define point ranges. Ensure ranges are contiguous and non-overlapping across tiers.
• Localization keys: senderId, title, and text in rewardParcel should be localization references (e.g., @darkrift:sender).
• Related schemas: NPC template IDs in npcKillPoints reference NPC Data entries. Item template IDs reference Item Template entries.