DarkRiftEventTaskData

Version support

Version	Status
v92	Full
v90	-
v86	-

---

DarkRiftEventTaskData.xml defines Dark Rift event task sequences: task categories containing ordered steps, each with NPC group spawn assignments that execute during rift encounters.

---

DSL support

Entity: darkRiftEventTaskDatas Operations: create, update, upsert, delete File organization: SingleFile — DarkRiftEventTaskData.xml

---

Quick recipes

Create

spec:
  version: "1.0"
  schema: v92

darkRiftEventTaskDatas:
  create:
    - darkRiftEventTaskDataId: 1
      npcGuildId: 609
      eventTaskCategories:
        - id: 1
          eventTaskSteps:
            - step: 1
              spawnTime: 5
              style: combat
              broadcastAero: true
              npcGroups:
                - spawnPointId: 1
                  npcGroupTemplateId: 101
                - spawnPointId: 2
                  npcGroupTemplateId: 102
            - step: 2
              spawnTime: 10
              string: "@darkrift:phase2"
              npcGroups:
                - spawnPointId: 1
                  npcGroupTemplateId: 201

Update

spec:
  version: "1.0"
  schema: v92

darkRiftEventTaskDatas:
  update:
    - darkRiftEventTaskDataId: 1
      changes:
        npcGuildId: 610
        eventTaskCategories:
          - id: 1
            eventTaskSteps:
              - step: 1
                spawnTime: 8

Delete

spec:
  version: "1.0"
  schema: v92

darkRiftEventTaskDatas:
  delete:
    - 1

---

Properties reference

Root attributes

Attribute	Type	Since	Required	Description
darkRiftEventTaskDataId	int	v92	Yes	Entity identifier
npcGuildId	int	v92	No	NPC guild association

Nested elements

Attribute	Type	Since	Description
eventTaskCategories	list[EventTaskCategory]	v92	Task category definitions. See EventTaskCategory.

---

Nested elements

EventTaskCategory

Attribute	Type	Since	Required	Description
id	int	v92	Yes	Category identifier (referenced by DarkRiftData eventTaskCategoryId)
eventTaskSteps	list[EventTaskStep]	v92	No	Ordered step sequence. See EventTaskStep.

EventTaskStep

Attribute	Type	Since	Required	Description
step	int	v92	Yes	Step number (execution order)
spawnTime	int	v92	No	Spawn delay in seconds
string	string	v92	No	Display string (localization key)
style	EventTaskStyle	v92	No	Step visual style. See EventTaskStyle.
broadcastAero	bool	v92	No	Whether to broadcast aero notification
npcGroups	list[EventTaskNpcGroup]	v92	No	NPC groups to spawn. See EventTaskNpcGroup.

EventTaskNpcGroup

Attribute	Type	Since	Required	Description
spawnPointId	int	v92	Yes	Spawn point identifier (index key)
npcGroupTemplateId	int	v92	No	NPC group template reference (from DarkRiftNpcData)

---

Enum types

EventTaskStyle

Value	Description
combat	Combat encounter phase

---

XML structure

DarkRiftEventTaskData.xml
└── DarkRiftEventTaskData
    @npcGuildId
    └── EventTaskCategoryList
        └── EventTaskCategory (0..∞)
            @id
            └── EventTaskStep (0..∞)
                @step @spawnTime @string? @style? @broadcastAero?
                └── EventTaskNpcGroup (0..∞)
                    @spawnPointId @npcGroupTemplateId

---

Common pitfalls

• SpawnPointId as index: NPC groups within a step are indexed by spawnPointId, not by npcGroupTemplateId. The create command writes spawnPointId to the element; a separate update writes npcGroupTemplateId.
• Step ordering: Steps execute in step number order. Ensure step numbers are sequential within each category.
• Category references: The id of an EventTaskCategory is referenced by DarkRiftData entries via the eventTaskCategoryId attribute.
• Singleton entity: Uses SingleFile organization. The darkRiftEventTaskDataId is for DSL operations only.