콘솔로 이동

카드수집형 RPG

서머너즈워, 마퓨파와 같이 다양한 캐릭터를 수집, 플레이 하는 형식의 게임인 경우, 아래와 같이 메소드를 호출하세요.

유저가 직접 스테이지를 플레이하는 경우

스테이지 시작

  • 스테이지 시작에 재화가 사용되는 경우 아래와 같이 UseCurrency 메소드를 호출하세요

    UseCurrency 메소드의 where_to_entity 는 entity.PlayStage, where_to_category_slug 는 스테이지 종류, where_to_slug 는 스테이지명을 입력합니다.
    UseCurrency
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    currency_slug { 스테미나 }
    currency_quantity 8
    currency_total_quantity 99999
    where_to_entity entity.PlayStage
    where_to_category_slug { 모험 }
    where_to_slug { 1-1-1 }

  • 스테이지 시작 시 PlayStage 메소드를 호출하세요.

    PlayStage 메소드의 stage_status 값은 stageStatus.Start 로 입력하세요.
    스테이지 플레이에 활용하는 모든 캐릭터들을 character_uuids에 리스트 형태로 입력하세요.
    더미 캐릭터와 같이 유저(계정)를 반영하는 캐릭터는 PlayStage 메소드의 character_uuid 에 항상 포함시켜야 합니다.
    PlayStage
    player_uuid { player_uuid }
    character_uuid [TentuPlayKeyword.DUMMY_CHARACTER_ID, 니케uuid, 아가멤논uuid, 천향uuid, 백설연uuid, 캐츠시uuid]
    stage_type stageType.PvE
    stage_slug { 1-1-1 }
    stage_category { 모험 }
    stage_level 1
    stage_score null
    stage_status stageStatus.Start
    stage_playtime null

  • PlayStageWithEquipment 를 호출하여 스테이지 플레이 시 캐릭터가 장착하고 있는 아이템을 아래와 같이 각 캐릭터 별로 기록해주세요.

    PlayStageWithEquipment
    player_uuid { 백설연 uuid } { 백설연 uuid }
    item_slug * { 1 레벨 방어구 } { 2 레벨 롱소드 (불) }
    stage_slug { 1-1-1 } { 1-1-1 }
    stage_type stageType.PvE stageType.PvE
    stage_category_slug { 모험 } { 모험 }

스테이지 종료

  • 스테이지 종료 시 아래와 같이 PlayStage 메소드를 호출하세요.

    PlayStage 메소드의 stage_status 값은 게임 종료 상황에 따라 Win, Lose, Quit 로 구분해주세요.

    PlayStage
    player_uuid { player_uuid }
    character_uuid [TentuPlayKeyword.DUMMY_CHARACTER_ID, 니케uuid, 아가멤논uuid, 천향uuid, 백설연uuid, 캐츠시uuid]
    stage_type* stageType.PvE
    stage_slug { 1-1-1 }
    stage_category { 모험 }
    stage_level 1
    stage_score 3
    stage_status stageStatus.Win
    stage_playtime 30

캐릭터 레벨업

  • 스테이지 플레이를 통해 특정 캐릭터가 레벨업 한 경우 LevelUpCharacter 메소드를 호출하세요.
    LevelUpCharacter
    player_uuid { player_uuid }
    character_uuid { 키레네uuid }
    level_to* 2
    level_from 1

아이템 획득

