Movement Tasks

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

Task Types

MoveToPcTask — Move to a specific named area. Auto-completes on arrival.
MoveToPcBranchTask — Branch to different next tasks based on which area the player enters first.
TeleportTask — Teleport the player to a specific continent and position.

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

Move to a specific named area. Auto-completes on arrival.

<이름> discriminator: PC이동Task

tasks:
  - taskId: 1
    type: MoveToPcTask
    body:
      areaRef: "zone_100"
      areaName: "Velika Gate"

YAML property	Type	Description
`areaRef`	`string`	Area reference identifier.
`areaName`	`string`	Display name for the area.

YAML property	XML element	XML location
`areaRef`	`<목표지역>`	`<Body> → <목표지역>`
`areaName`	`<지역명>`	`<Body> → <지역명>`

<Body>
  <목표지역>zone_100</목표지역>
  <지역명>Velika Gate</지역명>
</Body>

Branch to different next tasks based on which area the player enters first.

<이름> discriminator: PC이동분기Task

tasks:
  - taskId: 1
    type: MoveToPcBranchTask
    body:
      branchType: "auto"

YAML property	Type	Description
`branchType`	`string`	Branch type (`auto` or `manual`).

YAML property	XML element	XML location
`branchType`	`<분기유형>`	`<Body> → <분기유형>`

<Body>
  <분기유형>auto</분기유형>
  <분기작성>
    <분기작성>
      <선택지Text>...</선택지Text>
      <연결Task>2</연결Task>
    </분기작성>
  </분기작성>
</Body>

Teleport the player to a specific continent and position.

<이름> discriminator: 텔레포트Task

tasks:
  - taskId: 1
    type: TeleportTask
    body:
      areaId: 10       # continent ID
      coordinate: "12345,67890,100"
      direction: 90

YAML property	Type	Description
`areaId`	`int`	Destination continent ID (mapped from `areaId`).
`coordinate`	`string`	Destination coordinates (format: `x,y,z`).
`direction`	`int`	Facing direction in degrees.

<Body>
  <대륙Id>10</대륙Id>
  <좌표>12345,67890,100</좌표>
  <방향>90</방향>
</Body>