Skip to content

DungeonData: Event Tasks

Part of DungeonData > Event Groups. Event tasks are the individual scripted actions within the dungeon event system. Each task has a type that determines which properties are relevant.


PropertyTypeSinceDescription
typeEventTaskTypev92Task action type
nextEventTaskNextv92Completion trigger mode
nextValuestringv92Parameter for the next trigger
idintv92Numeric task ID
namestringv92Task name identifier
valuestringv92Primary parameter value
vlaueintv92Numeric value (preserved typo from source data)
stringstringv92String parameter
completionboolv92Mark task as completion trigger
repeatboolv92Allow task to repeat
PropertyTypeSinceDescription
huntingZoneIdintv92Target hunting zone ID
templateIdintv92NPC template ID
targetNpcIdNpcRefv92Target NPC reference (huntingZone,templateId)
targetBossIdNpcRefv92Boss NPC reference (huntingZone,templateId)
targetNpcNpcRefv92Target NPC reference (huntingZone,templateId)
targetEventTaskTargetv92Effect target selector
targetTypeEventTaskTargetTypev92Target selection method
targetTemplateIdstringv92Target NPC template ID
targetUserClassstringv92Restrict to player class
npcTemplateIdstringv92NPC template ID reference
aliveOnlyboolv92Apply only to living targets
npcHpstringv92NPC HP threshold reference
startAggroboolv92Start aggro on task execution
aggroIntervalintv92Aggro check interval in milliseconds
aggroRangeintv92Aggro detection range
PropertyTypeSinceDescription
territoryIdstringv92Target territory ID
exceptTerritoryIdstringv92Excluded territory ID
exceptHuntingZoneIdintv92Excluded hunting zone ID
continentIdintv92Target continent ID
posdecimal[]v92Position coordinates [x, y, z]
posTypeEventTaskPosTypev92Position coordinate type
positionslist[Pos]v92Position waypoint list
dirstringv92Direction parameter
directionEventTaskDirectionv92Movement direction
startPointstringv92Spawn start point reference
PropertyTypeSinceDescription
abnormalityIdintv92Abnormality ID to apply/remove
targetAbnormalityKindintv92Target abnormality kind filter
exceptTargetAbnormalityKindintv92Excluded abnormality kind filter
previousTargetAbnormalityKindintv92Previous target abnormality kind
PropertyTypeSinceDescription
timeintv92Duration in milliseconds
timeValueintv92Time parameter value
timerTypeEventTaskTimerTypev92Timer behavior type
timernamestringv92Timer name reference (lowercase alias)
timerLogEventTaskTimerLogv92Timer log action
timerUiOffboolv92Hide timer UI element
delayTimeintv92Execution delay in milliseconds
PropertyTypeSinceDescription
stateEventTaskStatev92State to set
stateTypeEventTaskStateTypev92State scope type
actionEventTaskActionv92Action to perform
turnEventTaskTurnv92Toggle on/off state
doorEventTaskDoorv92Door open/close action
phaseLevelintv92Dungeon phase level
stageLogboolv92Enable stage logging
PropertyTypeSinceDescription
styleEventTaskStylev92Display or behavior style
uiStylestringv92UI display style
uiOnboolv92Show UI element
uiOffboolv92Hide UI element
messagestringv92Message string reference
tipstringv92Tooltip string reference
chatstringv92Chat message reference
chatTypeEventTaskChatTypev92Chat channel type
nameIdintv92Name string ID
patternGuideEventTaskPatternGuidev92Pattern guide UI type
patternShowTimeintv92Pattern guide display duration in ms
PropertyTypeSinceDescription
soundTypeEventTaskSoundTypev92Audio type category
soundIdintv92Sound asset ID
playTimeintv92Playback duration in milliseconds
effectSoundIdintv92Effect sound asset ID
countdownTimesstringv92Countdown time points
PropertyTypeSinceDescription
aiidintv92AI template ID to assign
patternListIdstringv92Pattern list reference ID
actionScriptIdintv92Action script reference ID
resetNpcHpDungeonTaskboolv92Reset NPC HP for dungeon task
strictlyboolv92Enforce strict matching
precheckForTargetCountboolv92Pre-check target count before execution
logUpdateboolv92Enable log updates
PropertyTypeSinceDescription
partIdintv92NPC part ID
breakStageIdintv92Part break stage ID
cylinderIdintv92NPC cylinder ID
customWaitAnimstringv92Custom wait animation name
customRunAnimstringv92Custom run animation name
objectIdintv92World object ID
groupIdintv92Visual BG group ID
PropertyTypeSinceDescription
minintv92Minimum range value
maxintv92Maximum range value
maxValueintv92Maximum parameter value
questIdintv92Associated quest ID
taskIdintv92Associated quest task ID
triggerNamestringv92Named trigger reference
killCountNamestringv92Kill counter name reference
rememberMinuteintv92Duration to remember in minutes

