DarkRiftNpcData

Version support

Version	Status
v92	Full
v90	-
v86	-

---

DarkRiftNpcData.xml defines Dark Rift NPC configurations: NPC group templates, defence group templates, extra NPC spawn sets, and player-count-based combat/compensation balance scaling.

---

DSL support

Entity: darkRiftNpcDatas Operations: create, update, upsert, delete File organization: SingleFile — DarkRiftNpcData.xml

---

Quick recipes

Create

spec:
  version: "1.0"
  schema: v92

darkRiftNpcDatas:
  create:
    - darkRiftNpcDataId: 1
      npcTemplateHuntingZoneId: 735
      npcGroupTemplates:
        - id: 1
          completeSpawnTime: 10
          npcs:
            - npcTemplateId: 88001
              combatBalanceId: 1
              spawnCount: 3
              type: "normal"
      combatBalanceGroups:
        - id: 1
          balances:
            - minUserCount: 1
              maxUserCount: 5
              abnormalityId: 470200
              pushCount: 3
              bonusReputationRatio: 1.0

Update

spec:
  version: "1.0"
  schema: v92

darkRiftNpcDatas:
  update:
    - darkRiftNpcDataId: 1
      changes:
        npcTemplateHuntingZoneId: 740
        npcGroupTemplates:
          - id: 1
            completeSpawnTime: 15

Delete

spec:
  version: "1.0"
  schema: v92

darkRiftNpcDatas:
  delete:
    - 1

---

Properties reference

Root attributes

Attribute	Type	Since	Required	Description
darkRiftNpcDataId	int	v92	Yes	Entity identifier
npcTemplateHuntingZoneId	int	v92	No	Hunting zone for NPC templates

Nested elements

Attribute	Type	Since	Description
npcGroupTemplates	list[NpcGroupTemplate]	v92	NPC spawn group templates. See NpcGroupTemplate.
defenceGroupTemplates	list[DefenceGroupTemplate]	v92	Defence NPC groups. See DefenceGroupTemplate.
notCateDefenceNpcTemplateId	list[int]	v92	NPC template IDs excluded from defence categorization
extraNpcSets	list[ExtraNpcSet]	v92	Extra NPC spawn sets. See ExtraNpcSet.
combatBalanceGroups	list[CombatBalanceGroup]	v92	Combat balance scaling. See CombatBalanceGroup.
compensationBalanceGroups	list[CompensationBalanceGroup]	v92	Reward balance scaling. See CompensationBalanceGroup.

---

Nested elements

NpcGroupTemplate

Attribute	Type	Since	Required	Description
id	int	v92	Yes	Template group identifier
completeSpawnTime	int	v92	No	Time in seconds to complete spawning
npcs	list[Npc]	v92	No	NPC entries in this group. See Npc.

Npc

Attribute	Type	Since	Required	Description
npcTemplateId	int	v92	Yes	NPC template reference
combatBalanceId	int	v92	No	Combat balance group reference
spawnCount	int	v92	No	Number of NPCs to spawn
type	string	v92	No	NPC type classification
returnDistance	string	v92	No	Leash distance

DefenceGroupTemplate

Attribute	Type	Since	Required	Description
id	int	v92	Yes	Defence group identifier
mainDefenceNpcs	list[MainDefenceNpc]	v92	No	Main defence NPCs. See MainDefenceNpc.

MainDefenceNpc

Attribute	Type	Since	Required	Description
mainDefenceId	int	v92	Yes	Main defence position identifier
dir	int	v92	No	Facing direction in degrees
npcTemplateId	int	v92	No	NPC template reference
subDefenceNpcs	list[SubDefenceNpc]	v92	No	Sub-defence NPCs. See SubDefenceNpc.

SubDefenceNpc

Attribute	Type	Since	Required	Description
subDefenceId	int	v92	Yes	Sub-defence position identifier
npcTemplateId	int	v92	No	NPC template reference

ExtraNpcSet

Attribute	Type	Since	Required	Description
id	int	v92	Yes	Extra NPC set identifier
spawnStartTime	int	v92	No	Spawn window start (seconds)
spawnEndTime	int	v92	No	Spawn window end (seconds)
spawnInterval	int	v92	No	Interval between spawns (seconds)
spawnTriggingCount	int	v92	No	Player count threshold to trigger spawns
completeSpawnTime	int	v92	No	Time to complete spawning (seconds)

CombatBalanceGroup

Attribute	Type	Since	Required	Description
id	int	v92	Yes	Balance group identifier
balances	list[CombatBalance]	v92	No	Balance tiers. See CombatBalance.

CombatBalance

Attribute	Type	Since	Required	Description
minUserCount	int	v92	Yes	Minimum players for this tier
maxUserCount	int	v92	No	Maximum players for this tier
abnormalityId	int	v92	No	Scaling abnormality applied
pushCount	int	v92	No	Push mechanics count
bonusReputationRatio	decimal	v92	No	Reputation bonus multiplier

CompensationBalanceGroup

Attribute	Type	Since	Required	Description
id	int	v92	Yes	Compensation group identifier
balances	list[CompensationBalance]	v92	No	Balance tiers. See CompensationBalance.

CompensationBalance

Attribute	Type	Since	Required	Description
minUserCount	int	v92	Yes	Minimum players for this tier
maxUserCount	int	v92	No	Maximum players for this tier
abnormalityId	string	v92	No	Scaling abnormality
pushCount	string	v92	No	Push mechanics configuration

---

XML structure

DarkRiftNpcData.xml
└── DarkRiftNpcData
    @npcTemplateHuntingZoneId
    ├── NpcGroupTemplateList
    │   └── NpcGroupTemplate (0..∞)
    │       @id @completeSpawnTime
    │       └── Npc (0..3)
    │           @npcTemplateId @combatBalanceId @spawnCount @type @returnDistance
    ├── DefenceNpcTemplateList
    │   └── DefenceGroupTemplate (0..∞)
    │       @id
    │       └── MainDefenceNpc (0..∞)
    │           @mainDefenceId @dir @npcTemplateId
    │           └── SubDefenceNpc (0..4)
    │               @subDefenceId @npcTemplateId
    ├── NotCateDefenceNpc
    │   @npcTemplateId (comma-separated list)
    ├── ExtraNpcSetList
    │   └── ExtraNpcSet (0..∞)
    │       @id @spawnStartTime @spawnEndTime @spawnInterval
    │       @spawnTriggingCount @completeSpawnTime
    ├── CombatBalanceGroupList
    │   └── CombatBalanceGroup (0..∞)
    │       @id
    │       └── Balance (0..8)
    │           @minUserCount @maxUserCount @abnormalityId @pushCount @bonusReputationRatio
    └── CompensationBalanceGroupList
        └── CompensationBalanceGroup (0..∞)
            @id
            └── Balance (0..10)
                @minUserCount @maxUserCount @abnormalityId @pushCount

---

Common pitfalls

• Singleton entity: Like DarkRiftData, this uses SingleFile organization. The darkRiftNpcDataId is for DSL operations only.
• Balance tier ordering: Combat and compensation balance tiers should be ordered by minUserCount ascending without overlapping ranges.
• NPC template references: The npcTemplateId values reference NPC Data entries. Ensure referenced NPCs exist in the target dataset.
• Related schemas: NPC group templates are referenced by DarkRiftData (via hunting zone dark rifts) and DarkRiftEventTaskData (via event task NPC groups).