Task Types Overview

Quest tasks define individual objectives within a quest. Each task has a type that determines its behavior and which body properties are valid.

Task Structure

Every task consists of:

Task wrapper <Task id="N"> — identified by taskId
Header <Header> — chain metadata (nextTaskId, failureReturnTaskId, continentId, etc.)
Body <Body> — journal text, completion items, and type-specific content

quests:
  update:
    - id: 1384
      changes:
        tasks:
          - taskId: 3
            type: UseItemTask        # determines <이름> in <Header> and body schema
            nextTaskId: 4            # <다음Task> in <Header>
            journalText: "@quest:1384007"  # <저널Text> in <Body>
            body:
              itemId: 98             # type-specific, inside <Body>

Common Task Properties

These properties appear on every task type regardless of type.

Usage
XML Reference

YAML property	Type	Required	Description
`taskId`	`int`	Yes	Unique task ID within the quest. Required.
`type`	`string`	Yes	Task type name (e.g. `HuntTask`). Required.
`nextTaskId`	`int`		ID of the next task in the chain. `0` signals quest completion.
`failureReturnTaskId`	`int`		Task to return to on failure.
`continentId`	`int`		Continent restriction for this task.
`worldPosition`	`string`		World position hint (format: `x,y,z`).
`journalText`	`string`		Journal text reference (e.g. `@quest:1001001`).
`journalText2`	`string`		Secondary journal text reference.
`hasReward`	`bool`		Whether the task grants a reward on completion.
`cinematicId`	`int`		Cinematic scene played on task completion.
`dungeonId`	`int`		Dungeon scope for the task objective.
`completionItems`	`list[CompletionItem]`		Items inserted into inventory on task completion.
`deleteItems`	`list[CompletionItem]`		Items removed from inventory on task completion.

YAML property	XML element	XML location
`taskId`	`<id>`	`<Task id="N">`
`type`	`<이름>`	`<Header> → <이름>`
`nextTaskId`	`<다음Task>`	`<Header> → <다음Task>`
`failureReturnTaskId`	`<실패시회귀Task>`	`<Header> → <실패시회귀Task>`
`continentId`	`<ContinentId>`	`<Header> → <ContinentId>`
`worldPosition`	`<Pos>`	`<Header> → <Pos>`
`journalText`	`<저널Text>`	`<Body> → <저널Text>`
`journalText2`	`<저널Text2>`	`<Body> → <저널Text2>`
`hasReward`	`<보상>`	`<Body> → <보상>`
`cinematicId`	`<연출Id>`	`<Body> → <연출Id>`
`dungeonId`	`<던전Id>`	`<Body> → <던전Id>`
`completionItems`	`<완료시삽입아이템>`	`<Body> → <완료시삽입아이템> (same-name nesting)`
`deleteItems`	`<완료시삭제아이템>`	`<Body> → <완료시삭제아이템> (same-name nesting)`

Completion Items

completionItems and deleteItems use the same block structure:

completionItems:
  - itemId: 70033
    quantity: 1
deleteItems:
  - itemId: 98
    quantity: 1

Usage
XML Reference

YAML property	Type	Description
`itemId`	`int`	Item template ID. Required.
`quantity`	`int`	Item quantity. Defaults to 1 if omitted.

Both completionItems and deleteItems use the same-name nesting pattern:

<완료시삽입아이템>
  <완료시삽입아이템>        <!-- entry -->
    <아이템Id>70033</아이템Id>
    <아이템갯수>1</아이템갯수>
  </완료시삽입아이템>
</완료시삽입아이템>

YAML property	XML element	XML location
`itemId`	`<아이템Id>`	`entry element`
`quantity`	`<아이템갯수>`	`entry element`

Browse by Category

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

Gathering Tasks Tasks involving resource gathering and item collection.

NPC Interaction Tasks Tasks involving NPC dialogue, item delivery, and NPC-driven objectives.

Movement Tasks Tasks requiring the player to move to specific locations or be teleported.

