Contenedores con contenido fijo en Economy v2

Economy v2 ya está disponible con carácter general. Para soporte y comentarios, vaya al foro de PlayFab.

Economy v1 (heredado) tenía una característica integrada de contenedores: artículos especiales del catálogo que, al abrirse, concedían su contenido al inventario del jugador. Economy v2 no incluye los contenedores como tipo de artículo nativo, pero puede lograr el mismo comportamiento para los contenedores de contenido fijo (contenedores que siempre conceden los mismos artículos) mediante una combinación de moneda virtual y agrupaciones.

Funcionamiento

El patrón usa tres bloques de creación de Economy v2:

Una moneda virtual (o un artículo apilable) que representa el propio contenedor; por ejemplo, “Treasure Chest Token”.
Una agrupación con un precio de 1 unidad de esa moneda, que contiene los artículos que el contenedor debe conceder.
Una llamada de compra en la que el jugador gasta 1 token para comprar la agrupación, que se desempaqueta automáticamente y concede los artículos.

Desde la perspectiva del jugador, recibe un token (mediante recompensas de juego, compras en la tienda, etc.) y después lo “abre” para obtener los artículos que hay dentro, exactamente como funcionaban los contenedores de la versión 1.

Requisitos previos

Una cuenta de desarrollador de PlayFab.
Un título creado en Game Manager.
Al menos un artículo de catálogo publicado que quiera que el contenedor conceda.

Paso 1: Crear una moneda virtual para el contenedor

Cree una moneda virtual que represente el contenedor. Cada unidad de esta moneda actúa como un contenedor sin abrir.

Game Manager

Vaya a Economy > Catalog (V2) > Currency.
Seleccione New currency.
Establezca el Title en un nombre descriptivo, como Treasure Chest.
Establezca el FriendlyId en un código corto, como tc.
Seleccione Save and publish.

API REST

Llame a 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
}

Paso 2: Crear una agrupación con un precio de un token de contenedor

Cree una agrupación que contenga los artículos que quiere que el contenedor conceda. Ponga a la agrupación un precio de exactamente una unidad de la moneda del contenedor.

Game Manager

Vaya a Economy > Catalog (V2) > Bundles.
Seleccione New bundle.
Establezca el Title de forma que describa el contenido del contenedor, como Treasure Chest Contents.
En Items, agregue los artículos y las cantidades que quiere que el contenedor conceda; por ejemplo, 1 Legendary Sword y 100 Gold.
En Price, establezca el precio en 1 unidad de la moneda del contenedor (Treasure Chest).
Seleccione Save and publish.

API REST

Llame a 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
}

Cuando un jugador compra esta agrupación, la agrupación se desempaqueta automáticamente: los artículos individuales van directamente al inventario del jugador.

Paso 3: Conceder tokens de contenedor a los jugadores

Conceda la moneda del contenedor a los jugadores mediante cualquier mecanismo que se ajuste al diseño de su juego:

Recompensas de juego: conceda tokens tras completar un nivel, una misión o un logro mediante AddInventoryItems.
Compras en la tienda: venda el token de contenedor en una tienda por otra moneda virtual o dinero real.
Pase de batalla o recompensas de temporada: incluya el token como un nivel de recompensa.

Ejemplo con AddInventoryItems para conceder tres tokens de Treasure Chest:

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

Paso 4: Abrir el contenedor

Cuando el jugador quiera abrir un contenedor, llame a PurchaseInventoryItems para comprar la agrupación con un token de contenedor:

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

Tras una llamada correcta, el inventario del jugador se actualiza: se descuenta un token de Treasure Chest y se agrega el contenido de la agrupación (una Legendary Sword + 100 Gold).

Varios tipos de contenedor

Cree varios tipos de contenedor repitiendo este patrón. Por ejemplo:

Contenedor	Moneda (FriendlyId)	Contenido de la agrupación
Treasure Chest	`tc`	Una Legendary Sword + 100 Gold
Supply Crate	`sc`	Cinco Health Potions + 3 Mana Potions
Premium Box	`pb`	Una Rare Mount + 500 Gold + 50 Gems

Cada tipo de contenedor tiene su propia moneda y su propia agrupación.

Uso de una tienda para las compras de contenedores

Use una tienda para invalidar el precio de la agrupación del contenedor. Con una tienda, puede ofrecer el mismo contenedor a precios distintos en contextos distintos (por ejemplo, un costo de “apertura” con descuento durante un evento):

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

Después, pase el StoreId al comprar:

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

Limitaciones

Este patrón funciona para contenedores con contenido fijo y determinista. Si necesita botín aleatorio (donde el contenido varía cada vez que se abre un contenedor, de forma similar a los contenedores de la versión 1 emparejados con tablas de botín), consulte el tutorial Tablas de botín y botín aleatorio. Ese tutorial usa Azure Functions para:

Restar el token de contenedor del inventario del jugador.
Ejecutar su lógica de selección aleatoria ponderada.
Conceder los artículos resultantes mediante las API de inventario.

XBOX Services

PlayFab

Funcionamiento

Requisitos previos

Paso 1: Crear una moneda virtual para el contenedor

Game Manager

API REST

Paso 2: Crear una agrupación con un precio de un token de contenedor

Game Manager

API REST

Paso 3: Conceder tokens de contenedor a los jugadores

Paso 4: Abrir el contenedor

Varios tipos de contenedor

Uso de una tienda para las compras de contenedores

Limitaciones

Consulte también

​Funcionamiento

​Requisitos previos

​Paso 1: Crear una moneda virtual para el contenedor

​Game Manager

​API REST

​Paso 2: Crear una agrupación con un precio de un token de contenedor

​Game Manager

​API REST

​Paso 3: Conceder tokens de contenedor a los jugadores

​Paso 4: Abrir el contenedor

​Varios tipos de contenedor

​Uso de una tienda para las compras de contenedores

​Limitaciones

​Consulte también

Funcionamiento

Requisitos previos

Paso 1: Crear una moneda virtual para el contenedor

Game Manager

API REST

Paso 2: Crear una agrupación con un precio de un token de contenedor

Game Manager

API REST

Paso 3: Conceder tokens de contenedor a los jugadores

Paso 4: Abrir el contenedor

Varios tipos de contenedor

Uso de una tienda para las compras de contenedores

Limitaciones

Consulte también