Conteneurs à contenu fixe dans Economy v2

Economy v2 est désormais en disponibilité générale. Pour obtenir de l’aide et donner votre avis, rendez-vous sur le forum PlayFab.

Economy v1 (hérité) disposait d’une fonctionnalité Containers intégrée : des articles de catalogue spéciaux qui, une fois ouverts, accordaient leur contenu à l’inventaire du joueur. Economy v2 n’inclut pas les conteneurs en tant que type d’article natif, mais vous pouvez obtenir le même comportement pour les conteneurs à contenu fixe (conteneurs qui accordent toujours les mêmes articles) en combinant monnaie virtuelle et bundles.

Fonctionnement

Ce modèle utilise trois éléments de base d’Economy v2 :

Une monnaie virtuelle (ou un article empilable) qui représente le conteneur lui-même, par exemple « Treasure Chest Token ».
Un bundle au prix de 1 unité de cette monnaie, contenant les articles que le conteneur doit accorder.
Un appel d’achat dans lequel le joueur dépense 1 jeton pour acheter le bundle, qui est automatiquement déballé et accorde les articles.

Du point de vue du joueur, il reçoit un jeton (via des récompenses de jeu, des achats en boutique, etc.), puis l’« ouvre » pour obtenir les articles qu’il contient, exactement comme fonctionnaient les conteneurs V1.

Prérequis

Un compte développeur PlayFab.
Un titre créé dans Game Manager.
Au moins un article de catalogue publié que vous souhaitez que le conteneur accorde.

Étape 1 : Créer une monnaie virtuelle pour le conteneur

Créez une monnaie virtuelle qui représente le conteneur. Chaque unité de cette monnaie correspond à un conteneur non ouvert.

Game Manager

Accédez à Economy > Catalog (V2) > Currency.
Sélectionnez New currency.
Définissez le Title sur un nom descriptif, tel que Treasure Chest.
Définissez le FriendlyId sur un code court, tel que tc.
Sélectionnez Save and publish.

API REST

Appelez CreateDraftItem :

{
  "Item": {
    "CreatorEntity": {
      "Id": "{{TitleID}}",
      "Type": "title"
    },
    "Type": "currency",
    "AlternateIds": [
      {
        "Type": "FriendlyId",
        "Value": "tc"
      }
    ],
    "Title": {
      "NEUTRAL": "Treasure Chest"
    },
    "Description": {
      "NEUTRAL": "A treasure chest that can be opened to reveal its contents."
    },
    "StartDate": "2023-07-27T00:00:00.000Z"
  },
  "Publish": true
}

Étape 2 : Créer un bundle au prix d’un jeton de conteneur

Créez un bundle contenant les articles que vous souhaitez que le conteneur accorde. Fixez le prix du bundle à exactement une unité de la monnaie du conteneur.

Game Manager

Accédez à Economy > Catalog (V2) > Bundles.
Sélectionnez New bundle.
Définissez le Title pour décrire le contenu du conteneur, par exemple Treasure Chest Contents.
Sous Items, ajoutez les articles et les quantités que vous souhaitez que le conteneur accorde, par exemple 1 Legendary Sword et 100 Gold.
Sous Price, définissez le prix sur 1 unité de la monnaie de votre conteneur (Treasure Chest).
Sélectionnez Save and publish.

API REST

Appelez CreateDraftItem :

{
  "Item": {
    "Type": "bundle",
    "Title": {
      "NEUTRAL": "Treasure Chest Contents"
    },
    "StartDate": "2023-07-27T00:00:00.000Z",
    "ItemReferences": [
      {
        "Id": "{{LegendarySwordID}}",
        "Amount": 1
      },
      {
        "Id": "{{GoldCurrencyID}}",
        "Amount": 100
      }
    ],
    "PriceOptions": {
      "Prices": [
        {
          "Amounts": [
            {
              "ItemId": "{{TreasureChestCurrencyID}}",
              "Amount": 1
            }
          ]
        }
      ]
    }
  },
  "Publish": true
}

Lorsqu’un joueur achète ce bundle, celui-ci est automatiquement déballé : les articles individuels sont directement ajoutés à l’inventaire du joueur.

Étape 3 : Accorder des jetons de conteneur aux joueurs

Accordez la monnaie du conteneur aux joueurs par tout mécanisme adapté à la conception de votre jeu :

Récompenses de jeu : accordez des jetons après la réussite d’un niveau, d’une quête ou d’un succès à l’aide d’AddInventoryItems.
Achats en boutique : vendez le jeton de conteneur dans une boutique contre une autre monnaie virtuelle ou de l’argent réel.
Passe de combat / récompenses saisonnières : incluez le jeton en tant que palier de récompense.

Exemple d’utilisation d’AddInventoryItems pour accorder trois jetons Treasure Chest :

