Passer au contenu principal

​
Consommables temporisés (Economy Legacy)

Les API Economy v1 sont en mode maintenance et ne recevront aucune nouvelle fonctionnalité, seulement des correctifs de bogues. Les API v1 seront maintenues dans un avenir prévisible. Consultez la vue d’ensemble d’Economy v2 pour en savoir plus sur la prochaine version de PlayFab Economy!
Ce tutoriel vous guide dans la création de consommables temporisés à l’aide du Game Manager de PlayFab. Les consommables temporisés sont des articles configurés pour être consommés automatiquement après un délai précis à compter de leur octroi initial au joueur.

​
Exigences

​
Créer un consommable temporisé empilable

Créons une petite potion d’endurance qui augmente l’endurance de votre joueur pendant cinq minutes lorsqu’elle est octroyée, et qui prolonge la durée de cinq minutes. Dans Game Manager :
  1. Accédez à votre titre.
  2. Sélectionnez Economy dans le menu de gauche.
  3. Allez dans l’onglet Catalogs et choisissez votre catalogue principal - votre écran devrait ressembler à cet exemple : Game Manager - Consommables temporisés - Onglet Items avec un article
  4. Sélectionnez New item dans le coin supérieur droit.
  5. Remplissez les champs suivants : Game Manager - Consommables temporisés - Article empilable
  6. Sélectionnez Save item.
Vous pourrez désormais empiler ces potions, et le temps restant s’« empilera » automatiquement lui aussi. Par exemple, si j’octroie une petite potion d’endurance à un joueur à 13 h, l’article sera consommé à 13 h 05. Si j’octroie une autre petite potion d’endurance à 13 h 02, les deux articles seront consommés à 13 h 10.
Si vous ne spécifiez pas de nom de groupe de temps pour un consommable temporisé empilable, la pile complète expirera au moment de l’expiration initiale définie lors du premier octroi. Par exemple, dans le scénario ci-dessus, si je laissais plutôt le nom de groupe de temps vide et que j’octroyais une petite potion d’endurance à un joueur à 13 h, l’article serait consommé à 13 h 05. Si j’octroie une autre petite potion d’endurance à 13 h 02, les deux articles seront tout de même consommés à 13 h 05. Si j’octroie encore une autre petite potion d’endurance à 13 h 04, les trois articles seront tout de même consommés à 13 h 05. Mais une fois la pile consommée, si j’octroie une petite potion d’endurance à 13 h 10, l’article sera consommé à 13 h 15.

​
Créer un consommable temporisé non empilable

Créons un exemple semblable au précédent, mais avec un article non empilable. Créons une potion d’endurance moyenne qui augmentera l’endurance de votre joueur pendant 10 minutes lorsqu’elle est octroyée, et qui prolongera la durée de 10 minutes supplémentaires pour chaque article additionnel. Dans Game Manager :
  1. Accédez à votre titre.
  2. Sélectionnez Economy dans le menu de gauche.
  3. Allez dans l’onglet Catalogs et choisissez votre catalogue principal - votre écran devrait ressembler à cet exemple : Game Manager - Consommables temporisés - Onglet Items avec deux articles
  4. Sélectionnez New item dans le coin supérieur droit.
  5. Remplissez les champs suivants : Game Manager - Consommables temporisés - Article non empilable
  6. Sélectionnez Save item.
Désormais, chaque fois que vous octroyez une potion d’endurance moyenne supplémentaire, une instance entièrement nouvelle est créée dans l’inventaire du joueur, puisque l’article n’est pas empilable. Vous pourrez tout de même « empiler » automatiquement le temps restant de ces articles. Par exemple, si j’octroie une potion d’endurance moyenne à un joueur à 13 h, l’article sera consommé à 13 h 10. Si j’octroie une autre potion d’endurance moyenne à 13 h 05, les deux articles seront consommés à 13 h 20.
Si vous ne spécifiez pas de nom de groupe de temps pour un consommable temporisé non empilable, chaque instance expirera indépendamment des autres. Par exemple, dans le scénario ci-dessus, si je laissais plutôt le nom de groupe de temps vide et que j’octroyais une potion d’endurance moyenne à un joueur à 13 h, l’article serait consommé à 13 h 10. Si j’octroie une autre potion d’endurance moyenne à 13 h 05, le premier article sera tout de même consommé à 13 h 10, et le deuxième article sera consommé à 13 h 15.

​
Lier plusieurs consommables temporisés

Maintenant que vous avez une petite potion (empilable) et une potion moyenne (non empilable), lions ces deux minuteries ensemble. Modifions quelques champs pour que l’endurance de votre joueur soit augmentée lorsque les petites ou moyennes potions d’endurance sont octroyées, et pour prolonger la durée de 5 ou 10 minutes supplémentaires pour chaque petite ou moyenne potion d’endurance, respectivement. Dans Game Manager :
  1. Accédez à votre titre.
  2. Sélectionnez Economy dans le menu de gauche.
  3. Allez dans l’onglet Catalogs et choisissez votre catalogue principal - votre écran devrait ressembler à cet exemple : Game Manager - Consommables temporisés - Onglet Items avec trois articles
  4. Sélectionnez Med_Stamina_Potion dans la liste des articles.
  5. Remplacez la valeur de Time Group Name Med_Stamina_Potion par Stamina_Potion.
  6. Sélectionnez Save item.
  7. Sélectionnez Small_Stamina_Potion dans la liste des articles.
  8. Remplacez la valeur de Time Group Name Small_Stamina_Potion par Stamina_Potion.
  9. Sélectionnez Save item.
Désormais, chaque fois que vous octroyez une petite ou moyenne potion d’endurance supplémentaire, le temps restant de tous les articles portant le même nom de groupe de temps s’« empilera » automatiquement. Par exemple, si j’octroie une potion d’endurance moyenne à un joueur à 13 h, l’article sera consommé à 13 h 10. Si j’octroie une petite potion d’endurance à 13 h 05, les deux articles seront consommés à 13 h 15.
Dernière modification le 6 octobre 2026

Sujets connexes

Magasins et soldes dans Economy (Legacy)Tables de butin dans Economy (hérité)Extensions consommablesCatalogues (Economy hérité)Échange avec la place de marché Microsoft Store