Store API

NPC API

NPC 서비스는 게임 내에 존재하는 비플레이어 캐릭터(NPC)를 관리하고 제공합니다. NPC는 게임 내에서 퀘스트를 주거나 상호 작용할 수 있는 캐릭터입니다. 게임 개발자는 NPC 서비스를 통해 NPC의 대화 내용을 관리할 수 있습니다.

NPC 에셋 업데이트

게임 내 NPC 리스트를 업데이트할 때 사용합니다.

Operation

mutation UpdateNpcList($input: UpdateNpcListInput!) {
  updateNpcList(input: $input) {
    success
  }
}

Variables

{
  "input": {
    "npcList": [
      {
        "uuid": "unique-uuid",
        "name": "NPC 이름",
        "description": "NPC 설명"
      }
    ]
  }
}

NPC 목록 조회

필터링과 페이징이 가능한 NPC 목록을 조회합니다.

Operation

query NpcConnection($first: Int, $offset: Int, $orderBy: NpcConnectionOrder, $filter: NpcConnectionFilter) {
  npcConnection(first: $first, offset: $offset, orderBy: $orderBy, filter: $filter) {
    nodes {
      uuid
      name
      description
      type
      locationName
      adminUserNo
      state
      npcDialogues {
        npcId
        order
        content
        nextDialogueId
        status
        npcDialogueChoices {
          dialogueId
          content
          nextDialogueId
        }
      }
    }
    totalCount
  }
}

Variables

{
  "first": null,
  "offset": null,
  "orderBy": {
    "field": null,
    "direction": null
  },
  "filter": {
    "state": null
  }
}

NPC 상세 조회

특정 NPC의 상세 정보를 조회합니다.

Operation

query Npc($input: NpcInput!) {
  npc(input: $input) {
    uuid
    name
    description
    type
    locationName
    adminUserNo
    state
    npcDialogues {
      npcId
      order
      content
      nextDialogueId
      status
      npcDialogueChoices {
        dialogueId
        content
        nextDialogueId
      }
    }
  }
}

Variables

{
  "input": {
    "npcId": "NPC 고유 아이디"
  }
}

퀘스트 트랜잭션