When user plays a stage
Start Stage
- Call UseCurrency method if currency is paid to begin a stage.
For UseCurrency method, input entity.PlayStage at where_to_entity, label for stage type at where_to_category_slug, stage name at where_to_slug.
UseCurrency
| player_uuid* |
{ player_uuid } |
| character_uuid* |
TentuPlayKeyword._DUMMY_CHARACTER_ID_ |
| currency_slug* |
{ stamina } |
|
| currency_quantity* |
8 |
| currency_total_quantity |
99999 |
| where_to_entity |
entity.PlayStage |
| where_to_category_slug |
{ adventure } |
| where_to_slug |
{ 1-1-1 } |
- Call PlayStage method when a stage begins.
Input stageStatus.Start at stage_status for PlayStage method.
Input all characters needed to play a stage in a list format at character_uuids for PlayStage method.
A Character that identifies the user such as Dummy Character must always be included in the list at character_uuid for PlayStage method.
PlayStage
| player_uuid* |
{ player_uuid } |
| character_uuid* |
[TentuPlayKeyword._DUMMY_CHARACTER_ID_, Nike uuid, Zeus uuid, Peach uuid, Baek uuid, Kiwi uuid]
|
| stage_type* |
stageType.PvE |
| stage_slug* |
{ 1-1-1 } |
| stage_category |
{ adventure } |
| stage_level |
1 |
| stage_score |
null |
| stage_status |
stageStatus.Start |
| stage_playtime |
null |
- Call PlayStageWithEquipment to record the equipment that each character is equipped with during stage play.
PlayStageWithEquipment
| player_uuid* |
{ player_uuid } |
{ player_uuid } |
| character_uuid* |
{ Baek uuid } |
{ Baek uuid } |
| item_slug * |
{ Level 1 Armor } |
{ Level 2 Long Sword } |
| stage_slug* |
{ 1-1-1 } |
{ 1-1-1 } |
stage_type |
stageType.PvE |
stageType.PvE |
| stage_category_slug |
{ adventure } |
{ adventure } |
End Stage
- Call PlayStage method when the stage ends.
Input Win, Lose, or Quit at stage_status for PlayStage method, depending on the result of the stage.
PlayStage
| player_uuid* |
{ player_uuid } |
| character_uuid* |
[TentuPlayKeyword._DUMMY_CHARACTER_ID_, Nike uuid, Zeus uuid, Peach uuid, Baek uuid, Kiwi uuid] |
| stage_type* |
stageType.PvE |
| stage_slug |
{ 1-1-1 } |
| stage_category |
{ adventure } |
| stage_level |
1 |
| stage_score |
3 |
| stage_status |
stageStatus.Win |
| stage_playtime |
30 |
Character Level Up
- Call LevelUpCharacter method if a certain character levels up during or after stage play.
LevelUpCharacter
| player_uuid* |
{ player_uuid } |
| character_uuid* |
{ Kylie uuid } |
| level_to* |
2 |
| level_from |
1 |
Get Item
Call Get{ Object type } to record each Object acquired through stage play.
- Call GetCurrency method to record currency earned from playing stage.
GetCurrency
| player_uuid* |
{ player_uuid } |
| character_uuid* |
TentuPlayKeyword._DUMMY_CHARACTER_ID_ |
| currency_slug* |
{ gold } |
| currency_quantity* |
4947 |
| currency_total_quantity |
999999 |
| from_entity |
entity.PlayStage |
| from_category_slug |
{ adventure } |
| from_slug |
{ 1-1-1 } |
- Call GetConsumable method to record Consumable earned from playing stage.
GetConsumable
| player_uuid* |
{ player_uuid } |
| character_uuid* |
TentuPlayKeyword._DUMMY_CHARACTER_ID_ |
| item_slug* |
{ large potion of experience } |
| item_quantity* |
29 |
| from_entity |
entity.PlayStage |
| from_category_slug |
{ adventure } |
| from_slug |
{ 1-1-1 } |
- Call GetEquipment method to record Equipment earned from playing stage.
GetEquipment
| player_uuid* |
{ player_uuid } |
{ player_uuid } |
| character_uuid* |
TentuPlayKeyword._DUMMY_CHARACTER_ID_ |
TentuPlayKeyword._DUMMY_CHARACTER_ID_ |
| item_slug* |
{ 1 star dagger } |
{ 1 star soldiers sword } |
| item_quantity* |
1 |
1 |
| from_entity |
entity.PlayStage |
entity.PlayStage |
| from_category_slug |
{ adventure } |
{ adventure } |
| from_slug |
{ 1-1-1 } |
{ 1-1-1 } |
Get Bonus
- Call GetBonus and relevant Get{ Object type } if additional bonus is earned after playing the stage.
Both GetBonus and Get{ Object type } must be called when a user receives a bonus only when a certain requirement such as "Perfect Stage Clear" is met. Please note that input value at from_entity for Get{ Object type } method is entity.GetBonus, not entity.PlayStage.
The example below calls GetConsumable and GetCurrency method in case when some Currency and Consumable are additionally earned as bonus.
GetBonus
| player_uuid* |
{ player_uuid } |
| character_uuid* |
TentuPlayKeyword._DUMMY_CHARACTER_ID_ |
| bonus_slug* |
{ 1-1-1 perfect stage clear reward } |
| bonus_category_slug |
{ adventure } |
| is_automated* |
FALSE |
GetConsumable
| player_uuid* |
{ player_uuid } |
| character_uuid* |
TentuPlayKeyword._DUMMY_CHARACTER_ID_ |
| item_slug* |
{ small potion of experience } |
| item_quantity* |
20 |
| from_entity |
entity.GetBonus |
| from_category_slug |
{ adventure } |
| from_slug |
{ 1-1-1 perfect clear reward } |
GetCurrency
| player_uuid* |
{ player_uuid } |
| character_uuid* |
TentuPlayKeyword._DUMMY_CHARACTER_ID_ |
| bonus_slug* |
{ 1-1-1 perfect clear reward } |
| bonus_category_slug |
{ adventure } |
| is_automated* |
FALSE |