> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Economy (Legacy) の時限消費可能アイテム

> Game Manager で PlayFab Legacy Economy の時限消費可能アイテムを構成し、設定した期間が経過するとプレイヤーのインベントリからアイテムが自動的に消費されるようにします。

# 時限消費可能アイテム (Legacy Economy)

> [!NOTE]
>
> Economy v1 API はメンテナンス モードにあり、新機能は追加されず、バグ修正のみが行われます。**v1 API は当面の間、維持されます。** PlayFab Economy の次のバージョンの詳細については、[Economy v2 の概要](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/overview.md) を参照してください。

このチュートリアルでは、PlayFab Game Manager を使用して時限消費可能アイテム (timed consumables) を作成する手順を説明します。時限消費可能アイテムは、プレイヤーに最初に付与されてから特定の時間が経過すると自動的に消費されるように構成されたアイテムです。

## 要件

* [カタログ](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy/items/catalogs.md)、[インベントリ](https://docs.xbox.com/ja-jp/services/playfab/player-progression/player-data/player-inventory.md)、および PlayFab [Game Manager](https://docs.xbox.com/ja-jp/services/playfab/live-service-management/gamemanager/quickstart.md) に既に精通していることを前提としています。
* *プライマリ カタログ* が必要です。

## スタック可能な時限消費可能アイテムの作成

付与時にプレイヤーのスタミナを 5 分間ブーストし、時間範囲を 5 分ずつ延長する Small Stamina Potion を作成しましょう。Game Manager で:

1. **タイトル** に移動します。
2. 左側のメニューから **Economy** を選択します。
3. **Catalogs** タブに移動し、プライマリ カタログを選択します。画面はこの例と似ているはずです。

   ![Game Manager - Timed Consumables - Items Tab With One Item](https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-items-tab.png?fit=max\&auto=format\&n=Oa_DP1q6U1lat7c2\&q=85\&s=07324205042b82707322d0144072dc89)
4. 右上隅にある **New item** を選択します。
5. 次のフィールドに入力します。

   | フィールド名 | サンプル値 | 説明 |
   | :-: | :-: | - |
   | Item ID | Small\_Stamina\_Potion | この *必須* フィールドは、カタログ内のアイテムの一意識別子です。アイテム ID はカタログ内で一意である必要がありますが、同じアイテム ID を含むアイテムを持つ複数のカタログ バージョンを持つことができます。 |
   | Display Name | Small Stamina Potion | この *オプション* フィールドは、カタログ アイテムに表示される名前です。よくある用途は、ゲーム内ストアでアイテムを提供したい場合です。表示名は一意である必要はありません。 |
   | Consumable | Consumable | アイテムが **Durable** か **Consumable** かを示します。 |
   | By Count | 1 | このフィールドは、**Consumable** が選択されている場合に *必須* です。消費時にそのアイテムの数がどれだけ減るかを決定します。 |
   | By Time | 5 Minutes | このフィールドは、**Consumable** が選択されている場合に *オプション* です。アイテムが付与された瞬間から消費される瞬間までに経過する時間を決定します。 |
   | Time Group Name | Small\_Stamina\_Potion | このフィールドは、**Consumable** が選択されている場合に *オプション* です。同じグループ名で複数のアイテム消費時間を結合できます。 |
   | Is Stackable | True | アイテムを **Stackable** としてマークすると、この種類のアイテムはインベントリに 1 つしか存在せず、アイテムの数量カウントが増加します。 |

   ![Game Manager - Timed Consumables - Stackable Item](https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-stackable.png?fit=max\&auto=format\&n=Oa_DP1q6U1lat7c2\&q=85\&s=84e03786b569afc2859a00d3dddde7ab)
6. **Save item** を選択します。

これで、これらのポーションをスタックでき、残り時間も自動的に "スタック" されるようになります。たとえば、1:00 PM にプレイヤーに 1 つの Small Stamina Potion を付与すると、そのアイテムは 1:05 PM に消費されます。1:02 PM に別の Small Stamina Potion を付与すると、2 つのアイテムは 1:10 PM に消費されます。

> [!NOTE]
>
> スタック可能な時限消費可能アイテムに Time Group Name を指定しない場合、フル スタックは最初の付与からの元の有効期限で期限切れになります。たとえば、上記のシナリオで、Time Group Name を空欄のままにした場合、1:00 PM にプレイヤーに 1 つの Small Stamina Potion を付与すると、そのアイテムは 1:05 PM に消費されます。1:02 PM に別の Small Stamina Potion を付与しても、2 つのアイテムは依然として 1:05 PM に消費されます。1:04 PM にさらに別の Small Stamina Potion を付与しても、3 つのアイテムは依然として 1:05 PM に消費されます。しかし、スタックが消費された後、1:10 PM に Small Stamina Potion を付与すると、そのアイテムは 1:15 PM に消費されます。

## スタック不可能な時限消費可能アイテムの作成

先ほどと同様の例を作成しますが、今度はスタック不可能なアイテムを使用します。付与時にプレイヤーのスタミナを 10 分間ブーストし、追加アイテムごとに時間範囲をさらに 10 分ずつ延長する Medium Stamina Potion を作成しましょう。Game Manager で:

1. **タイトル** に移動します。
2. 左側のメニューから **Economy** を選択します。
3. **Catalogs** タブに移動し、プライマリ カタログを選択します。画面はこの例と似ているはずです。

   ![Game Manager - Timed Consumables - Items Tab With Two Items](https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-items-tab-2.png?fit=max\&auto=format\&n=Oa_DP1q6U1lat7c2\&q=85\&s=106ecb5bb2ee7f236a73460377e6c563)
4. 右上隅にある **New item** を選択します。
5. 次のフィールドに入力します。

   | フィールド名 | サンプル値 | 説明 |
   | :-: | :-: | - |
   | Item ID | Med\_Stamina\_Potion | この *必須* フィールドは、カタログ内のアイテムの一意識別子です。アイテム ID はカタログ内で一意である必要がありますが、同じアイテム ID を含むアイテムを持つ複数のカタログ バージョンを持つことができます。 |
   | Display Name | Medium Stamina Potion | この *オプション* フィールドは、カタログ アイテムに表示される名前です。よくある用途は、ゲーム内ストアでアイテムを提供したい場合です。表示名は一意である必要はありません。 |
   | Consumable | Consumable | アイテムが **Durable** か **Consumable** かを示します。 |
   | By Count | 1 | この *必須* フィールド (**Consumable** が選択されている場合) は、消費時にそのアイテムの数がどれだけ減るかを決定します。 |
   | By Time | 10 Minutes | この *オプション* フィールド (**Consumable** が選択されている場合) は、アイテムが付与された瞬間から消費される瞬間までに経過する時間を決定します。 |
   | Time Group Name | Med\_Stamina\_Potion | この *オプション* フィールド (**Consumable** が選択されている場合) は、同じグループ名で複数のアイテム消費時間を結合できます。 |
   | Is Stackable | False | アイテムを **Stackable** としてマークすると、この種類のアイテムはインベントリに 1 つしか存在せず、アイテムの数量カウントが増加します。 |

   ![Game Manager - Timed Consumables - Non-Stackable Item](https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-non-stackable.png?fit=max\&auto=format\&n=Oa_DP1q6U1lat7c2\&q=85\&s=77e85186bc62bdbd92c87506f6698f13)
6. **Save item** を選択します。

これで、追加の Medium Stamina Potion を付与するたびに、アイテムはスタック不可能なので、プレイヤーのインベントリに完全に新しいインスタンスが作成されます。それでも、これらのアイテムの残り時間は自動的に "スタック" できます。たとえば、1:00 PM にプレイヤーに 1 つの Medium Stamina Potion を付与すると、そのアイテムは 1:10 PM に消費されます。1:05 PM に別の Medium Stamina Potion を付与すると、2 つのアイテムは 1:20 PM に消費されます。

> [!NOTE]
>
> スタック不可能な時限消費可能アイテムに Time Group Name を指定しない場合、各インスタンスは互いに独立して期限切れになります。たとえば、上記のシナリオで Time Group Name を空欄のままにした場合、1:00 PM にプレイヤーに 1 つの Medium Stamina Potion を付与すると、そのアイテムは 1:10 PM に消費されます。1:05 PM に別の Medium Stamina Potion を付与すると、最初のアイテムは依然として 1:10 PM に消費され、2 番目のアイテムは 1:15 PM に消費されます。

## 複数の時限消費可能アイテムをリンクする

Small Potion (スタック可能) と Medium Potion (スタック不可能) ができたので、それら 2 つのタイマーをリンクしましょう。いくつかのフィールドを変更して、Small または Medium Stamina Potion が付与されるとプレイヤーのスタミナがブーストされ、Small または Medium Stamina Potion ごとに時間範囲をそれぞれ 5 分または 10 分ずつ延長するようにします。Game Manager で:

1. **タイトル** に移動します。
2. 左側のメニューから **Economy** を選択します。
3. **Catalogs** タブに移動し、プライマリ カタログを選択します。画面はこの例と似ているはずです。

   ![Game Manager - Timed Consumables - Items Tab With Three Items](https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-items-tab-3.png?fit=max\&auto=format\&n=Oa_DP1q6U1lat7c2\&q=85\&s=0db8f5c8cba28d73e06ee7fa3cf37748)
4. アイテム リストで **Med\_Stamina\_Potion** を選択します。
5. **Time Group Name** を `Med_Stamina_Potion` から `Stamina_Potion` に変更します。
6. **Save item** を選択します。
7. アイテム リストで **Small\_Stamina\_Potion** を選択します。
8. **Time Group Name** を `Small_Stamina_Potion` から `Stamina_Potion` に変更します。
9. **Save item** を選択します。

これで、追加の Small または Medium Stamina Potion を付与するたびに、同じ Time Group Name を持つすべてのアイテムの残り時間が自動的に "スタック" されます。たとえば、1:00 PM にプレイヤーに 1 つの Medium Stamina Potion を付与すると、そのアイテムは 1:10 PM に消費されます。1:05 PM に Small Stamina Potion を付与すると、2 つのアイテムは 1:15 PM に消費されます。


## Related topics

- [消費可能なアドオン](https://docs.xbox.com/ja-jp/publishing/game-publishing/concepts/add-ons/consumable-add-ons.md)
- [アイテムの消費](https://docs.xbox.com/ja-jp/services/playfab/api-references/rest/server/player-item-management/consume-item.md)
- [Economy (Legacy) のドロップ テーブル](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy/tutorials/drop-tables.md)
- [アイテム (Legacy Economy)](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy/items/index.md)
- [カタログ (レガシー Economy)](https://docs.xbox.com/ja-jp/services/playfab/economy-monetization/economy/items/catalogs.md)
