キャラクターを集めて育てる

森で仲間を獲得し、ガチャ、経験値による強化、3枠のパーティ編成を作ります。

森の探索で「騎士」を1体もらい、ガチャでは騎士か魔法使いを獲得できるようにします。同じ騎士を2体持ったときも、別々に育ててパーティに入れられる形にします。

1. キャラクターの種類と所持枠を用意する

機能を追加で「キャラクター」を追加します。表 → キャラクターで、次の三つの表を編集します。セルは選択して Enter、配列はセルをダブルクリックして編集します。

表行入力する内容
キャラクター所持枠（CharacterCollection）行を追加を押す（IDの入力は不要）初期所持枠 20、最大所持枠 100
キャラクター経験値（CharacterExperience）行を追加を押す（IDの入力は不要）必要経験値テーブルに 1、10、20 を順に追加。初期レベル上限と最大レベル上限は 4
キャラクター（Character）行を追加して knight表示順 1
キャラクター（Character）行を追加して mage表示順 2

反映 → サーバとの差分を確認からデプロイし、続けて Unity プロジェクトを更新するを押します。所持データは Character、経験値は CharacterExperience のネームスペースに保存されます。

キャラクター設定のテンプレートをダウンロードします。マネージメントコンソールの東京リージョンで Deploy → スタックリスト → スタックを新規作成を開きます。名前を adventure-characters とし、テンプレートデータでダウンロードしたファイルを選び、作成します。

このスタックには、所持枠・経験値・ガチャ・編成の設定が入っています。既存の adventure-game スタックはそのまま使います。

データネームスペース設定名
所持キャラクターadventure-characterInventory Character、Item knight / mage
経験値adventure-character-experienceExperience Experience
ガチャadventure-character-gachaLottery normal、Showcase Showcase、商品 normal
編成adventure-character-formationMold CharacterFormation、保存先 0

所持枠は初期20・最大100、キャラクター1体のスタック数は1です。同じ種類を何度も獲得できるよう、allowMultipleStacks を true にしています。

森のクリア報酬に騎士を加える

表 → クエスト → クエスト（Quest） の forest で 通常クリア報酬を開きます。コイン・ミッションカウンター・回復薬のアクションを残して、アイテムを追加 → 未設定を押します。AcquireItemSetByUserId（アイテムを取得）を選び、次を入力します。

項目値
namespaceNameCharacter
userId#{userId}
inventoryNameCharacter
itemNameknight
acquireCount1

保存してサーバーへ反映します。

adventure-game の現在のテンプレートを開き、main の forest にある contents → completeAcquireActions の末尾へ、次の1件を追加します。既存のコイン・ミッションカウンター・回復薬の項目は残します。変更したテンプレート全体でスタックを更新してください。

- action: Gs2Inventory:AcquireItemSetByUserId
  request: |-
    {"namespaceName":"adventure-character","userId":"#{userId}","inventoryName":"Character","itemName":"knight","acquireCount":1}

Unity に所持一覧を表示する

Unity の再生を止め、Extensions の Adventure Items のチェックを外します。左側の冒険画面はそのまま使います。

AdventureCharacters.cs を Assets/AdventureExtensions に入れ、Extensions に Adventure Characters を追加します。接続には、ログイン済みの Gs2ClientHolder と Gs2GameSessionHolder を使います。

AdventureCharacters.cs を Assets/AdventureExtensions に入れ、Extensions に Adventure Characters を追加します。Login に、シーン内の AdventureLogin を割り当てます。

再生し、左側の画面で森を新しく開始してクリアします。右側の所持一覧に、knight と個体を区別する値が表示されます。もう一度森をクリアすると、同じ knight が別々の2行になります。報酬の追加が反映されるまで最大5分かかります。騎士が増えない場合は、少し待ってから森を新しく始めてクリアします。

初回は次の呼び出しで一覧を取得し、その後は SubscribeItemSets() で増減を受け取ります。ItemName が種類、ItemSetId が1体ずつの識別子です。

var inventory = Client.Inventory.Namespace(InventoryNamespace)
    .Me(Session).Inventory("Character");
await foreach (var item in inventory.ItemSetsAsync())
{
    if (item != null) owned.Add(item);
}

2. 20コインでガチャを引く

機能を追加で「キャラクターガチャ」を追加します。表 → キャラクターガチャで、次の順に行を作ります。

