Combat Tasks

Tasks involving monster encounters, combat objectives, and NPC protection.

Task Types

HuntTask — Kill a specified number of monsters.
HuntAndDeliverTask — Kill monsters to collect flag items, then deliver to an NPC.
HuntAndCollectTask — Kill monsters to collect quest items (no delivery required).
GroupHuntTask — Kill monsters from a named monster group definition.
SkillHitTask — Hit targets with a specific skill.
AbnormalStateTask — Apply a status effect to targets a specified number of times.
EscortTask — Escort an NPC to a destination while protecting it from enemies.
GuardianTask — Protect a stationary NPC from attacking enemies.

For properties common to all tasks (header, completion items, journal text) see the Task Overview.

HuntTask

Kill a specified number of monsters.

<이름> discriminator: 사냥Task

Usage
XML Reference

tasks:
  - taskId: 1
    type: HuntTask
    nextTaskId: 2
    journalText: "@quest:1001001"
    body:
      targetCount: 10
      targetId: 12345

YAML property	Type	Description
`targetCount`	`int`	Number of monsters to kill.
`targetId / templateId`	`int`	Monster template ID. `targetId` takes precedence over `templateId`.

YAML property	XML element	XML location
`targetCount`	`<사냥마리수>`	`<Body> → <몬스터지정> → <몬스터지정> (entry)`
`targetId / templateId`	`<몬스터Id>`	`<Body> → <몬스터지정> → <몬스터지정> (entry)`

<Task id="1">
  <Header>
    <Id>1</Id>
    <이름>사냥Task</이름>
    <다음Task>2</다음Task>
    <JournalScript>1</JournalScript>
    <실패시회귀Task/>
  </Header>
  <Body>
    <몬스터지정>
      <몬스터지정>
        <몬스터Id>12345</몬스터Id>
      </몬스터지정>
    </몬스터지정>
    <사냥마리수>10</사냥마리수>
    <저널Text>@quest:1001001</저널Text>
  </Body>
</Task>

HuntAndDeliverTask

Kill monsters to collect flag items, then deliver to an NPC.

<이름> discriminator: 사냥전달Task

Usage
XML Reference

tasks:
  - taskId: 1
    type: HuntAndDeliverTask
    body:
      targetId: 12345
      targetNpc: "63,1001"
      completionDialogue: 5

YAML property	Type	Description
`targetId / templateId`	`int`	Monster template ID.
`sequentialDistribution`	`string`	Sequential distribution mode.
`targetNpc`	`string`	Delivery NPC spec string.
`completionButtonText`	`string`	Completion button label.
`completionDialogue`	`int`	Dialogue ID shown on completion.
`incompleteDialogue`	`int`	Dialogue ID shown when incomplete.

YAML property	XML element	XML location
`targetId / templateId`	`<몬스터Id>`	`<Body> → <아이템작성> → <몬스터지정> → <몬스터지정> (entry)`
`sequentialDistribution`	`<순차분배>`	`<Body> → <아이템작성>`
`targetNpc`	`<대상NPC지정>`	`<Body> → <아이템작성>`
`completionButtonText`	`<완료버튼Text>`	`<Body> → <아이템작성>`
`completionDialogue`	`<완료시대사작성>`	`<Body> → <아이템작성>`
`incompleteDialogue`	`<미완료시대사작성>`	`<Body> → <아이템작성>`

<Body>
  <아이템작성>
    <아이템작성>
      <Flag아이템이름>...</Flag아이템이름>
      <전달수량>1</전달수량>
      <아이콘지정/>
      <몬스터지정>
        <몬스터지정>
          <몬스터Id>12345</몬스터Id>
        </몬스터지정>
      </몬스터지정>
    </아이템작성>
    <대상NPC지정>63,1001</대상NPC지정>
    <완료시대사작성>5</완료시대사작성>
  </아이템작성>
</Body>

HuntAndCollectTask

Kill monsters to collect quest items (no delivery required).

<이름> discriminator: 사냥수집Task

Usage
XML Reference

tasks:
  - taskId: 1
    type: HuntAndCollectTask
    body:
      targetId: 12345
      itemId: 98765

YAML property	Type	Description
`targetId / templateId`	`int`	Monster template ID.
`itemId`	`int`	Item to collect from monsters.

YAML property	XML element	XML location
`targetId / templateId`	`<몬스터Id>`	`<Body> → <몬스터지정> → <몬스터지정> (entry)`
`itemId`	`<획득아이템Id>`	`<Body> → <수집아이템지정> → <수집아이템지정> (entry)`

<Body>
  <수집아이템지정>
    <수집아이템지정>
      <획득아이템Id>98765</획득아이템Id>
      <획득수량>1</획득수량>
    </수집아이템지정>
  </수집아이템지정>
  <몬스터지정>
    <몬스터지정>
      <몬스터Id>12345</몬스터Id>
    </몬스터지정>
  </몬스터지정>
</Body>

GroupHuntTask

Kill monsters from a named monster group definition.

<이름> discriminator: 그룹사냥Task

Usage
XML Reference

tasks:
  - taskId: 1
    type: GroupHuntTask
    body:
      targetCount: 10
      targetId: 12345

YAML property	Type	Description
`targetCount`	`int`	Total kills required.
`targetId / templateId`	`int`	Monster template ID.

YAML property	XML element	XML location
`targetCount`	`<사냥마리수>`	`<Body> → <몬스터그룹> → <몬스터지정> → <몬스터지정> (entry)`
`targetId / templateId`	`<몬스터Id>`	`<Body> → <몬스터그룹> → <몬스터지정> → <몬스터지정> (entry)`

