ISUCONQUESTアプリケーションマニュアル

applicaitionmanual.md

ISU CONQUESTアプリケーションマニュアル

ISU CONQUESTとは

ISU CONQUESTはPC及びスマートフォン向け放置ゲームです。多くのISUを生産し、世界中をISUで埋め尽くすしましょう。 ユーザは、ゲーム内の職人の道具を鍛え上げることでISUの生産力を向上することができます 今月で何と３周年！ ただいま、CM放映キャンペーン中！ 今すぐゲームをプレイしよう！

用語

ユーザ(user)

• ゲームをプレイするユーザ
• ガチャを引く、デッキの編集、カードの強化、プレゼントの受け取りなどを行う

生産性(amount per sec)

• ISUの生産性
  • 1秒間にどれだけのISUを生産できるかを表す値

ガチャ(gacha)

• アイテムを得る手段の一つ
• 1回、または10回で連続で引くことが可能
• 結果はプレゼントとして受け取る

アイテム(item)

• ISU COIN、カード、強化素材、時短アイテム
  • ISU COIN: ゲーム内通貨
    • ISUを生産することで獲得
    • ガチャを引く際に必要
  • カード: ISUの生産に必要なアイテム
  • 強化素材: カードを強化することのできるアイテム
  • 時短アイテム: ISUの生産性を向上させるアイテム
• ガチャやプレゼントで獲得する

カード(card)

• ISUの生産に必要なアイテム

デッキ(deck)

• ISUの生産に利用する3枚カードの組み合わせ
• ユーザが所持しているカードから3枚選択する

プレゼント(present)

• 周年記念やお詫びなどの際に配布されるアイテム

ログインボーナス(login bonus)

• ログイン時にもらえるアイテム
• N日間の受け取りを繰り返すものと、N日間で受け取り終了の2種類
  • ex1) 1 ~ 7日の受け取りを繰り返すボーナスA
    • ボーナスAの7日目の報酬を受け取った翌日は、ボーナスA1日目の報酬を受け取る
  • ex2) 7日受け取り後、繰り返しのないボーナスB
    • ボーナスBの7日目の報酬を受け取った時点で、ボーナスBの受け取りは終了する
• ユーザに直接付与され、プレゼントとして受け取る必要がない

ログイン

• 一日一回行われる処理
• セッションの発行、ログインボーナスやプレゼントの受け取りを行う
• 日本時間の0時を１日の始まりの基準とする。0時を過ぎて初めてログインすると、ログインボーナスがもらえる

BAN

• ユーザアカウントを停止する

ワンタイムトークン

• 通信状態が悪い時など、同じリクエストが２回実行されるケースを想定して、ゲームでアイテムが増殖しないように、ワンタイムトークンを発行して、処理自体は１回しかしないように制御している

提供する想定プラットフォーム

• 今回のアプリケーションは、マルチプラットフォームを想定したアプリケーションになっています
• 提供する画面は、PCのプラットフォームを提供しており、プラットフォームログイン後の状態で起動することを想定しています
• また、データ構造としては、PC以外のスマートフォンからのログインを想定した作りになっています
• ユーザー作成についても、今回は、PCからのユーザ作成のエンドポイントのみを提供しています
  • 本来は別プラットフォームからのユーザ作成のエンドポイントもある想定です
• ただし、ユーザ連携用（同じユーザIDで複数のプラットフォームからログインできるようにする仕組み）のエンドポイントは今回提供しておりません
• プラットフォーム N:1 ユーザ　という関係を構造上持ってます
• プラットフォームとユーザの関係は、user_devicesテーブルで管理しています

ゲームループ

ISU CONQUESTのゲームループの構成を簡単に記載します。

管理者用エンドポイントについて

/adminではじまるエンドポイントは、管理者用に用意しているエンドポイントです。ゲームユーザからは利用されないエンドポイントになります。