DarkRiftData

Version support

Version	Status
v92	Full
v90	-
v86	-

DarkRiftData.xml defines the Dark Rift world event system: global settings, hunting zone configurations, rift instance definitions, event group schedules, and item/QAC rift variants.

DSL support

Entity: darkRiftDatas Operations: create, update, upsert, delete File organization: SingleFile — DarkRiftData.xml

Quick recipes

Create

spec:
  version: "1.0"
  schema: v92

darkRiftDatas:
  create:
    - darkRiftDataId: 1
      reserveMaxDayInAdvance: 7
      restartTerritoryTime: 300
      lifeTime: 3600
      availableMinLevel: 65
      abnormalityId: 470100
      abnormalityInterval: 30
      maxEnterCount: 3
      resetHour: 7
      worldMap:
        worldId: 1
        sectionId: 1
        guardId: 1
      huntingZones:
        - id: 735
          broadcastMinLevel: 65
          broadcastMaxLevel: 70
          broadcastTerritoryId: 735
          closeCountdownTemplateId: "0"
          destroyAbnormalityId: 470101
          extraOpenCount: 1
          extraOpenUserCount: 20
          darkRifts:
            - id: 1
              type: Normal
              territoryId: 735
              completeBonusRatio: 1.5
              expandInterval: 600
              respawnTime: 120
              eventTaskCategoryId: 1
              startQuestId: 99001

Update

spec:
  version: "1.0"
  schema: v92

darkRiftDatas:
  update:
    - darkRiftDataId: 1
      changes:
        lifeTime: 7200
        maxEnterCount: 5
        huntingZones:
          - id: 735
            broadcastMaxLevel: 75

Delete

spec:
  version: "1.0"
  schema: v92

darkRiftDatas:
  delete:
    - 1

Properties reference

Root attributes

Attribute	Type	Since	Required	Description
`darkRiftDataId`	`int`	v92	Yes	Entity identifier
`reserveMaxDayInAdvance`	`int`	v92	No	Maximum days in advance to reserve
`restartTerritoryTime`	`int`	v92	No	Territory restart time in seconds
`extraNpcRandomPosMinDist`	`int`	v92	No	Minimum distance for extra NPC random positioning
`lifeTime`	`int`	v92	No	Rift lifetime in seconds
`availableMinLevel`	`int`	v92	No	Minimum character level to participate
`abnormalityId`	`int`	v92	No	Abnormality applied during event
`abnormalityInterval`	`int`	v92	No	Interval between abnormality applications
`maxEnterCount`	`int`	v92	No	Maximum entries per reset period
`resetHour`	`int`	v92	No	Daily reset hour

Nested elements

Attribute	Type	Since	Description
`worldMap`	`WorldMap`	v92	World map display configuration. See WorldMap.
`huntingZones`	`list[HuntingZone]`	v92	Hunting zone definitions. See HuntingZone.
`eventGroups`	`list[EventGroup]`	v92	Event scheduling groups. See EventGroup.
`itemDarkRifts`	`list[ItemDarkRift]`	v92	Item-triggered rift variants. See ItemDarkRift.
`qacDarkRifts`	`list[QacDarkRift]`	v92	QAC rift variants. See QacDarkRift.
`groupInfos`	`list[GroupInfo]`	v92	Dungeon group info. See GroupInfo.

Nested elements

WorldMap

Attribute	Type	Since	Required	Description
`worldId`	`int`	v92	Yes	World identifier
`sectionId`	`int`	v92	Yes	Map section identifier
`guardId`	`int`	v92	Yes	Guard area identifier

HuntingZone

Attribute	Type	Since	Required	Description
`id`	`int`	v92	Yes	Hunting zone identifier
`broadcastMinLevel`	`int`	v92	No	Minimum level for broadcast notifications
`broadcastMaxLevel`	`int`	v92	No	Maximum level for broadcast notifications
`broadcastTerritoryId`	`int`	v92	No	Territory ID for broadcasts
`closeCountdownTemplateId`	`string`	v92	No	Countdown template for closing
`destroyAbnormalityId`	`int`	v92	No	Abnormality applied on rift destruction
`extraOpenCount`	`int`	v92	No	Extra open attempts allowed
`extraOpenUserCount`	`int`	v92	No	User count threshold for extra opens
`failureSpawnNpcId`	`string`	v92	No	NPC spawned on failure
`lastDestroySpawnNpcId`	`int`	v92	No	NPC spawned on last destruction
`maxSpawnCount`	`string`	v92	No	Maximum spawn count
`nonPkSectionId`	`string`	v92	No	Non-PK section identifier
`successSpawnNpcId`	`string`	v92	No	NPC spawned on success
`darkRifts`	`list[DarkRift]`	v92	No	Rift instances. See DarkRift.

DarkRift

Attribute	Type	Since	Required	Description
`id`	`int`	v92	Yes	Rift instance identifier
`type`	`DarkRiftType`	v92	No	Rift type. See DarkRiftType.
`territoryId`	`int`	v92	No	Territory where rift spawns
`completeBonusRatio`	`decimal`	v92	No	Bonus ratio on completion
`expandInterval`	`int`	v92	No	Expansion interval in seconds
`respawnTime`	`int`	v92	No	Respawn time in seconds
`respawnRandomTime`	`string`	v92	No	Random respawn time variance
`eventTaskCategoryId`	`int`	v92	No	Associated event task category
`startQuestId`	`int`	v92	No	Quest triggered on start
`questNpcTerritoryId`	`int`	v92	No	Territory for quest NPC
`questRange`	`string`	v92	No	Quest level range
`questUserCount`	`int`	v92	No	Required user count for quest
`prepareCountdownTemplateId`	`int`	v92	No	Preparation countdown template
`autoPartyMatchingLevelRange`	`string`	v92	No	Auto-party matching level range
`defenceGroups`	`list[DefenceGroup]`	v92	No	Defence group data. See DefenceGroup.

