Card-collecting RPG

Call the following methods if your game is a role-playing game that contains collecting either characters or cards to use in a battle, such as Summoners War and Marvel Future Fight.

A user can either complete missions through basic gameplay or skip them by using a certain item without gameplay.

When a user plays a stage

Call the following methods if users play the stage themselves.

Start stage

  • Call UseCurrency if a currency is used to begin a stage.

    Put entity.PlayStage in the where_to_entity parameter.
    Method Parameter Type Required Notes

    UseCurrency

    player_uuid

    string

    Required

    character_uuid

    string

    Required

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    currency_slug

    string

    Required

    stamina

    currency_quantity

    float

    Required

    8

    currency_total_quantity

    float

    Optional

    99999

    where_to_entity

    Optional

    entity.PlayStage

    where_to_category_slug

    string

    Optional

    adventure (stage type)

    where_to_slug

    string

    Optional

    1-1-1 (stage name)

  • Call PlayStage when a stage begins.

    • Put all the characters needed to play a stage in a list format in the character_uuids parameter including ID for dummy character.

    • Put stageStatus.Start in the stage_status parameter.
    Method Parameter Type Required Notes

    PlayStage

    player_uuid

    string

    Required

    character_uuids

    string

    Required

    TentuPlayKeyword._DUMMY_CHARACTER_ID_, {Nike uuid}, {Zeus uuid}, {Peach uuid}, {Baek uuid}, {Kiwi uuid}

    stage_type

    Required

    stageType.PvE

    stage_slug

    string

    Required

    1-1-1

    stage_category_slug

    string

    Optional

    adventure

    stage_level

    string

    Optional

    1

    stage_score

    int

    Optional

    null

    stage_status

    Optional

    stageStatus.Start

    stage_playtime

    int

    Optional

    null

  • Call PlayStageWithEquipment for every equipment when each character is equipped with equipments during stage play.

    Method

    Parameter

    Type

    Required

    Notes

    Equipment A

    Equipment B

    PlayStageWithEquipment

    player_uuid

    string

    Required

    character_uuid

    string

    Required

    {Baek uuid}

    item_slug

    string

    Required

    Level 1 Armor

    Level 2 Long Sword

    stage_slug

    string

    Optional

    1-1-1

    stage_type

    Optional

    stageType.PvE

    stage_category_slug

    string

    Optional

    adventure

End Stage

Call PlayStage when the stage ends.

Put Win, Lose, or Quit in the stage_status parameter depending on the result of the stage.
Method Parameter Type Required Notes

PlayStage

player_uuid

string

Required

character_uuids

string

Required

TentuPlayKeyword._DUMMY_CHARACTER_ID_, {Nike uuid}, {Zeus uuid}, {Peach uuid}, {Baek uuid}, {Kiwi uuid}

stage_type

Required

stageType.PvE

stage_slug

string

Required

1-1-1

stage_category_slug

string

Optional

adventure

stage_level

string

Optional

1

stage_score

int

Optional

3

stage_status

Optional

stageStatus.Win

stage_playtime

int

Optional

30

Level up character

Call LevelUpCharacter if a certain character levels up during or after stage play.

Method Parameter Type Required Notes

LevelUpCharacter

player_uuid

string

Required

character_uuid

string

Required

{Kylie uuid}

level_to

int

Required

2

level_from

int

Optional

1

Get item

Call Get{ Object } to record each object acquired through stage play.

  • Call GetCurrency if a user earns a currency from playing stage.

    Method Parameter Type Required Notes

    GetCurrency

    player_uuid

    string

    Required

    character_uuid

    string

    Required

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    currency_slug

    string

    Required

    gold

    currency_quantity

    float

    Required

    4947

    currency_total_quantity

    float

    Optional

    999999

    from_entity

    Optional

    entity.PlayStage

    from_category_slug

    string

    Optional

    adventure

    from_slug

    string

    Optional

    1-1-1

  • Call GetConsumable if a user earns a consumable from playing stage.

    Method Parameter Type Required Notes

    GetConsumable

    player_uuid

    string

    Required

    character_uuid

    string

    Required

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    item_slug

    string

    Required

    large potion of experience

    item_quantity

    float

    Required

    29

    from_entity

    Optional

    entity.PlayStage

    from_category_slug

    string

    Optional

    adventure

    from_slug

    string

    Optional

    1-1-1

  • Call GetEquipment if a user earns equipments from playing stage.

    Method

    Parameter

    Type

    Required

    Notes

    Equipment A

    Equipment B

    GetEquipment

    player_uuid

    string

    Required

    character_uuid

    string

    Required

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    item_slug

    string

    Required

    1 star dagger

    1 star soldiers sword

    item_quantity

    float

    Required

    1

    from_entity

    Optional

    entity.PlayStage

    from_category_slug

    string

    Optional

    adventure

    from_slug

    string

    Optional

    1-1-1

Get bonus