Composite NPC reference that serializes to huntingZone,templateId format in XML.

PropertyTypeSinceDescription
huntingZoneintv92Hunting zone ID
templateIdintv92NPC template ID
targetNpcId:
huntingZone: 990
templateId: 1000
# Produces: targetNpcId="990,1000"

Position waypoint for multi-point movement tasks.

PropertyTypeSinceDescription
valuedecimal[]v92Coordinates [x, y, z]

Event task action types. Each type defines a different scripted action.

ValueSince
abnormalityv92
despawnv92
spawnv92
messagev92
flagv92
timerv92
changePatternListv92
soundOnv92
emptyv92
killNpcv92
eventStatev92
eventGagev92
doActionScriptv92
turnAiv92
guideOnv92
killInTerritoryv92
guideOffv92
dynamicGeov92
turnAbnormalityTerritoryv92
rankSystemv92
workObjectDespawnv92
consoleEventv92
workObjectSpawnv92
activeNpcPartBreakv92
playMoviev92
npcAiv92
rankTimerv92
shuttlev92
killCountv92
teleportv92
completev92
dungeonStatev92
phaseRecordv92
additionalWorkUiv92
enterDungeonv92
cleanupv92
soundOffv92
updateQuestv92
timerUiv92
cameraSetv92
lookAtNpcv92
visibleBGv92
setAbnormalityWhenResurrectionv92
setPosv92
tutorialEndv92
npcPartBreakv92
changeNpcCylinderv92
changeNpcAnimv92
setCanFixVehiclev92
bossGagev92
coolTimev92
countdownv92

Event task completion trigger modes.

ValueSince
"none"v92
timev92
completev92
npcHpv92

Target selectors for event task effects.

ValueSince
npcv92
playerv92
aggrov92
objectnpcv92
randomv92
classrandomv92
@classv92
enemyv92

Display or behavior styles for message/UI tasks.

ValueSince
combatv92
@defaultv92
alertv92
speechbubblev92
countdownv92

Actions for stateful event tasks (timers, flags, gauges).

ValueSince
stopv92
startv92
plusv92
minusv92
changev92
movev92
addUserv92
followv92
followOncev92
completev92

Toggle values for on/off event tasks.

ValueSince
"off"v92
"on"v92

Movement direction for NPC scripting.

ValueSince
reversev92
forwardv92

Door state actions.

ValueSince
openv92
closev92

State values for event state tasks.

ValueSince
stopv92
endv92
failv92
startv92
playv92
resetv92
pausev92
clearv92

Audio type categories.

ValueSince
effectSoundv92
bgmv92
additionalbgmv92

Scope for state operations.

ValueSince
EventGroupv92

Position coordinate interpretation.

ValueSince
absolutev92
relativev92

Timer log recording actions.

ValueSince
stopv92
startv92

Pattern guide UI display types.

ValueSince
timeAttackv92
berserkv92
instanceDeathv92
annihilationv92

Target selection methods.

ValueSince
specificNpcv92

Timer behavior types.

ValueSince
rankv92

Chat channel types.

ValueSince
"y"v92