스테이지 플레이 도중 아이템 획득 시 아래와 각 아이템 Object 별 획득 메소드를 호출하세요

  • 순수하게 스테이지 플레이만으로 화폐를 획득한 경우 아래와 같이 GetCurrency 메소드를 호출하세요.

    GetCurrency
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    currency_slug { 골드 }
    currency_quantity 4947
    currency_total_quantity 999999
    from_entity entity.PlayStage
    from_category_slug { 모험 }
    from_slug { 1-1-1 }

  • 순수하게 스테이지 플레이만으로 소비재(Consumable)를 획득한 경우 아래와 같이 GetConsumable 메소드를 호출하세요.

    GetConsumable
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    item_slug { 경험의 물약 특대형 }
    item_quantity 29
    from_entity entity.PlayStage
    from_category_slug { 모험 }
    from_slug { 1-1-1 }

  • 순수하게 스테이지 플레이만으로 장비(Equipment)를 획득한 경우 아래와 같이 GetEquipment 메소드를 호출하세요.

    GetEquipment
    player_uuid { player_uuid } { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID TentuPlayKeyword.DUMMY_CHARACTER_ID
    item_slug { 1성 은밀한 단검 (빛) } { 1성 병사의 검 (불) }
    item_quantity 1 1
    from_entity entity.PlayStage entity.PlayStage
    from_category_slug { 모험 } { 모험 }
    from_slug { 1-1-1 } { 1-1-1 }

보너스 획득

  • 스테이지 플레이와 연계하여 보너스를 제공하는 경우 아래와 같이 GetBonus와 함께 보너스로 획득하는 Object 획득 메소드를 호출하세요. 아래 예시는 GetConsumable 메소드를 추가로 호출하였습니다.

    "스테이지 퍼펙트 클리어" 와 같이 스테이지 플레이 결과의 특정 조건을 만족하는 경우 얻는 보너스의 경우 GetBonus 와 함께 각 Object 별 메소드를 호출하세요. 여기서 Object 획득 메소드의 from_entity는 entity.PlayStage가 아닌 entity.GetBonus로 기록하세요.
    GetBonus
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    bonus_slug { 1-1-1 퍼펙트 클리어 보상 }
    bonus_category_slug { 모험 }
    is_automated FALSE

    GetConsumable
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    item_slug { 경험의 물약 소형 }
    item_quantity 20
    from_entity entity.GetBonus
    from_category_slug { 모험 }
    from_slug { 1-1-1 퍼펙트 클리어 보상 }

    GetCurrency
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    bonus_slug { 1-1-1 퍼펙트 클리어 보상 }
    bonus_category_slug { 모험 }
    is_automated FALSE

유저가 스테이지를 스킵하여 결과만 수집하는 경우

유저가 스테이지를 직접 플레이하지 않고 클리어 티켓, 소탕권 등을 사용하여 결과만 수집하는 경우 아래와 같이 메소드를 호출하세요.

스테이지 시작과 종료

  • 전투 스킵 아이템 사용한 경우 아래와 같이 UseConsumable 을 호출하세요

    UseConsumable
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    item_slug { 소탕권 }
    item_quantity 1
    where_to_entity entity.PlayStage
    where_to_category_slug { 모험 }
    where_to_slug { 1-4-10 }

  • 스테이지 시작 시 필요한 재화를 소비하는 경우 UseCurrency 를 호출하세요

    UseCurrency
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    currency_slug { 스테미나 }
    currency_quantity 8
    currency_total_quantity 99999
    where_to_entity entity.PlayStage
    where_to_category_slug { 모험 }
    where_to_slug { 1-4-10 }

  • 전투를 스킵하는 아이템을 사용한 경우 스테이지 종료 시점에서 PlayStage 메소드를 호출하세요.

    PlayStage
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    stage_type stageType.PvE
    stage_slug { 1-4-10 }
    stage_category_slug { 모험 }
    stage_level 44
    stage_score null
    stage_status stageStatus.Win
    stage_playtime 0

캐릭터 레벨업

  • 스테이지 플레이를 통해 특정 캐릭터가 레벨업 한 경우 LevelUpCharacter 메소드를 호출하세요.
    LevelUpCharacter
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    level_to* 2
    level_from 1

아이템 획득

  • 스테이지 결과를 통해 획득한 재화나 아이템을 기록하기 위해 아래와 같이 각 Object 별 획득 메소드를 호출하세요.
    GetCurrency
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    currency_slug { 골드 }
    currency_quantity 4947
    currency_total_quantity 999999
    from_entity entity.PlayStage
    from_category_slug { 모험 }
    from_slug { 1-4-10 }

    GetConsumable
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    item_slug { 경험의 물약 특대형 }
    item_quantity 29
    from_entity entity.PlayStage
    from_category_slug { 모험 }
    from_slug { 1-4-10}

    GetEquipment
    player_uuid { player_uuid }
    character_uuid TentuPlayKeyword.DUMMY_CHARACTER_ID
    item_slug { 1성 은밀한 단검 (빛) }
    item_quantity* 1
    from_entity entity.PlayStage
    from_category_slug { 모험 }
    from_slug { 1-4-10 }