> ## 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.

# Consumíveis temporizados no Economy (Legado)

> Configure consumíveis temporizados do PlayFab Economy Legado no Game Manager para que os itens sejam consumidos automaticamente do inventário de um jogador após uma duração definida.

# Consumíveis temporizados (Economy Legado)

<Info>
  As APIs do Economy v1 estão em modo de manutenção e não receberão novos recursos, apenas correções de bugs. **As APIs v1 serão mantidas no futuro próximo.** Consulte a [Visão geral do Economy v2](/pt-BR/services/playfab/economy-monetization/economy-v2/overview) para saber mais sobre a próxima versão do PlayFab Economy!
</Info>

Este tutorial orienta você na criação de consumíveis temporizados usando o PlayFab Game Manager. Consumíveis temporizados são itens configurados para serem consumidos automaticamente após um tempo específico a partir da concessão inicial ao jogador.

## Requisitos

* Presumimos que você já esteja familiarizado com [Catálogos](/pt-BR/services/playfab/economy-monetization/economy/items/catalogs), [Inventário](/pt-BR/services/playfab/player-progression/player-data/player-inventory) e o [Game Manager](/pt-BR/services/playfab/live-service-management/gamemanager/quickstart) do PlayFab.
* Você deve ter um *catálogo principal*.

## Criar um consumível temporizado empilhável

Vamos criar uma pequena poção de vigor que aumenta o vigor do seu jogador por cinco minutos quando concedida e aumenta o intervalo de tempo em cinco minutos. No Game Manager:

1. Navegue até seu **Título**.
2. Selecione **Economy** no menu à esquerda.
3. Vá para a guia **Catálogos** e escolha seu catálogo principal - sua tela deve ser semelhante a este exemplo:
   <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 - Consumíveis temporizados - Guia Itens com um item" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-items-tab.png" />
4. Selecione **Novo item** no canto superior direito.
5. Preencha os seguintes campos:

   | Nome do campo | Valor de exemplo | Descrição |
   | :-: | :-: | - |
   | Item ID | Small\_Stamina\_Potion | Este campo *obrigatório* é o identificador exclusivo do item no Catálogo. O ID do item deve ser exclusivo no Catálogo, mas você pode ter várias versões de catálogo contendo itens com o mesmo ID de item. |
   | Display Name | Small Stamina Potion | Este campo *opcional* é o nome exibido para o item do catálogo. Um uso comum é quando você deseja oferecer o item na loja do jogo. Os nomes de exibição não precisam ser exclusivos. |
   | Consumable | Consumable | Indica se o item é **Durável** ou **Consumível**. |
   | By Count | 1 | Este campo é *obrigatório* quando **Consumível** está selecionado. Ele determina em quanto a contagem desse item será diminuída quando consumido. |
   | By Time | 5 Minutes | Este campo é *opcional* quando **Consumível** está selecionado. Ele determina a quantidade de tempo que decorrerá desde o momento em que o item é concedido até o momento em que é consumido. |
   | Time Group Name | Small\_Stamina\_Potion | Este campo é *opcional* quando **Consumível** está selecionado. Ele permite unir os tempos de consumo de vários itens com o mesmo nome de grupo. |
   | Is Stackable | True | Marcar um item como **Empilhável** permite apenas um item desse tipo no inventário e incrementa a contagem de quantidade do item. |

   <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 - Consumíveis temporizados - Item empilhável" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-stackable.png" />
6. Selecione **Salvar item**.

Agora você poderá empilhar essas poções, e o tempo restante também será "empilhado" automaticamente. Por exemplo, se eu conceder uma pequena poção de vigor a um jogador às 13h00, o item será consumido às 13h05. Se eu conceder outra pequena poção de vigor às 13h02, os dois itens serão consumidos às 13h10.

<Note>
  Se você não especificar um nome de grupo de tempo para um consumível temporizado empilhável, a pilha inteira expirará no horário de expiração original definido a partir da primeira concessão. Por exemplo, no cenário acima, se eu deixasse o nome do grupo de tempo em branco, ao conceder uma pequena poção de vigor a um jogador às 13h00, o item seria consumido às 13h05. Se eu conceder outra pequena poção de vigor às 13h02, os dois itens ainda serão consumidos às 13h05. Se eu conceder mais uma pequena poção de vigor às 13h04, os três itens ainda serão consumidos às 13h05. Mas, depois que a pilha for consumida, se eu conceder uma pequena poção de vigor às 13h10, o item será consumido às 13h15.
</Note>

## Criar um consumível temporizado não empilhável

Vamos criar um exemplo semelhante ao anterior, mas com um item não empilhável. Vamos criar uma poção de vigor média que aumentará o vigor do seu jogador por 10 minutos quando concedida e aumentará o intervalo de tempo em 10 minutos adicionais para cada item adicional. No Game Manager:

