Passer au contenu principal

Consommables temporisés (Economy hérité)

Les API Economy v1 sont en mode maintenance et ne recevront plus de nouvelles fonctionnalités, uniquement 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 objets configurés pour être consommés automatiquement après un délai donné à compter de leur octroi initial au joueur.

Prérequis

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 le Game Manager :
  1. Accédez à votre titre.
  2. Sélectionnez Economy dans le menu de gauche.
  3. Accédez à l’onglet Catalogs et choisissez votre catalogue principal. Votre écran doit ressembler à cet exemple : Game Manager - Consommables temporisés - Onglet Items avec un objet
  4. Sélectionnez New item dans l’angle supérieur droit.
  5. Renseignez les champs suivants : Game Manager - Consommables temporisés - Objet 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 00, l’objet sera consommé à 13 h 05. Si j’octroie une autre petite potion d’endurance à 13 h 02, les deux objets seront consommés à 13 h 10.
Si vous ne spécifiez pas de nom de groupe temporel pour un consommable temporisé empilable, la pile entière expirera à l’heure d’expiration initiale définie lors du premier octroi. Par exemple, dans le scénario ci-dessus, si je laisse le nom de groupe temporel vide et que j’octroie une petite potion d’endurance à un joueur à 13 h 00, l’objet sera consommé à 13 h 05. Si j’octroie une autre petite potion d’endurance à 13 h 02, les deux objets seront toujours consommés à 13 h 05. Si j’octroie encore une autre petite potion d’endurance à 13 h 04, les trois objets seront toujours consommés à 13 h 05. Mais une fois la pile consommée, si j’octroie une petite potion d’endurance à 13 h 10, l’objet sera consommé à 13 h 15.

Créer un consommable temporisé non empilable

Créons un exemple similaire au précédent, mais avec un objet 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 objet supplémentaire. Dans le Game Manager :
  1. Accédez à votre titre.
  2. Sélectionnez Economy dans le menu de gauche.
  3. Accédez à l’onglet Catalogs et choisissez votre catalogue principal. Votre écran doit ressembler à cet exemple : Game Manager - Consommables temporisés - Onglet Items avec deux objets
  4. Sélectionnez New item dans l’angle supérieur droit.
  5. Renseignez les champs suivants : Game Manager - Consommables temporisés - Objet 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, car l’objet n’est pas empilable. Vous pourrez toujours « empiler » automatiquement le temps restant pour ces objets. Par exemple, si j’octroie une potion d’endurance moyenne à un joueur à 13 h 00, l’objet sera consommé à 13 h 10. Si j’octroie une autre potion d’endurance moyenne à 13 h 05, les deux objets seront consommés à 13 h 20.
Si vous ne spécifiez pas de nom de groupe temporel pour un consommable temporisé non empilable, chaque instance expirera indépendamment des autres. Par exemple, dans le scénario ci-dessus, si je laisse le nom de groupe temporel vide et que j’octroie une potion d’endurance moyenne à un joueur à 13 h 00, l’objet sera consommé à 13 h 10. Si j’octroie une autre potion d’endurance moyenne à 13 h 05, le premier objet sera toujours consommé à 13 h 10, et le second sera consommé à 13 h 15.

Lier plusieurs consommables temporisés

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