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

# Editor do MicrosoftGame.config

> Editor do MicrosoftGame.config

O Editor do MicrosoftGame.config é uma ferramenta de interface do usuário que permite criar e editar seu arquivo MicrosoftGame.config. O editor é fornecido tanto como uma ferramenta autônoma quanto como um componente integrado ao IDE do Visual Studio.

Atualmente, o editor tem os recursos a seguir.

* **Guias de plataforma**: além da guia Geral, há guias específicas de plataforma que permitem editar recursos exclusivos dessa plataforma. Todos os recursos compartilhados entre todas as plataformas ficam na guia Geral.
* **Executável**: esta seção permite especificar o executável associado ao seu título.
* **Família de dispositivos de destino (plataforma)**: esta seção permite especificar o dispositivo de destino no qual seu título deve ser executado.
* **Informações da Store**: esta seção permite associar seu MicrosoftGame.config local aos dados existentes da Store na sua instância do Partner Center.
* **Imagem de bloco**: esta seção permite fornecer uma imagem de bloco de entrada de origem do seu produto, a partir da qual todas as outras imagens necessárias serão geradas automaticamente nas resoluções adequadas.

## Iniciar a versão autônoma do Editor do MicrosoftGame.config

Para iniciar o Editor do MicrosoftGame.config autônomo, você pode fazer o seguinte:

* Navegue até a pasta bin do GDK (ou seja, C:\Program Files (x86)\Microsoft GDK\bin) e clique duas vezes em GameConfigEditor.exe.

![Inicialização pelo executável](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_ExeLaunch.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=c46c91a3b3136dc474f35aa049ae5edb)

* Na pasta Microsoft GDK no menu Iniciar, selecione o ícone do Editor do MicrosoftGame.config.

![Inicialização pelo menu Iniciar](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_StartMenu.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=8d52866f48c11a90cd5a1e58e81c6a47)

* Na pasta Microsoft GDK no menu Iniciar, abra qualquer Gaming Command Prompt e insira GameConfigEditor.exe.

![Inicialização pela lista de ferramentas](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_MiniLauncher.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=765bdb85b1848f9d47b895bf8448382a)

* Em qualquer ferramenta de UX do GDK, expanda a lista suspensa Tools e selecione MicrosoftGame.config Editor. O Editor do MicrosoftGame.config também tem a lista suspensa Tools integrada para navegação rápida até outras ferramentas.

![Inicialização pela linha de comando](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Cmdline.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=f819fb999e9c4d87e77b495d86957799)

* Na pasta Microsoft GDK no menu Iniciar, abra qualquer Gaming Command Prompt e insira GameConfigEditor.exe com o caminho para um MicrosoftGame.config existente ou para a pasta na qual deseja gerar um, como parâmetro.

![Inicialização pela linha de comando 2](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Cmdline2.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=ebc45d194a46dea87793deca2e32fc68)

A janela Create or Edit MicrosoftGame.config, exibida ao iniciar o editor, solicitará um arquivo MicrosoftGame.config existente ou a criação de um novo arquivo MicrosoftGame.config, que será então aberto no editor.

![Janela inicial no Editor do MicrosoftGame.config](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Editor1.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=8365e8dd245c96a042445f294e173924)

## Iniciar o Editor do MicrosoftGame.config no Visual Studio

O editor do MicrosoftGame.config é registrado como o editor de arquivos .mgc no Visual Studio. Para iniciar o Editor do MicrosoftGame.config no Visual Studio, clique duas vezes em um arquivo de configuração de jogo no **Gerenciador de Soluções**.

> [!NOTE]
>
> Se o seu arquivo de configuração tiver uma extensão diferente de .mgc, como .config, ele precisará ser renomeado antes de poder ser aberto com o editor do MicrosoftGame.config.

## Criar um novo arquivo MicrosoftGame.config

Para criar um novo arquivo MicrosoftGame.config, navegue até a pasta raiz do seu título na janela inicial e selecione **Create** para gerar o novo arquivo nessa pasta e abri-lo no editor.

![Inserindo um novo arquivo de configuração](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_NewConfig1.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=734f074450610d3c77393c30ff6effbf)

## Editar um arquivo MicrosoftGame.config existente

Se já existir um arquivo MicrosoftGame.config, navegue até o arquivo na janela inicial e selecione **Edit** para abrir o arquivo existente no editor.

![Inserindo um arquivo de configuração existente](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_ExistingConfig1.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=e5d67c1ae356607da091c28812cb6930)

## Especificar o executável do título e a família de dispositivos de destino no arquivo MicrosoftGame.config