表ID入力する内容
レアリティ（GachaRarity）commonIDのみ
ガチャ（Gacha）normal開催スケジュールは空欄
レアリティ排出率（GachaRarityRate）行を追加対象ガチャ normal、レアリティ common、抽選重み 1
キャラクター排出率（CharacterRate）行を追加レアリティ common、キャラクター knight、抽選重み 1
キャラクター排出率（CharacterRate）もう1行追加レアリティ common、キャラクター mage、抽選重み 1

排出率の表では、参照先を選ぶと ID が自動で決まります。ID セルには入力しません。

normal の 1回の抽選コストを開き、WithdrawByUserId を1件追加します。namespaceName = Currency、userId = #{userId}、slot = 0、withdrawCount = 20、paidOnly = false とします。保存し、サーバーと Unity へ反映します。

最初に適用した characters.json の LotteryMaster と ShowcaseMaster が、この設定です。二つの景品の重みはどちらも1、商品の消費アクションは20コイン、獲得アクションは Gs2Lottery:DrawByUserId です。

左側の冒険画面でコインを20枚以上集めてから、右側の20 コインでガチャを引くを押します。所持一覧に騎士か魔法使いが1体追加されます。左側のコインが20枚減ったことも確認します。

購入には Showcase を使い、その獲得アクションから Lottery の抽選を実行します。

private async UniTask Draw(string requestId)
{
    var transaction = await Client.Showcase.Namespace(GachaNamespace).Me(Session)
        .Showcase("Showcase").DisplayItem("normal").BuyAsync(
            1, speculativeExecute: false, duplicationAvoider: requestId);
    if (transaction != null) await transaction.WaitAsync(all: true);
}

3. 選んだ1体に経験値を与える

強化には、10コインの消費と経験値10の付与を組み合わせた Exchange を使います。

Studio のキャラクター向け強化設定をダウンロードします。マネージメントコンソールの Deploy → スタックを新規作成で、名前を adventure-character-training とし、テンプレートデータでダウンロードしたファイルを選んで作成します。Studio が作った Currency と CharacterExperience を参照する設定です。

SDK のキャラクター向け強化設定をダウンロードします。Deploy → スタックを新規作成で名前を adventure-character-training とし、テンプレートデータでダウンロードしたファイルを選んで作成します。adventure-coin と adventure-character-experience を参照します。

  1. 右側の所持一覧で、強化する個体の行を選びます。
  2. 選んだ個体の経験値を読むを押し、現在値を控えます。
  3. 10 コインで経験値を 10 増やすを押します。経験値の表示が自動で更新され、10増えます。
  4. 別の個体を選んで経験値を読み、そちらの経験値は増えていないことを確かめます。

ボタンを押した時点で選んでいた ItemSetId を Train() に渡します。コードはその値に :level を付けて、経験値の保存先を指定します。config の値がテンプレート内の #{propertyId} に入ります。

private async UniTask Train(string itemSetId, string requestId)
{
    var transaction = await Client.Exchange.Namespace("adventure-character-training").Me(Session).Exchange()
        .ExchangeAsync("train", 1, config: new[] {
            new Gs2.Unity.Gs2Exchange.Model.EzConfig { Key = "propertyId", Value = itemSetId + ":level" }
        }, speculativeExecute: false, duplicationAvoider: requestId);
    if (transaction != null) await transaction.WaitAsync(all: true);
}

4. 3枠のパーティを保存する

機能を追加で「パーティ編成」を追加します。表 → パーティ編成で次を入力し、サーバーと Unity へ反映します。

表行入力する内容
編成（CharacterFormation）行を追加を押す（ID の入力は不要）初期保存枠 1、最大保存枠 1
編成スロット（CharacterFormationSlot）slot1、slot2、slot3 の3行を追加配置条件は各行とも .*

characters.json の FormationMaster に3枠を設定済みです。CharacterFormation の保存先 0 を使います。

  1. 編成を読み込むを押してから、所持一覧で1体を選び、スロット 1 に選んだ個体を入れるを押します。
  2. 別の個体を選び、スロット2へ入れます。3体あればスロット3にも入れます。空き枠は空のまま保存できます。
  3. 編成を保存するを押します。
  4. 再生を止めて再開し、同じプレイヤーでログインして 編成を読み込むを押します。同じ個体IDが各枠に表示されます。

保存時は Inventory の GetItemWithSignatureAsync() で所持を証明する署名を取得し、Formation の SetFormAsync() に渡します。コードには、同じ個体を二つの枠へ入れたときのチェックも入っています。

次へ：プレイヤー同士をつなぐ