<Body>
  <몬스터그룹>
    <몬스터지정>
      <몬스터지정>
        <몬스터Id>12345</몬스터Id>
        <사냥마리수>10</사냥마리수>
      </몬스터지정>
    </몬스터지정>
  </몬스터그룹>
</Body>

SkillHitTask

Hit targets with a specific skill.

<이름> discriminator: 스킬타격Task

Usage
XML Reference

tasks:
  - taskId: 1
    type: SkillHitTask
    body:
      skillId: 50001
      targetId: 12345

YAML property	Type	Description
`skillId`	`int`	Skill ID to use.
`targetId`	`int / string`	Target spec (monster ID or target type string).

YAML property	XML element	XML location
`skillId`	`<스킬Id>`	`<Body> → <스킬지정> → <스킬지정> (entry)`
`targetId`	`<타격대상>`	`<Body> → <스킬지정> → <스킬지정> (entry)`

<Body>
  <스킬지정>
    <스킬지정>
      <스킬Id>50001</스킬Id>
      <타격대상>12345</타격대상>
    </스킬지정>
  </스킬지정>
</Body>

AbnormalStateTask

Apply a status effect to targets a specified number of times.

<이름> discriminator: 이상상태Task

Usage
XML Reference

tasks:
  - taskId: 1
    type: AbnormalStateTask
    body:
      targetId: 30001
      targetCount: 3

YAML property	Type	Description
`targetId`	`int`	Abnormal state ID to apply.
`targetCount`	`int`	Required application count (maps to 지속시간 element).

YAML property	XML element	XML location
`targetId`	`<이상상태Id>`	`<Body> → <이상상태지정> → <이상상태지정> (entry)`
`targetCount`	`<지속시간>`	`<Body> → <이상상태지정> → <이상상태지정> (entry)`

<Body>
  <이상상태지정>
    <이상상태지정>
      <이상상태Id>30001</이상상태Id>
      <지속시간>3</지속시간>
    </이상상태지정>
  </이상상태지정>
</Body>

EscortTask

Escort an NPC to a destination while protecting it from enemies.

<이름> discriminator: 호위Task

Usage
XML Reference

tasks:
  - taskId: 1
    type: EscortTask
    body:
      npcId: "64,1049"
      escortCount: 1
      preEscortDialogue: 5
      postEscortDialogue: 6

YAML property	Type	Description
`npcId`	`string`	NPC to escort. Composite format: `"huntingZoneId,templateId"`.
`escortCount`	`int`	Number of escort repetitions.
`aggroInterval`	`int`	Aggro injection interval (seconds).
`aggroAmount`	`int`	Aggro injection amount.
`aggroRange`	`int`	Aggro propagation range (units).
`startButtonText`	`string`	Start button label.
`preEscortDialogue`	`int`	Dialogue ID shown before escort begins.
`postEscortDialogue`	`int`	Dialogue ID shown after escort completes.
`postEscortCinematicId`	`int`	Cinematic ID played after escort.
`aiSettings`	`string`	AI behavior configuration string.
`targetArea`	`string`	Destination area specification.

YAML property	XML element	XML location
`npcId`	`<대상NPC지정>`	`<Body> → <대상NPC지정>`
`escortCount`	`<호위횟수>`	`<Body> → <호위횟수>`
`aggroInterval`	`<어그로주입간격초>`	`<Body> → <어그로주입간격초>`
`aggroAmount`	`<어그로주입수치>`	`<Body> → <어그로주입수치>`
`aggroRange`	`<어그로전파범위uu>`	`<Body> → <어그로전파범위uu>`
`startButtonText`	`<시작버튼Text>`	`<Body> → <시작버튼Text>`
`preEscortDialogue`	`<호위전대사작성>`	`<Body> → <호위전대사작성>`
`postEscortDialogue`	`<호위후대사작성>`	`<Body> → <호위후대사작성>`
`postEscortCinematicId`	`<호위후연출Id>`	`<Body> → <호위후연출Id>`
`aiSettings`	`<AI설정>`	`<Body> → <AI설정>`
`targetArea`	`<목표지역>`	`<Body> → <목표지역>`

<Body>
  <대상NPC지정>64,1049</대상NPC지정>
  <호위횟수>1</호위횟수>
  <호위전대사작성>5</호위전대사작성>
  <호위후대사작성>6</호위후대사작성>
</Body>

GuardianTask

Protect a stationary NPC from attacking enemies.

<이름> discriminator: 수호Task

Usage
XML Reference

tasks:
  - taskId: 1
    type: GuardianTask
    body:
      npcId: "64,1049"
      postGuardianDialogue: 5

YAML property	Type	Description
`npcId`	`string`	NPC to protect. Composite format: `"huntingZoneId,templateId"`.
`aggroInterval`	`int`	Aggro injection interval (seconds).
`aggroAmount`	`int`	Aggro injection amount.
`aggroRange`	`int`	Aggro propagation range (units).
`postGuardianDialogue`	`int`	Dialogue ID shown after protection completes.
`targetMonster`	`string`	Monster spec string for attackers to guard against.

YAML property	XML element	XML location
`npcId`	`<대상NPC지정>`	`<Body> → <대상NPC지정>`
`aggroInterval`	`<어그로주입간격초>`	`<Body> → <어그로주입간격초>`
`aggroAmount`	`<어그로주입수치>`	`<Body> → <어그로주입수치>`
`aggroRange`	`<어그로전파범위uu>`	`<Body> → <어그로전파범위uu>`
`postGuardianDialogue`	`<수호후대사작성>`	`<Body> → <수호후대사작성>`
`targetMonster`	`<대상몬스터지정>`	`<Body> → <대상몬스터지정>`

<Body>
  <대상NPC지정>64,1049</대상NPC지정>
  <수호후대사작성>5</수호후대사작성>
</Body>