Idle game

Call the following methods if your game is an idle game whose core strategy is to leave the game playing itself with least or no player interaction.

Start and end stage

Not all stages are recorded since they are too frequent in idle games where stages can be played automatically. Instead, stages are divided into larger blocks by designated hurdles such as boss stages or every consecutive 10 stages.

Call PlayStage to collect the start and end of each stage block.

The following example shows how to apply the PlayStage method in order to record the start and end of each stage block divided by a hurdle when a hurdle is set in every 10 stages.

Starting a stage block
Method Parameter Type Required Notes

PlayStage

player_uuid

string

Required

character_uuids

string

Required

TentuPlayKeyword._DUMMY_CHARACTER_ID_, { character_uuid }

stage_type

Required

stageType.PvE

stage_slug

string

Required

1-1

stage_category_slug

string

Optional

bronze round

stage_level

string

Optional

1

stage_score

int

Optional

null

stage_status

Optional

stageStatus.Start

stage_playtime

int

Optional

null

Ending the stage block
Method Parameter Type Required Notes

PlayStage

player_uuid

string

Required

character_uuids

string

Required

TentuPlayKeyword._DUMMY_CHARACTER_ID_, { character_uuid }

stage_type

Required

stageType.PvE

stage_slug

string

Required

1-1

stage_category_slug

string

Optional

bronze round

stage_level

string

Optional

1

stage_score

int

Optional

null

stage_status

Optional

stageStatus.Win

stage_playtime

int

Optional

null

Starting the next stage block
Method Parameter Type Required Notes

PlayStage

player_uuid

string

Required

character_uuids

string

Required

TentuPlayKeyword._DUMMY_CHARACTER_ID_, { character_uuid }

stage_type

Required

stageType.PvE

stage_slug

string

Required

1-10

stage_category_slug

string

Optional

bronze round

stage_level

string

Optional

10

stage_score

int

Optional

null

stage_status

Optional

stageStatus.Start

stage_playtime

int

Optional

null

Get and use currency

Unlike Hard Currency (currency earned through cash payment), Soft Currency (currency earned by playing game) earnings are not recorded because they are too frequent in idle games.

While the GetCurrency method is used to record earnings of Hard Currency only, the UseCurrency method is used to record the consumption of both Soft Currency and Hard Currency.

  • Call UseCurrency and GetInfrastructure if a user acquires an infrastructure object that affects the style and pace of the entire game.

    When opening a new infrastructure with gold
    Method Parameter Type Required Notes

    UseCurrency

    player_uuid

    string

    Required

    character_uuid

    string

    Required

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    currency_slug

    string

    Required

    gold

    currency_quantity

    float

    Required

    2500

    currency_total_quantity

    float

    Optional

    285700

    where_to_entity

    Optional

    entity.GetInfraStructure

    where_to_category_slug

    string

    Optional

    customer table

    where_to_slug

    string

    Optional

    customer table number 2

    When opening a new infrastructure with cash
    Method Parameter Type Required Notes

    UseCurrency

    player_uuid

    string

    Required

    character_uuid

    string

    Required

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    currency_slug

    string

    Required

    cash

    currency_quantity

    float

    Required

    20

    currency_total_quantity

    float

    Optional

    26

    where_to_entity

    Optional

    entity.GetInfraStructure

    where_to_category_slug

    string

    Optional

    customer table

    where_to_slug

    string

    Optional

    customer table number 2

    Acquiring a new infrastructure
    Method Parameter Type Required Notes

    GetInfrastructure

    player_uuid

    string

    Required

    character_uuid

    string

    Required

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    item_slug

    string

    Required

    customer table number 2

    item_quantity

    float

    Required

    1

    from_entity

    Optional

    entity.UseCurrency

    from_category_slug

    string

    Optional

    customer table

    from_slug

    string

    Optional

    customer table number 2

  • Call GetBonus and Get{ Object } when a certain object is earned as a bonus.

    • If a user has to take an action such as clicking or touching the screen to earn the bonus, put FALSE in the is_automated parameter of the GetBonus method.

    • If the bonus earning process is automatic, input TRUE.

    Method Parameter Type Required Notes

    GetBonus

    player_uuid

    string

    Required

    character_uuid

    string

    Required

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    bonus_slug

    string

    Required

    skill point

    bonus_category_slug

    string

    Required

    customer table

    is_automated

    boolean

    Optional

    FALSE

    Method Parameter Type Required Notes

    GetCurrency

    player_uuid

    string

    Required

    character_uuid

    string

    Required

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    currency_slug

    string

    Required

    cash

    currency_quantity

    float

    Required

    5

    currency_total_quantity

    float

    Optional

    46

    from_entity

    Optional

    entity.GetBonus

    from_category_slug

    string

    Optional

    customer table

    from_slug

    string

    Optional

    upgrade to level 10

  • Call UseCurrency and LevelUpInfrastructure when a currency is paid to upgrade a certain object.

    Method Parameter Type Required Notes

    UseCurrency

    player_uuid

    string

    Required

    character_uuid

    string

    Required

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    currency_slug

    string

    Required

    gold

    currency_quantity

    float

    Required

    128930

    currency_total_quantity

    float

    Optional

    342300

    where_to_entity

    Optional

    entity.LevelUpInfrastructre

    where_to_category_slug

    string

    Optional

    customer table

    where_to_slug

    string

    Optional

    customer table number 1

    Method Parameter Type Required Notes

    LevelUpInfrastructure

    player_uuid

    string

    Required

    character_uuid

    string

    Required

    TentuPlayKeyword._DUMMY_CHARACTER_ID_

    item_slug

    string

    Required

    customer table number 1

    item_level_to

    int

    Required

    10

    item_level_from

    int

    Optional

    1