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

# Economy(레거시)에서의 시간 제한 소모품

> 설정된 지속 시간 후 플레이어의 인벤토리에서 아이템이 자동으로 소비되도록 Game Manager에서 PlayFab 레거시 Economy 시간 제한 소모품을 구성합니다.

# 시간 제한 소모품(레거시 Economy)

<Info>
  Economy v1 API는 유지 관리 모드에 있으며 새 기능은 제공되지 않고 버그 수정만 이루어집니다. **v1 API는 예측 가능한 미래 동안 유지됩니다.** 다음 버전의 PlayFab Economy에 대해 자세히 알아보려면 [Economy v2 개요](/services/playfab/economy-monetization/economy-v2/overview)를 참조하세요!
</Info>

이 튜토리얼에서는 PlayFab Game Manager를 사용해 시간 제한 소모품을 만드는 과정을 안내합니다. 시간 제한 소모품은 플레이어에게 최초 부여된 시간부터 특정 시간이 지나면 자동으로 소비되도록 구성된 아이템입니다.

## 요구 사항

* 사용자가 이미 [카탈로그](/services/playfab/economy-monetization/economy/items/catalogs), [인벤토리](/services/playfab/player-progression/player-data/player-inventory), PlayFab [Game Manager](/services/playfab/live-service-management/gamemanager/quickstart)에 익숙하다고 가정합니다.
* *기본 카탈로그*가 있어야 합니다.

## 스택 가능한 시간 제한 소모품 만들기

부여 시 플레이어의 스태미나를 5분간 증가시키고 시간 범위를 5분씩 늘리는 소형 스태미나 물약을 만들어 보겠습니다. Game Manager에서:

1. **Title**로 이동합니다.
2. 왼쪽 메뉴에서 **Economy**를 선택합니다.
3. **Catalogs** 탭으로 이동하여 기본 카탈로그를 선택합니다. 화면은 이 예제와 유사해야 합니다.
   <img src="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" alt="Game Manager - Timed Consumables - Items Tab With One Item" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-items-tab.png" />
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**로 표시하면 인벤토리에 이 유형의 아이템이 하나만 허용되고 아이템의 수량 개수가 증가합니다.                                          |

   <img src="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" alt="Game Manager - Timed Consumables - Stackable Item" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-stackable.png" />
6. **Save item**을 선택합니다.

이제 이러한 물약을 쌓을 수 있으며 남은 시간도 자동으로 "스택"됩니다. 예를 들어, 오후 1시에 플레이어에게 소형 스태미나 물약 하나를 부여하면 아이템은 오후 1시 5분에 소비됩니다. 오후 1시 2분에 다른 소형 스태미나 물약을 부여하면 두 아이템은 오후 1시 10분에 소비됩니다.

<Note>
  스택 가능한 시간 제한 소모품에 대해 시간 그룹 이름을 지정하지 않으면 첫 번째 부여에서 설정된 원래 만료 시간에 전체 스택이 만료됩니다. 예를 들어 위 시나리오에서 시간 그룹 이름을 비워두면 오후 1시에 플레이어에게 소형 스태미나 물약 하나를 부여하면 아이템은 오후 1시 5분에 소비됩니다. 오후 1시 2분에 다른 소형 스태미나 물약을 부여해도 두 아이템은 여전히 오후 1시 5분에 소비됩니다. 오후 1시 4분에 또 다른 소형 스태미나 물약을 부여해도 세 아이템은 여전히 오후 1시 5분에 소비됩니다. 그러나 스택이 소비된 후 오후 1시 10분에 소형 스태미나 물약을 부여하면 아이템은 오후 1시 15분에 소비됩니다.
</Note>

## 스택 불가능한 시간 제한 소모품 만들기

이전과 유사한 예제를 만들되 스택 불가능한 아이템으로 만들어 보겠습니다. 부여 시 플레이어의 스태미나를 10분간 증가시키고 추가 아이템마다 시간 범위를 10분씩 추가로 늘리는 중형 스태미나 물약을 만들어 보겠습니다. Game Manager에서:

