DungeonData: Event Groups

Part of DungeonData. Event groups are the primary scripting mechanism for dungeon encounters. Each group defines a trigger condition and contains event tasks that execute when triggered.

Nesting structure

DungeonData events use a 4-level hierarchy:

EventGroup (trigger definition)
└── Event (optional quest/text association)
    └── EventTaskGroup (probability-weighted selection)
        └── EventTask (individual scripted action)

Flat syntax (shorthand)

94% of dungeons use the flat tasks shorthand, which omits the Event and EventTaskGroup wrappers. The mapper automatically creates them with default values (single Event, single EventTaskGroup with probability 1.0):

eventGroups:
  - type: enterTerritory
    territoryId: "99001"
    tasks:
      - type: spawn
        next: "none"
        huntingZoneId: 990
        templateId: 100
      - type: message
        next: "none"
        string: "@dungeon:welcome"
        style: combat

Nested syntax (full control)

Use the nested syntax when you need multiple EventTaskGroups with different probabilities, or event-level properties:

eventGroups:
  - type: npcHp
    uniqueId: "990,1000"
    value: "30"
    events:
      - eventTaskGroups:
          - probability: 0.7
            eventTasks:
              - type: spawn
                next: "none"
                huntingZoneId: 990
                templateId: 200
          - probability: 0.3
            eventTasks:
              - type: spawn
                next: "none"
                huntingZoneId: 990
                templateId: 300

EventGroup properties

Property	Type	Since	Description
`type`	`EventGroupType`	v92	Trigger type for the event group
`repeat`	`bool`	v92	Allow the event group to repeat
`uniqueId`	`string`	v92	NPC reference as `huntingZone,templateId`
`value`	`string`	v92	Trigger threshold value
`name`	`string`	v92	Event group name identifier
`id`	`int`	v92	Numeric event group ID
`timerName`	`string`	v92	Referenced timer name
`territoryId`	`string`	v92	Territory ID trigger
`killCountName`	`string`	v92	Kill counter name reference
`triggerUserClass`	`string`	v92	Restrict trigger to player class
`stopWhenDeath`	`bool`	v92	Stop event group on entity death
`eventName`	`string`	v92	Named event reference
`comparison`	`EventGroupComparison`	v92	Value comparison operator
`stopWhenReset`	`bool`	v92	Stop event group on dungeon reset
`targetNpcId`	`string`	v92	Target NPC as `huntingZone,templateId`
`value2`	`string`	v92	Secondary trigger value
`logRecord`	`bool`	v92	Enable log recording
`checkVillagerMenu`	`bool`	v92	Check villager menu state
`phaseLevel`	`int`	v92	Dungeon phase level requirement
`stopWhenCombat`	`bool`	v92	Stop event group when combat starts
`repeatAlive`	`bool`	v92	Repeat only while NPC is alive
`needAllMember`	`bool`	v92	Require all party members present
`next`	`string`	v92	Next event group reference
`nextValue`	`string`	v92	Parameter for next event group
`tasks`	`list`	v92	Flat task list (shorthand syntax)
`events`	`list`	v92	Nested event list (full syntax)

Event properties

Property	Type	Since	Description
`questId`	`string`	v92	Associated quest ID
`taskId`	`string`	v92	Associated quest task ID
`textId`	`string`	v92	Display text string ID
`repeat`	`bool`	v92	Allow event to repeat
`eventTaskGroups`	`list`	v92	Weighted task group list

EventTaskGroup properties

Property	Type	Since	Description
`probability`	`decimal`	v92	Selection weight (0.0-1.0)
`eventTasks`	`list`	v92	Task entries in this group

Enum types

EventGroupType

Value	Since	Description
`"none"`	v92	No trigger (manual activation)
`npcHp`	v92	NPC HP threshold reached
`flag`	v92	Flag value changed
`timer`	v92	Timer expired
`enterTerritory`	v92	Player enters territory
`npcReset`	v92	NPC reset to initial state
`eliminate`	v92	All target NPCs eliminated
`killCount`	v92	Kill count threshold reached
`npcState`	v92	NPC state changed
`questProgress`	v92	Quest progress updated
`initialize`	v92	Dungeon initialization
`Workobject`	v92	Work object interaction
`talkNpc`	v92	NPC dialogue triggered
`eventGage`	v92	Event gauge threshold reached
`eliminateRepeatly`	v92	Repeated elimination trigger
`npcPartBreak`	v92	NPC part destroyed
`annihilated`	v92	Party wiped
`questFail`	v92	Quest objective failed
`userCountInTerritory`	v92	Player count in territory changed
`leaveTerritory`	v92	Player leaves territory
`phaseInitialize`	v92	Phase initialization
`userCountInDungeon`	v92	Player count in dungeon changed

EventGroupComparison

Value	Since	Description
`"none"`	v92	No comparison (exact match)
`gt`	v92	Greater than
`lt`	v92	Less than