カード集めの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 { player_uuid } { player_uuid } character_uuid { 白雪蓮 uuid } { 白雪蓮 uuid } item_slug * { レベル1防具 } { Lv2ロングソード（火） } 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 }