Call GetBonus and Get{ Object } if additional bonus is earned after playing the stage.

  • These methods are applicable only when a user receives a bonus by meeting a certain requirement such as "Perfect Stage Clear".

  • Be sure to put entity.GetBonus, not entity.PlayStage in the from_entity parameter when calling a Get{ Object } method.

In the following example, GetConsumable and GetCurrency are used as well as GetBonus becasue some currency and consumable are additionally earned as bonuses

Method Parameter Type Required Notes

GetBonus

player_uuid

string

Required

character_uuid

string

Required

TentuPlayKeyword._DUMMY_CHARACTER_ID_

bonus_slug

string

Required

1-1-1 perfect stage clear reward

bonus_category_slug

string

Required

adventure

is_automated

boolean

Optional

FALSE
Method Parameter Type Required Notes

GetConsumable

player_uuid

string

Required

character_uuid

string

Required

TentuPlayKeyword._DUMMY_CHARACTER_ID_

item_slug

string

Required

small potion of experience

item_quantity

float

Required

20

from_entity

Optional

entity.GetBonus

from_category_slug

string

Optional

adventure

from_slug

string

Optional

1-1-1 perfect stage clear reward
Method Parameter Type Required Notes

GetCurrency

player_uuid

string

Required

character_uuid

string

Required

TentuPlayKeyword._DUMMY_CHARACTER_ID_

currency_slug

string

Required

gold

currency_quantity

float

Required

1000

currency_total_quantity

float

Optional

999999

from_entity

Optional

entity.GetBonus

from_category_slug

string

Optional

adventure

from_slug

string

Optional

1-1-1 perfect stage clear reward

When a user skips a stage

Call the following methods if users do not play the stage themselves, but instead use a clear ticket to automatically complete the stage. In this case, you will be able to collect the result data only.

Start and end stage

  • Call UseConsumable if a clear ticket is used.

    Method Parameter Type Required Notes

    UseConsumable

    player_uuid

    string

    Required

    character_uuid

    string

    Required

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    item_slug

    string

    Required

    clear ticket

    item_quantity

    float

    Required

    1

    where_to_entity

    Optional

    entity.PlayStage

    where_to_category_slug

    string

    Optional

    adventure

    where_to_slug

    string

    Optional

    1-4-10

  • Call UseCurrency if a currency is paid to start stage.

    Method Parameter Type Required Notes

    UseCurrency

    player_uuid

    string

    Required

    character_uuid

    string

    Required

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    currency_slug

    string

    Required

    stamina

    currency_quantity

    float

    Required

    8

    currency_total_quantity

    float

    Optional

    99999

    where_to_entity

    Optional

    entity.PlayStage

    where_to_category_slug

    string

    Optional

    adventure

    where_to_slug

    string

    Optional

    1-4-10

  • Call PlayStage when the stage ends with a clear ticket being used.

    Method Parameter Type Required Notes

    PlayStage

    player_uuid

    string

    Required

    character_uuids

    string

    Required

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    stage_type

    Required

    stageType.PvE

    stage_slug

    string

    Required

    1-4-10

    stage_category_slug

    string

    Optional

    adventure

    stage_level

    string

    Optional

    44

    stage_score

    int

    Optional

    null

    stage_status

    Optional

    stageStatus.Win

    stage_playtime

    int

    Optional

    0

Level up character

Call LevelUpCharacter if a certain character levels up at the end of stage.

Method Parameter Type Required Notes

LevelUpCharacter

player_uuid

string

Required

character_uuid

string

Required

TentuPlayKeyword._DUMMY_CHARACTER_ID_

level_to

int

Required

2

level_from

int

Optional

1

Get item

Call Get{ Object } to record each object acquired at the end of stage.

Method Parameter Type Required Notes

GetCurrency

player_uuid

string

Required

character_uuid

string

Required

TentuPlayKeyword._DUMMY_CHARACTER_ID_

currency_slug

string

Required

gold

currency_quantity

float

Required

4947

currency_total_quantity

float

Optional

999999

from_entity

Optional

entity.PlayStage

from_category_slug

string

Optional

adventure

from_slug

string

Optional

1-4-10
Method Parameter Type Required Notes

GetConsumable

player_uuid

string

Required

character_uuid

string

Required

TentuPlayKeyword._DUMMY_CHARACTER_ID_

item_slug

string

Required

large potion of experience

item_quantity

float

Required

29

from_entity

Optional

entity.PlayStage

from_category_slug

string

Optional

adventure

from_slug

string

Optional

1-4-10
Method Parameter Type Required Notes

GetEquipment

player_uuid

string

Required

character_uuid

string

Required

TentuPlayKeyword._DUMMY_CHARACTER_ID_

item_slug

string

Required

1 star dagger

item_quantity

float

Required

1

from_entity

Optional

entity.PlayStage

from_category_slug

string

Optional

adventure

from_slug

string

Optional

1-4-10