DefenceGroup

Attribute	Type	Since	Required	Description
`defenceGroupId`	`int`	v92	Yes	Defence group identifier
`territoryId`	`int`	v92	No	Territory identifier
`defenceDatas`	`list[DefenceData]`	v92	No	Defence data entries. See DefenceData.

DefenceData

Attribute	Type	Since	Required	Description
`subId`	`int`	v92	Yes	Defence sub-identifier
`territoryId`	`int`	v92	No	Territory identifier
`spawnPoints`	`list[SpawnPoint]`	v92	No	Monster spawn points. See SpawnPoint.

SpawnPoint

Attribute	Type	Since	Required	Description
`id`	`int`	v92	Yes	Spawn point identifier
`monsterTerritoryId`	`int`	v92	No	Monster territory reference

EventGroup

Attribute	Type	Since	Required	Description
`id`	`int`	v92	Yes	Event group identifier
`eventDay`	`int`	v92	No	Day of the event cycle
`spawnCount`	`int`	v92	No	Number of rifts to spawn
`targetHuntingZones`	`list[TargetHuntingZone]`	v92	No	Target zones. See TargetHuntingZone.
`timeLines`	`list[Time]`	v92	No	Schedule entries. See Time.

TargetHuntingZone

Attribute	Type	Since	Required	Description
`id`	`int`	v92	Yes	Hunting zone identifier
`baseSpawnCount`	`int`	v92	No	Base number of spawns
`probability`	`decimal`	v92	No	Spawn probability (0.0–1.0)

Time

Attribute	Type	Since	Required	Description
`base`	`int`	v92	Yes	Base time (hour of day)
`lifeTime`	`int`	v92	No	Duration in seconds
`openCountdownTemplateId`	`int`	v92	No	Countdown template when opening
`randomMinute`	`int`	v92	No	Random minute variance

ItemDarkRift

Attribute	Type	Since	Required	Description
`id`	`int`	v92	Yes	Item rift identifier
`type`	`DarkRiftType`	v92	No	Rift type
`itemTemplateId`	`int`	v92	No	Trigger item template
`completeBonusRatio`	`decimal`	v92	No	Bonus ratio on completion
`expandInterval`	`int`	v92	No	Expansion interval
`eventTaskCategoryId`	`int`	v92	No	Event task category
`questRange`	`string`	v92	No	Quest level range
`autoPartyMatchingLevelRange`	`string`	v92	No	Auto-party matching range

QacDarkRift

Attribute	Type	Since	Required	Description
`id`	`int`	v92	Yes	QAC rift identifier
`type`	`DarkRiftType`	v92	No	Rift type
`completeBonusRatio`	`decimal`	v92	No	Bonus ratio on completion
`expandInterval`	`int`	v92	No	Expansion interval
`eventTaskCategoryId`	`int`	v92	No	Event task category
`questRange`	`string`	v92	No	Quest level range
`autoPartyMatchingLevelRange`	`string`	v92	No	Auto-party matching range

GroupInfo

Attribute	Type	Since	Required	Description
`id`	`int`	v92	Yes	Group info identifier
`clearMinute`	`int`	v92	No	Clear time limit in minutes
`dungeonList`	`string`	v92	No	Comma-separated dungeon IDs

Enum types

DarkRiftType

Value	Description
`Normal`	Standard dark rift
`raid`	Raid-level dark rift

XML structure

DarkRiftData.xml
└── DarkRiftData
    @reserveMaxDayInAdvance @restartTerritoryTime @extraNpcRandomPosMinDist
    @lifeTime @availableMinLevel @abnormalityId @abnormalityInterval
    @maxEnterCount @resetHour
    ├── WorldMap
    │   @worldId @sectionId @guardId
    ├── HuntingZone (0..3)
    │   @id @broadcastMinLevel @broadcastMaxLevel @broadcastTerritoryId ...
    │   └── DarkRift (0..3)
    │       @id @type @territoryId @completeBonusRatio @expandInterval ...
    │       └── DefenceGroupData (0..∞)
    │           @defenceGroupId @territoryId
    │           └── DefenceData (0..4)
    │               @subId @territoryId
    │               └── SpawnPoint (0..3)
    │                   @id @monsterTerritoryId
    ├── EventGroup (0..7)
    │   @id @eventDay @spawnCount
    │   ├── Target
    │   │   └── HuntingZone (0..3)
    │   │       @id @baseSpawnCount @probability
    │   └── TimeLine
    │       └── Time (0..9)
    │           @base @lifeTime @openCountdownTemplateId @randomMinute
    ├── Item
    │   └── DarkRift (0..∞)
    │       @id @type @itemTemplateId @completeBonusRatio ...
    ├── QAC
    │   └── DarkRift (0..∞)
    │       @id @type @completeBonusRatio ...
    └── DungeonGroup
        └── GroupInfo (0..∞)
            @id @clearMinute @dungeonList

Common pitfalls

Deeply nested structure: DarkRiftData has up to 5 levels of nesting (Root → HuntingZone → DarkRift → DefenceGroupData → DefenceData → SpawnPoint). Plan YAML structure carefully.
Singleton entity: This entity uses SingleFile organization with no key attributes on the root element. The darkRiftDataId is used for DSL operations but the XML has a single root.
Related schemas: DarkRiftData references DarkRiftNpcData (via NPC templates), DarkRiftEventTaskData (via eventTaskCategoryId), and DarkRiftReward (for reward configuration).