Na janela do Editor do MicrosoftGame.config, a primeira entrada necessária é especificar onde fica o executável do seu título. Isso pode ser definido navegando até o executável do título e selecionando-o na seção Executable do editor. Além de especificar o executável do título, é importante especificar em qual plataforma o executável deve ser executado. Para obter mais informações sobre as especificações da família de dispositivos de destino, consulte a seção [Visão geral do MicrosoftGame.config](https://docs.xbox.com/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Overview.md).

![Editor com o executável especificado](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Editor2.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=7b72173102ca425079f884032a3f173a)

Sem um executável especificado, o arquivo MicrosoftGame.config ainda pode ser gerado e editado, mas o editor avisará que o título não poderá ser implantado nem iniciado até que o executável seja definido.

![Executável ausente](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_MissingExe.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=7dfc2871f186620a410f71640a78be27)

![Executável ausente](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_MissingExe2.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=5c9605a8bfd6bc880ed0f1a2b7edcd38)

## Associar à Microsoft Store

Seu título precisa estar configurado com os XBOX services habilitados no [Partner Center](https://partner.microsoft.com/dashboard) para usar o Assistente de Associação da Store. Além disso, a conta associada do [Partner Center](https://partner.microsoft.com/dashboard) precisa ter uma das seguintes funções atribuídas:

* Gerente (Windows)
* Desenvolvedor
* Colaborador comercial
* Colaborador financeiro
* Profissional de marketing

Se a sua conta não tiver uma dessas funções atribuídas, permissões personalizadas poderão ser atribuídas. A permissão de nível de conta Sandboxes e uma das três permissões de nível de produto a seguir precisam ser atribuídas à sua conta para usar o Assistente de Associação da Store:

* Permissões de nível de produto: Disc
* Permissões de nível de produto: Publishing
* Permissões de nível de produto: XBOX Live

Depois de garantir que você tem as permissões corretas, selecione o botão **Associate with the Microsoft Store** para percorrer o Assistente de Associação da Store, obter as informações do título associado e salvá-las no seu arquivo MicrosoftGame.config local.

![Assistente de Associação da Store](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_SAW1.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=3cf179745334afc539849e87acace90e)

> [!NOTE]
>
> Depois de concluir o Assistente de Associação da Store, selecione **Save** no Editor do MicrosoftGame.config para gravar as alterações no MicrosoftGame.config do seu projeto.

## Gerar imagens de bloco

Para gerar as imagens do seu título a serem usadas pela Microsoft Store, selecione a imagem Tile e, em seguida, navegue até um arquivo .PNG de 480x480 e forneça-o para ser usado como entrada. Ao selecionar o arquivo, todas as outras imagens serão atualizadas automaticamente usando-o como entrada de origem e redimensionadas adequadamente para corresponder às resoluções exigidas.

![Imagens de bloco](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Images.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=a6aa49c9dc32dffe573b12a8713205b4)

## Adicionar recursos específicos de plataforma

Com o GDK de abril de 2021, a capacidade de adicionar e remover recursos específicos de plataforma agora está presente no Editor do MicrosoftGame.config, nas guias XBOX e PC.

O menu Features permite adicionar novos recursos, remover recursos existentes e selecionar e configurar os valores de recursos existentes.

![Adicionar recursos](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Elements.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=3fb07d3d2006482f114e56a643c23e46)

Para adicionar um recurso, selecione o botão **Add new**. Será apresentada uma lista de recursos disponíveis para essa plataforma. Marcar a caixa de seleção e selecionar Add adicionará as entradas dos recursos à lista de recursos para configuração adicional das propriedades.

![Lista de adição de recursos](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Elements_2.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=1e612a9fe8c4cb0a00c7db1bf210ab73)

Os recursos que já foram adicionados serão exibidos na parte inferior da lista **Add new** com texto amarelo indicando que o recurso já está presente e só pode ser especificado uma vez. Para recursos que podem ser adicionados várias vezes, selecionar o recurso novamente no menu **Add new** e selecionar Add adicionará outra entrada desse tipo de recurso à lista de recursos.

![Lista de adição de recursos](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Elements_3.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=0ca1a250f4101e0924abeb5ae0802f7c)

Para remover um recurso, navegue até o botão **Remove** na lista de recursos e, quando solicitado, selecione Yes para confirmar que deseja remover o recurso da lista de recursos.

![Lista de adição de recursos](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Elements_4.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=60ca0abbca1c4f65b2243664117461b4)

A maioria dos recursos precisa ter suas propriedades configuradas antes de serem salvos no arquivo MicrosoftGame.config. Em alguns casos, um recurso pode ser considerado inválido devido a informações ausentes e será removido ao salvar, com detalhes indicando qual valor ausente causou a remoção. Adicione novamente e reconfigure as propriedades do recurso adequadamente para garantir que ele seja mantido ao ser salvo no Editor do MicrosoftGame.config.

![Lista de adição de recursos](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Error.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=e08de44cbdd0642cd10a1e8263d77392)

## Enviar comentários

O Editor do MicrosoftGame.config está disponível para uso a partir do GDK de fevereiro de 2021. Use o item de menu de sugestões para enviar comentários sobre os recursos existentes ou solicitar funcionalidades adicionais.

![Enviar comentários](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Feedback.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=49bcd4775d734ca945c7a5e85a9b583b)

## Link da documentação

Para obter mais informações sobre o Editor do MicrosoftGame.config e os elementos associados, clique no link Documentation no Editor do MicrosoftGame.config.

![Documentação](https://mintcdn.com/microsoft-4404708b/sIrPFR_ir_sNKVEv/images/gdk/features/common/GameConfig_Documentation.png?fit=max\&auto=format\&n=sIrPFR_ir_sNKVEv\&q=85\&s=43f490d90de3279c1be8fb7801c858ce)

## Consulte também

[MicrosoftGame.config](https://docs.xbox.com/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-toc.md)
[Visão geral do MicrosoftGame.config](https://docs.xbox.com/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Overview.md)
[Referência do MicrosoftGame.config (exemplo de MicrosoftGame.config e esquema)](https://docs.xbox.com/pt-BR/reference/system/microsoftgameconfig/microsoftgameconfig-schema.md)
[Visão geral do empacotamento](https://docs.xbox.com/pt-BR/build/core-features/common/packaging/overviews/packaging.md)


## Related topics

- [Editor e referência do MicrosoftGame.config](https://docs.xbox.com/pt-BR/build/core-features/common/game-config/index.md)
- [MicrosoftGame.config (conteúdo)](https://docs.xbox.com/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-toc.md)
- [Visão geral do MicrosoftGame.config](https://docs.xbox.com/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Overview.md)
- [Localização do MicrosoftGame.config](https://docs.xbox.com/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-Localization.md)
- [Elemento do MicrosoftGame.config - StoreId](https://docs.xbox.com/pt-BR/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-storeid.md)