1. Navegue até seu **Título**.
2. Selecione **Economy** no menu à esquerda.
3. Vá para a guia **Catálogos** e escolha seu catálogo principal - sua tela deve ser semelhante a este exemplo:
   <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 - Consumíveis temporizados - Guia Itens com dois itens" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-items-tab-2.png" />
4. Selecione **Novo item** no canto superior direito.
5. Preencha os seguintes campos:

   | Nome do campo | Valor de exemplo | Descrição |
   | :-: | :-: | - |
   | Item ID | Med\_Stamina\_Potion | Este campo *obrigatório* é o identificador exclusivo do item no Catálogo. O ID do item deve ser exclusivo no Catálogo, mas você pode ter várias versões de catálogo contendo itens com o mesmo ID de item. |
   | Display Name | Medium Stamina Potion | Este campo *opcional* é o nome exibido para o item do catálogo. Um uso comum é quando você deseja oferecer o item na loja do jogo. Os nomes de exibição não precisam ser exclusivos. |
   | Consumable | Consumable | Indica se o item é **Durável** ou **Consumível**. |
   | By Count | 1 | Este campo *obrigatório* (quando **Consumível** está selecionado) determina em quanto a contagem desse item será diminuída quando consumido. |
   | By Time | 10 Minutes | Este campo *opcional* (quando **Consumível** está selecionado) determina a quantidade de tempo que decorrerá desde o momento em que o item é concedido até o momento em que é consumido. |
   | Time Group Name | Med\_Stamina\_Potion | Este campo *opcional* (quando **Consumível** está selecionado) permite unir os tempos de consumo de vários itens com o mesmo nome de grupo. |
   | Is Stackable | False | Marcar um item como **Empilhável** permite apenas um item desse tipo no inventário e incrementa a contagem de quantidade do item. |

   <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 - Consumíveis temporizados - Item não empilhável" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-non-stackable.png" />
6. Selecione **Salvar item**.

Agora, toda vez que você conceder uma poção de vigor média adicional, ela criará uma instância totalmente nova no inventário do jogador, pois o item não é empilhável. Você ainda poderá "empilhar" automaticamente o tempo restante desses itens. Por exemplo, se eu conceder uma poção de vigor média a um jogador às 13h00, o item será consumido às 13h10. Se eu conceder outra poção de vigor média às 13h05, os dois itens serão consumidos às 13h20.

<Note>
  Se você não especificar um nome de grupo de tempo para um consumível temporizado não empilhável, cada instância expirará de forma independente. Por exemplo, no cenário acima, se eu deixasse o nome do grupo de tempo em branco, ao conceder uma poção de vigor média a um jogador às 13h00, o item seria consumido às 13h10. Se eu conceder outra poção de vigor média às 13h05, o primeiro item ainda será consumido às 13h10, e o segundo item será consumido às 13h15.
</Note>

## Vincular vários consumíveis temporizados

Agora que você tem uma Poção pequena (empilhável) e uma Poção média (não empilhável), vamos vincular esses dois temporizadores. Vamos modificar alguns campos para permitir que o vigor do seu jogador seja aumentado quando as poções de vigor pequenas ou médias forem concedidas e aumentar o intervalo de tempo em 5 ou 10 minutos adicionais para cada poção de vigor pequena ou média, respectivamente. No Game Manager:

1. Navegue até seu **Título**.
2. Selecione **Economy** no menu à esquerda.
3. Vá para a guia **Catálogos** e escolha seu catálogo principal - sua tela deve ser semelhante a este exemplo:
   <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 - Consumíveis temporizados - Guia Itens com três itens" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-items-tab-3.png" />
4. Selecione **Med\_Stamina\_Potion** na lista de itens.
5. Altere o **Nome do grupo de tempo** de `Med_Stamina_Potion` para `Stamina_Potion`.
6. Selecione **Salvar item**.
7. Selecione **Small\_Stamina\_Potion** na lista de itens.
8. Altere o **Nome do grupo de tempo** de `Small_Stamina_Potion` para `Stamina_Potion`.
9. Selecione **Salvar item**.

Agora, toda vez que você conceder uma poção de vigor pequena ou média adicional, ela "empilhará" automaticamente o tempo restante de todos os itens com o mesmo nome de grupo de tempo. Por exemplo, se eu conceder uma poção de vigor média a um jogador às 13h00, o item será consumido às 13h10. Se eu conceder uma pequena poção de vigor às 13h05, os dois itens serão consumidos às 13h15.


## Related topics

- [Lojas e promoções no Economy (Legado)](/pt-BR/services/playfab/economy-monetization/economy/tutorials/stores-and-sales.md)
- [Catálogos (Economy Legado)](/pt-BR/services/playfab/economy-monetization/economy/items/catalogs.md)
- [Itens (Economy Legado)](/pt-BR/services/playfab/economy-monetization/economy/items/index.md)
- [Lojas (Economy Legado)](/pt-BR/services/playfab/economy-monetization/economy/stores/index.md)
- [Início rápido de lojas (Economy Legado)](/pt-BR/services/playfab/economy-monetization/economy/stores/quickstart.md)