1. **Title**로 이동합니다.
2. 왼쪽 메뉴에서 **Economy**를 선택합니다.
3. **Catalogs** 탭으로 이동하여 기본 카탈로그를 선택합니다. 화면은 이 예제와 유사해야 합니다.
   <img src="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" alt="Game Manager - Timed Consumables - Items Tab With Two Items" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-items-tab-2.png" />
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**로 표시하면 인벤토리에 이 유형의 아이템이 하나만 허용되고 아이템의 수량 개수가 증가합니다.                                          |

   <img src="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" alt="Game Manager - Timed Consumables - Non-Stackable Item" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-non-stackable.png" />
6. **Save item**을 선택합니다.

이제 추가 중형 스태미나 물약을 부여할 때마다 아이템이 스택 가능하지 않으므로 플레이어의 인벤토리에 완전히 새로운 인스턴스가 생성됩니다. 여전히 해당 아이템에 대한 남은 시간을 자동으로 "스택"할 수 있습니다. 예를 들어, 오후 1시에 플레이어에게 중형 스태미나 물약 하나를 부여하면 아이템은 오후 1시 10분에 소비됩니다. 오후 1시 5분에 다른 중형 스태미나 물약을 부여하면 두 아이템은 오후 1시 20분에 소비됩니다.

<Note>
  스택 불가능한 시간 제한 소모품에 대해 시간 그룹 이름을 지정하지 않으면 각 인스턴스는 서로 독립적으로 만료됩니다. 예를 들어, 위 시나리오에서 시간 그룹 이름을 비워두면 오후 1시에 플레이어에게 중형 스태미나 물약 하나를 부여하면 아이템은 오후 1시 10분에 소비됩니다. 오후 1시 5분에 다른 중형 스태미나 물약을 부여하면 첫 번째 아이템은 여전히 오후 1시 10분에 소비되고 두 번째 아이템은 오후 1시 15분에 소비됩니다.
</Note>

## 여러 시간 제한 소모품 연결

이제 소형 물약(스택 가능)과 중형 물약(스택 불가능)이 있으므로 두 타이머를 함께 연결해 보겠습니다. 소형 또는 중형 스태미나 물약이 부여될 때 플레이어의 스태미나가 증가하도록 몇 개의 필드를 수정하고, 각 소형 또는 중형 스태미나 물약에 대해 각각 5분 또는 10분씩 시간 범위를 추가로 늘리겠습니다. Game Manager에서:

1. **Title**로 이동합니다.
2. 왼쪽 메뉴에서 **Economy**를 선택합니다.
3. **Catalogs** 탭으로 이동하여 기본 카탈로그를 선택합니다. 화면은 이 예제와 유사해야 합니다.
   <img src="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" alt="Game Manager - Timed Consumables - Items Tab With Three Items" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-items-tab-3.png" />
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**을 선택합니다.

이제 추가 소형 또는 중형 스태미나 물약을 부여할 때마다 동일한 시간 그룹 이름을 가진 모든 아이템의 남은 시간이 자동으로 "스택"됩니다. 예를 들어, 오후 1시에 플레이어에게 중형 스태미나 물약 하나를 부여하면 아이템은 오후 1시 10분에 소비됩니다. 오후 1시 5분에 소형 스태미나 물약을 부여하면 두 아이템은 오후 1시 15분에 소비됩니다.


## Related topics

- [Economy(레거시)에서의 드롭 테이블](/ko/services/playfab/economy-monetization/economy/tutorials/drop-tables.md)
- [Economy(레거시)에서의 스토어 및 세일](/ko/services/playfab/economy-monetization/economy/tutorials/stores-and-sales.md)
- [Economy(레거시)에서의 쿠폰 및 프로모션](/ko/services/playfab/economy-monetization/economy/tutorials/coupons-and-promotions.md)
- [Economy(레거시)에서의 스토어 세분화 모범 사례](/ko/services/playfab/economy-monetization/economy/tutorials/best-practices-for-store-segmentation.md)
- [Economy(레거시)에서의 플레이어 세그먼트용 사용자 지정 스토어](/ko/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments.md)
