Pular para o conteúdo principal

Consumíveis temporizados (Economy Legado)

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 para saber mais sobre a próxima versão do PlayFab Economy!
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

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: Game Manager - Consumíveis temporizados - Guia Itens com um item
  4. Selecione Novo item no canto superior direito.
  5. Preencha os seguintes campos: Game Manager - Consumíveis temporizados - Item empilhável
  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.
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.

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: Game Manager - Consumíveis temporizados - Guia Itens com dois itens
  4. Selecione Novo item no canto superior direito.
  5. Preencha os seguintes campos: Game Manager - Consumíveis temporizados - Item não empilhável
  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.
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.

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: Game Manager - Consumíveis temporizados - Guia Itens com três itens
  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.
Última modificação em 6 de outubro de 2026