> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Jogo de criação, parte 2 - Game Manager

> Parte 2 do tutorial do jogo de criação do PlayFab Economy V2: use o Game Manager para criar seu estúdio e seu título e, em seguida, configure itens, lojas e pacotes.

# Parte 2 - Usando o Game Manager

Antes de começar a codificar, precisamos entender o [Game Manager](https://developer.playfab.com) e configurar algumas coisas.

## Pré-requisitos

1. [Parte 1 - Configuração do ambiente](/pt-BR/services/playfab/economy-monetization/economy-v2/tutorials/craftingGame/crafting-game-environment)
2. Uma [conta de desenvolvedor do PlayFab](https://developer.playfab.com). A inscrição é gratuita.

## Etapa 1 - Criar seu Estúdio

Após uma entrada (ou inscrição) bem-sucedida, você poderá criar seu novo Estúdio de Jogos! Para isso, assim que entrar no [Game Manager](https://developer.playfab.com), você verá um botão **New Studio**. Depois de clicar nele, será solicitado que você dê um nome ao seu Estúdio. Você pode nomeá-lo como quiser. Neste exemplo, nós o chamamos de "New Game Studio".

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/new-studio-button.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=fafdf7c8ab9c8bd148634bf69a510144" alt="Botão New Studio" width="2475" height="250" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/new-studio-button.png" />

Depois que seu **Estúdio** for criado, ele ficará visível na tela **My Studios and Titles** ou ao acessar o [Game Manager](https://developer.playfab.com) e entrar.

## Etapa 2 - Criar seu Título

Para criar um novo Título, siga estas etapas:

* Em **My Studios and Titles** no [Game Manager](https://developer.playfab.com), procure os três pontos à direita do **botão Upgrade account** (se você já tiver um plano comprado e vinculado à conta conectada, verá apenas os três pontos) e selecione-os.
* Depois de selecionados, será aberto um menu com diferentes opções; escolha **New title**.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/new-title-button.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=1f766454b108ec7c5611112a0e7feadf" alt="Botão New Title" width="215" height="268" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/new-title-button.png" />

* Insira as informações do seu título, como o nome, a URL do site e o logotipo do jogo, caso já tenha algum deles. Se não tiver, não se preocupe; você sempre poderá adicioná-los mais tarde.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/create-title-screen.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=44be5379fc2b87ea4ff4a67d0a52ce41" alt="Tela de criação de título" width="916" height="781" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/create-title-screen.png" />

* Selecione **Create title**
* Depois de criado, seu Título aparecerá sob o Estúdio criado anteriormente. Ele é exibido em um 'cartão' no qual você verá o logotipo, o nome, o plano e o ID do seu Título, além de um botão exibido como um ícone de engrenagem ⚙️ que leva você a outras configurações do Título.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/studio-with-title.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=037f3879654fc96a9c35b4fbb98b6752" alt="Estúdio de jogos com título" width="1168" height="232" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/studio-with-title.png" />

## Etapa 3 - Obter seu ID de Título e sua Chave Secreta

Agora que você criou seu Estúdio e seu Título, é hora de obter seu ID de Título e sua Chave Secreta de Desenvolvedor. Ambos serão usados quando você começar a codificar e servirão como pontos de vínculo no seu ambiente de desenvolvimento que apontam de volta para o Título específico no qual a autenticação e as transações são executadas.

A maneira mais fácil de obter o **ID de Título** é simplesmente olhar para o seu Título na tela do Estúdio, no cartão correspondente ao seu Título. No canto inferior direito desse cartão, você verá a marca "ID" seguida de um código alfanumérico de 5 dígitos; esse é o seu ID.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/title-id.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=be521565f7a37914e39d931b82204f3e" alt="ID do título" width="1168" height="232" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/title-id.png" />

Passando para a obtenção da sua **Chave Secreta de Desenvolvedor**:

* Entre no [Game Manager](https://developer.playfab.com).
* Selecione o cartão do seu título na tela do Estúdio. Isso abrirá a página de visão geral do título.
* No canto superior esquerdo, ao lado do nome do Título, selecione o ícone de engrenagem ⚙️.
* Escolha a opção **Title settings**.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/title-settings-button.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=d6dcb179b78e02a7e2eb94f91f5c23ab" alt="Configurações do título" width="475" height="357" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/title-settings-button.png" />

* Selecione a opção **Secret Keys** da barra de navegação, na parte superior da tela.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/secret-keys-navbar.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=eb8a03f836ac1fcea83aa5d01973af18" alt="Opção Secret Keys da barra de navegação" width="993" height="159" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/secret-keys-navbar.png" />

* Você verá que geramos automaticamente uma para você, chamada **Default Key**. Essa é a sua Chave Secreta de Desenvolvedor, que usaremos na próxima parte deste tutorial para definir as configurações do ambiente de codificação.

Parabéns por chegar até aqui! Agora você deve ter seu Estúdio e seu Título configurados corretamente, além do seu ID de Título e da sua Chave Secreta de Desenvolvedor em mãos (ou pelo menos saber onde obtê-los, se necessário).

## Etapa 4 - Criar seu primeiro item

Como o que estamos criando é um jogo de criação, precisaremos criar nossos itens no Game Manager para que fiquem disponíveis para os jogadores assim que eles começarem (e para você começar a codificar).

### Game Manager

* Entre no [Game Manager](https://developer.playfab.com).
* Vá para a página **My Studios and Titles** e selecione o título do seu jogo para exibir o painel.
* No menu de navegação à esquerda, selecione **Engage** > **Economy**.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/engage-economy-menu.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=a9ebb5df1fc763340702b914994eb5ad" alt="Opção Economy na seção Engage" width="235" height="226" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/engage-economy-menu.png" />

* Na página **Economy**, selecione a guia **Items** e, em seguida, selecione **New Item**. Você também pode encontrar outras guias, como **Currency**, **UGC**, **Bundles** e **Stores**.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/new-item-button.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=d3d8fb31667bdb48a26b1c67e53834e5" alt="Botão New item" width="2104" height="421" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/new-item-button.png" />

* Depois de selecioná-lo, você será redirecionado para um formulário no qual será solicitado que adicione os detalhes que deseja que seu novo item tenha. Nessa tela, você também poderá definir algumas propriedades do item, como Preços, Arquivos, Imagens e Plataformas em que o item estará disponível.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/create-item-screen.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=66d6ca488f5b81dfb6c6f9b083d8882b" alt="Tela de criação de item" width="1876" height="1168" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/create-item-screen.png" />

* Depois de adicionar todas as informações necessárias e quaisquer informações adicionais que quisesse adicionar ao item, na parte inferior da tela New Item, você terá duas opções distintas para continuar: **1. Save as draft**: cria um item de rascunho; ele não estará disponível no seu jogo (nem mesmo por meio de pesquisa, compra e assim por diante). **2. Save and publish**: salva e publica seu item no jogo imediatamente, o que significa que ele poderá ser pesquisado, estará ativo e poderá ser comprado.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/new-item-save-options.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=c228f6f45b2dc9aa0c4a0008e213341c" alt="Opções para salvar novo item" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/new-item-save-options.png" />

Assim que você salvar suas alterações, o item estará em estado de rascunho ou publicado, dependendo da sua escolha.

### API

Para criar um item usando a API do PlayFab, você deve usar a chamada **CreateDraftItem**, em **catalog/createDraftitem**. Ela funciona de forma semelhante aos outros exemplos de criação de itens, com a pequena diferença de que, por padrão, o item criado será um item de rascunho, a menos que especificado de outra forma.

Há um booliano **Publish** que, se verdadeiro, faz com que o item seja publicado diretamente sem ser salvo como rascunho.

O JSON a seguir é um exemplo de corpo de solicitação de **CreateDraftItem**. Nem todos os campos são obrigatórios, portanto fique à vontade para ajustar esse JSON às suas necessidades/preferências.

Para obter mais informações, consulte [CreateDraftItem](https://learn.microsoft.com/en-us/rest/api/playfab/economy/catalog/create-draft-item).

```json theme={null}
{
  "Item": {
    "Type": "ugc",
    "Title": {
      "NEUTRAL": "Neutral title",
      "en-US": "US English title"
    },
    "Description": {
      "NEUTRAL": "Neutral description",
      "en-US": "US English description"
    },
    "Keywords": {
      "NEUTRAL": {
        "Values": [
          "Keyword_1",
          "Keyword_2"
        ]
      }
    },
    "ContentType": "example item",
    "CreatorEntity": {
      "Id": "someId",
      "Type": "title_player_account",
      "TypeString": "title_player_account"
    },
    "IsHidden": false,
    "Tags": [
      "pirates",
      "holiday"
    ],
    "DisplayVersion": "1.0.0",
    "CreationDate": "2018-08-17T22:32:10.472Z",
    "Contents": [
      {
        "Id": "00000000-0000-0000-0000-000000000001",
        "Url": "https://endpoint.blob.core.windows.net/some-identifier-private/00000000-0000-0000-0000-000000000001/textures.zip",
        "MaxClientVersion": "2.4.1",
        "MinClientVersion": "2.0.0"
      }
    ],
    "Images": [
      {
        "Id": "00000000-0000-0000-0000-000000000003",
        "Type": "Thumbnail",
        "Url": "https://endpoint.blob.core.windows.net/some-identifier-private/00000000-0000-0000-0000-000000000003/splashscreen_thumb.jpg"
      }
    ],
    "DisplayProperties": {
      "mapDetails": {
        "mapType": "desertIsland",
        "gameMode": "capture",
        "maxPlayers": 16
      },
      "averageMatchLengthInSeconds": 947
    },
    "DefaultStackId": "Static_Default_Stack_Id"
  },
  "Publish": false
}
```

***

<Note>
  Para obter mais informações sobre Itens, Inventários e outras funções e termos do Economy, consulte nossa [Documentação do Economy V2](/pt-BR/services/playfab/economy-monetization/economy-v2/overview).
</Note>

## Etapa 5 - Usar o Catálogo para exibir e editar seus itens

Se você voltar para **Engage** > **Economy** na barra de navegação à esquerda (como fez na [Etapa 4](#step-4---create-your-first-item)), verá a mesma lista de opções/guias mencionada acima. A página usa por padrão a guia **Items**, na qual você terá outra opção para filtrar os itens por Publicados ou por Rascunho, e ela mostra todos os seus itens na categoria selecionada.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/published-items.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=0cf510c53a77e887bf7993e9a29c28aa" alt="Filtros da lista de itens" width="2074" height="796" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/published-items.png" />

Agora que você pode exibir/listar todos os seus itens Publicados ou de Rascunho em um único lugar, você pode editá-los individualmente ou excluí-los em massa. Para excluí-los, selecione os que deseja excluir e pressione o botão **Delete**.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/delete-item.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=2966a320ccbffe027c937a22ce196d43" alt="Excluir item" width="420" height="290" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/delete-item.png" />

Para editar um item, selecione o título do item; isso levará você a uma tela idêntica à tela New Item mencionada anteriormente, com todas as propriedades e campos personalizados que você possa ter adicionado ao item ao criá-lo (ou desde a última atualização), e permitirá que você os personalize e salve rolando até o final da página e selecionando o botão **Edit draft item** (logo ao lado do botão **Edit draft item**, também haverá um botão **Delete**, que é outra forma de excluir um item).

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/edit-draft-item-button.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=dfb1b685ae0a6ead3c6852173f5dd390" alt="Botão Edit draft item" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/edit-draft-item-button.png" />

## Etapa 6 - (Dica) Tornar um item gratuito para compra

<Tip>
  Esta etapa é opcional, pois abordará uma das formas que recomendamos para tornar um item gratuito para compra. O método usado será criar um novo "Item Gratuito" para ser usado como preço, com quantidade 0, no item que você deseja que seja gratuito.
</Tip>

<Note>
  Você pode pensar que a maneira de tornar um item gratuito é não definir um preço para ele. Atualmente, esse não é o caso: se você criar um item sem preço, nós o consideraremos **não comprável**.
</Note>

Para criar um "Item Gratuito" que possa ser usado como preço para o item que você deseja que seja gratuito, você deve seguir as mesmas etapas da [Etapa 4](#step-4---create-your-first-item); é como criar um item 'normal'. Você não precisa pensar muito nas propriedades ou valores que adiciona a esse item, pois ele não deve estar ativo no seu jogo; seu objetivo é apenas ser definido como preço. Também não é necessário definir um preço para ele.

Depois de criar dois itens (o "Item Gratuito" e o item que você deseja que seja gratuito), você deve editar o item que deseja tornar gratuito para definir um preço para ele. Para isso, na lista de itens, selecione o item desejado e selecione o nome dele, assim como mostramos na [Etapa 5](#step-5---use-catalog-to-view-and-edit-your-items), para chegar à tela de edição do item. Se você rolar até o final e habilitar o **Edit Mode**, a seção "Prices" terá um botão **Add new price** abaixo dela.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/add-new-price-button.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=742068c1ba7526ce97588b644a4142bf" alt="Botão Add new price" width="360" height="103" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/add-new-price-button.png" />

Depois de clicar em **Add new price**, uma janela é exibida com uma lista de todos os seus itens atuais para que você escolha um como preço (você também pode filtrar por "Items", "UGC Items" e "Currencies") e também pesquisar um texto específico. Em nosso caso, há apenas um outro item ali, o "Item Gratuito" (a menos que você já tenha criado vários itens).

Se você selecionar a opção "Add" logo ao lado do seu "Item Gratuito", será solicitado que selecione a quantidade de "Item Gratuito" que deseja como preço; para definir esse novo item como gratuito, você deve alterar esse valor (que tem como padrão 1) para zero.

Depois de concluir a configuração do preço, você deve salvar e publicar a alteração, e pronto! Esse item agora está disponível para ser comprado gratuitamente! Veremos mais adiante como comprar um item (mesmo um gratuito) por meio de C# e de chamadas diretas à API.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/pick-item-currency.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=4b14d8585efbca567c767f27aa7f6e7c" alt="Etapas para adicionar um item gratuito como preço" width="1542" height="750" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/pick-item-currency.png" />

## Etapa 7 - Adicionar um FriendlyId

<Tip>
  Esta é outra etapa opcional; ela abordará como editar um item existente para adicionar um **FriendlyId**. Dessa forma, você pode pesquisar o item usando esse **FriendlyId** em vez do longo ID alfanumérico do item atribuído por padrão.
</Tip>

Para adicionar um FriendlyId, você deve ir para **Economy** > **Items** e selecionar o item desejado. Depois de selecioná-lo, habilite o **Edit mode** para poder fazer alterações no item.

Na captura de tela a seguir, você pode ver o campo **FriendlyId** (destacado em vermelho). É aqui que você pode colocar um nome ou ID mais amigável para o seu item, e ele será vinculado instantaneamente a esse item específico.

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/crafting-game-images/edit-friendly-id.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=1c3b6871c59587e7e3961855a9734fd2" alt="Editar Friendly Id" width="2077" height="1020" data-path="images/playfab/economy-monetization/economy-v2/crafting-game-images/edit-friendly-id.png" />


## Related topics

- [Jogo de criação, parte 3 - Codificação](/pt-BR/services/playfab/economy-monetization/economy-v2/tutorials/craftingGame/crafting-game-coding.md)
- [Jogo de criação, parte 1 - Configuração](/pt-BR/services/playfab/economy-monetization/economy-v2/tutorials/craftingGame/crafting-game-environment.md)
- [Jogo de criação - Contexto](/pt-BR/services/playfab/economy-monetization/economy-v2/tutorials/craftingGame/game-context.md)
- [Criação de perfil de sustentabilidade com o PIX](/pt-BR/build/game-principles/sustainability/sustainability-pix-guide.md)
- [XBOX Game Package Manager](/pt-BR/build/core-features/common/packaging/xgpm.md)