{
  "Entity": {
    "Type": "title_player_account",
    "Id": "{{PlayerID}}"
  },
  "Item": {
    "Id": "{{TreasureChestCurrencyID}}"
  },
  "Amount": 3
}

Étape 4 : Ouvrir le conteneur

Lorsque le joueur souhaite ouvrir un conteneur, appelez PurchaseInventoryItems pour acheter le bundle avec un jeton de conteneur :

{
  "Entity": {
    "Type": "title_player_account",
    "Id": "{{PlayerID}}"
  },
  "Item": {
    "Id": "{{TreasureChestContentsBundleID}}"
  },
  "Amount": 1,
  "PriceAmounts": [
    {
      "ItemId": "{{TreasureChestCurrencyID}}",
      "Amount": 1
    }
  ]
}

Après un appel réussi, l’inventaire du joueur est mis à jour : un jeton Treasure Chest est déduit et le contenu du bundle (une Legendary Sword + 100 Gold) est ajouté.

Plusieurs types de conteneurs

Créez plusieurs types de conteneurs en répétant ce modèle. Par exemple :

Conteneur	Monnaie (FriendlyId)	Contenu du bundle
Treasure Chest	`tc`	Une Legendary Sword + 100 Gold
Supply Crate	`sc`	Cinq Health Potions + 3 Mana Potions
Premium Box	`pb`	Une Rare Mount + 500 Gold + 50 Gems

Chaque type de conteneur possède sa propre monnaie et son propre bundle.

Utiliser une boutique pour les achats de conteneurs

Utilisez une boutique pour remplacer le prix du bundle du conteneur. Grâce à une boutique, vous pouvez proposer le même conteneur à des prix différents selon le contexte (par exemple, un coût d’« ouverture » réduit pendant un événement) :

{
  "Item": {
    "Type": "store",
    "Title": {
      "NEUTRAL": "Event Store"
    },
    "ItemReferences": [
      {
        "Id": "{{TreasureChestContentsBundleID}}",
        "Amount": 1,
        "PriceOptions": {
          "Prices": [
            {
              "Amounts": [
                {
                  "ItemId": "{{TreasureChestCurrencyID}}",
                  "Amount": 1
                }
              ]
            }
          ]
        }
      }
    ]
  },
  "Publish": true
}

Passez ensuite le StoreId lors de l’achat :

{
  "Entity": {
    "Type": "title_player_account",
    "Id": "{{PlayerID}}"
  },
  "Item": {
    "Id": "{{TreasureChestContentsBundleID}}"
  },
  "Amount": 1,
  "PriceAmounts": [
    {
      "ItemId": "{{TreasureChestCurrencyID}}",
      "Amount": 1
    }
  ],
  "StoreId": "{{EventStoreID}}"
}

Limitations

Ce modèle fonctionne pour les conteneurs au contenu fixe et déterministe. Si vous avez besoin d’un butin aléatoire (dont le contenu varie à chaque ouverture d’un conteneur, comme les conteneurs V1 associés à des tables de butin), consultez le tutoriel Tables de butin et butin aléatoire. Ce tutoriel utilise Azure Functions pour :

Soustraire le jeton de conteneur de l’inventaire du joueur.
Exécuter votre logique de sélection aléatoire pondérée.
Accorder les articles obtenus via les API d’inventaire.

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

Fonctionnement

Prérequis

Étape 1 : Créer une monnaie virtuelle pour le conteneur

Game Manager

API REST

Étape 2 : Créer un bundle au prix d’un jeton de conteneur

Game Manager

API REST

Étape 3 : Accorder des jetons de conteneur aux joueurs

Étape 4 : Ouvrir le conteneur

Plusieurs types de conteneurs

Utiliser une boutique pour les achats de conteneurs

Limitations

Voir aussi

​Fonctionnement

​Prérequis

​Étape 1 : Créer une monnaie virtuelle pour le conteneur

​Game Manager

​API REST

​Étape 2 : Créer un bundle au prix d’un jeton de conteneur

​Game Manager

​API REST

​Étape 3 : Accorder des jetons de conteneur aux joueurs

​Étape 4 : Ouvrir le conteneur

​Plusieurs types de conteneurs

​Utiliser une boutique pour les achats de conteneurs

​Limitations

​Voir aussi

Fonctionnement

Prérequis

Étape 1 : Créer une monnaie virtuelle pour le conteneur

Game Manager

API REST

Étape 2 : Créer un bundle au prix d’un jeton de conteneur

Game Manager

API REST

Étape 3 : Accorder des jetons de conteneur aux joueurs

Étape 4 : Ouvrir le conteneur

Plusieurs types de conteneurs

Utiliser une boutique pour les achats de conteneurs

Limitations

Voir aussi