Activity Tasks Tasks involving player activities: objects, item use, social actions, and minigames.

Flow Control Tasks Tasks that control quest progression: branching, conditions, and repeatable loops.

Special Tasks Tasks for specialized game systems: cutscenes, transformations, dungeons, and events.

Quick Reference — All 31 Task Types

Task Type	Korean `<이름>`	Category	Description
`HuntTask`	`사냥Task`	Combat Tasks	Kill a specified number of monsters.
`HuntAndDeliverTask`	`사냥전달Task`	Combat Tasks	Kill monsters to collect flag items, then deliver to an NPC.
`HuntAndCollectTask`	`사냥수집Task`	Combat Tasks	Kill monsters to collect quest items (no delivery required).
`GroupHuntTask`	`그룹사냥Task`	Combat Tasks	Kill monsters from a named monster group definition.
`SkillHitTask`	`스킬타격Task`	Combat Tasks	Hit targets with a specific skill.
`AbnormalStateTask`	`이상상태Task`	Combat Tasks	Apply a status effect to targets a specified number of times.
`EscortTask`	`호위Task`	Combat Tasks	Escort an NPC to a destination while protecting it from enemies.
`GuardianTask`	`수호Task`	Combat Tasks	Protect a stationary NPC from attacking enemies.
`CollectTask`	`채집Task`	Gathering Tasks	Gather items from world resource nodes.
`CollectionCompleteTask`	`채집완료Task`	Gathering Tasks	Complete a collection set (no YAML body properties — configure directly in XML).
`VisitTask`	`방문Task`	NPC Interaction Tasks	Talk to a specific NPC to complete the objective.
`DeliverItemTask`	`아이템전달Task`	NPC Interaction Tasks	Deliver an inventory item to an NPC.
`DeliverInjectedItemTask`	`찔러준아이템전달Task`	NPC Interaction Tasks	Deliver a quest-injected (auto-given) item to an NPC.
`MoveToPcTask`	`PC이동Task`	Movement Tasks	Move to a specific named area. Auto-completes on arrival.
`MoveToPcBranchTask`	`PC이동분기Task`	Movement Tasks	Branch to different next tasks based on which area the player enters first.
`TeleportTask`	`텔레포트Task`	Movement Tasks	Teleport the player to a specific continent and position.
`ObjectActionTask`	`오브젝트동작Task`	Activity Tasks	Interact with a world object.
`UseItemTask`	`아이템사용Task`	Activity Tasks	Use a specific item from inventory.
`SocialTask`	`소셜Task`	Activity Tasks	Perform an emote or social action, optionally targeting an NPC.
`FishingSuccessTask`	`낚시성공Task`	Activity Tasks	Successfully catch fish a specified number of times.
`MinigameCompleteTask`	`미니게임완료Task`	Activity Tasks	Complete an in-game minigame.
`BranchTask`	`분기Task`	Flow Control Tasks	Present the player with choices that route to different next tasks.
`ConditionTask`	`조건Task`	Flow Control Tasks	Complete based on a specific game condition. Routes to true/false next tasks.
`RepeatTask`	`반복Task`	Flow Control Tasks	A repeatable objective container with configurable repeat method and target.
`PlayMovieTask`	`동영상재생Task`	Special Tasks	Play a cinematic movie sequence.
`TransformTask`	`변신Task`	Special Tasks	Transform the player or NPC using a transform template.
`DungeonEventTask`	`던전이벤트Task`	Special Tasks	Trigger a scripted dungeon event.
`DarkRiftTask`	`검은틈Task`	Special Tasks	Dark Rift world event participation task.
`GuardianMissionRewardTask`	`수호자임무보상획득Task`	Special Tasks	Collect a Guardian Legion mission reward.
`GuardianMissionScoreTask`	`수호자임무점수획득Task`	Special Tasks	Achieve a target score in a Guardian Legion mission.
`SupplySuccessTask`	`납품성공Task`	Special Tasks	Successfully supply items to a reputation shop.