Usar o GDK com o GameMaker

Este artigo descreve como preparar seu jogo do GameMaker para ser publicado na Microsoft Store.

Instalar o software necessário
Baixar e instalar o GameMaker Studio 2
GameMaker Studio 2 - Extensão do Microsoft Game Development Kit (GDK)
Compilar a extensão do GDK
Criar um produto no Microsoft Partner Center
Testar a extensão do GDK
Atualizar o MicrosoftGame.config
Integrar a extensão do GDK ao seu próprio projeto
Testar os XBOX services no seu jogo
Publicar

Instalar o software necessário

Para usar o GameMaker Studio 2 com o Microsoft Game Development Kit (GDK), baixe o seguinte software:

Visual Studio 2022
GDK de junho de 2024 ou posterior
CMake
- Verifique se o instalador do CMake atualiza os caminhos do sistema. Caso contrário, o projeto da extensão não conseguirá encontrar o CMake.

Atualizar o Gaming Runtime Services (GRTS) e o PC Bootstrapper

O PC Bootstrapper faz parte da experiência de inicialização de jogos no PC e foi introduzido na versão de maio de 2022 do GRTS. O PC Bootstrapper depende do GRTS para funcionar corretamente. Se o GRTS estiver desatualizado no seu PC de desenvolvimento, as tentativas de entrada poderão falhar e retornar um erro E_FAIL. Para obter orientações detalhadas sobre o PC Bootstrapper, incluindo sua função no processo de inicialização do jogo e como ele interage com o GRTS, consulte a Visão geral do PC Bootstrapper.

Baixar e instalar o GameMaker Studio 2

Se você não tiver o GameMaker Studio 2 instalado, baixe-o em https://www.yoyogames.com e instale-o.

Configurar a extensão do GDK para o GameMaker Studio 2

A extensão do GDK para o GameMaker Studio 2 é necessária para usar o GDK com o GameMaker Studio 2. Para obter o código-fonte da extensão e as instruções de configuração, consulte https://github.com/YoYoGames/GMEXT-GDK. Siga as etapas do arquivo README na raiz do repositório. Essas etapas permitem configurar e compilar a extensão do GDK para o GameMaker Studio 2, habilitando a integração dos XBOX services e recursos aos projetos do GameMaker. Ao clonar o repositório GDKExtension, use a opção --recurse-submodules para incluir os submódulos. Caso contrário, arquivos necessários estarão ausentes quando você compilar a solução. Para obter informações sobre a extensão, consulte https://github.com/YoYoGames/GMEXT-GDK/wiki.

Compilar a extensão do GDK

Compile a extensão no Visual Studio 2022 seguindo as instruções do arquivo README na raiz do repositório. O arquivo GDKExtension.sln é necessário (<project_root>/source/GDKExtension_gml/extensions/GDKExtension/gdkextension_windows/GDKExtension.sln). Para obter instruções detalhadas de compilação, consulte as etapas de compilação no arquivo README na raiz do repositório.

Criar um produto no Microsoft Partner Center

Para criar seu produto habilitado para XBOX services no Partner Center, consulte Configurar um aplicativo ou jogo no Partner Center, para Parceiros Gerenciados. Depois de criar seu produto, você pode testar os XBOX services ou publicar um jogo na Microsoft Store.

Testar a extensão do GDK

O repositório da extensão do GDK inclui um projeto de exemplo que demonstra como integrar o plug-in do GDK a um projeto do GameMaker Studio 2. O arquivo do projeto de exemplo está localizado em source/GDKExtension_gml/GDKExtension.yyp. Ao compilar o projeto de exemplo no GameMaker (Build>Create Executable), selecione Package as Zip para gerar o pacote MSIXVC necessário para instalar o aplicativo. Se você selecionar Package as Installer, o build não produzirá um pacote MSIXVC. O aplicativo não poderá acessar os XBOX services. Quando o build terminar, ele abrirá uma janela do Explorador de Arquivos que mostra o arquivo .zip criado e seu subdiretório. O subdiretório tem o mesmo nome do pacote e contém o arquivo MSIXVC. Além disso, a janela de saída do GameMaker Studio 2 exibe uma linha de código com o caminho de saída completo do pacote MSIXVC, conforme mostrado no exemplo a seguir. C:\Users\your-user-name\XboxDeveloperExperienceTe.GamePassSampleGame_1.0.0.0_x64__pmsd8ndztetqc-pkg Para executar o projeto de exemplo com acesso aos XBOX services, instale o pacote usando wdapp install com o nome do seu pacote, conforme mostrado no exemplo a seguir. wdapp install XboxDeveloperExperienceTe.GamePassSampleGame_1.0.0.0_x64__pmsd8ndztetqc.msixvc Depois que o pacote for instalado, inicie-o usando o botão Iniciar.

Atualizar o MicrosoftGame.config

O projeto de exemplo usa um arquivo MicrosoftGame.config padrão. Para testar o exemplo ou seu próprio projeto do GameMaker Studio 2 com as informações de configuração do seu projeto no Partner Center, atualize o arquivo MicrosoftGame.config. O arquivo .config do exemplo está em source/GDKExtension_gml/datafiles/MicrosoftGame.config. Para usar a funcionalidade dos XBOX services, atualize o MicrosoftGame.config do seu projeto com os detalhes de identidade do seu projeto no Partner Center seguindo estas etapas.

Acesse o painel do Partner Center.
Selecione seu jogo na lista de produtos.
Selecione a guia Game setup e, em seguida, selecione Identity details.
Selecione Show Details para expandir a seção Identity details.
Use os seguintes valores da tabela na seção Identity details. Copie esses valores do Partner Center para o elemento e o campo correspondentes no MicrosoftGame.config.

Nome no Partner Center	MicrosoftGame.config
XBOX Title ID	TitleId
Package/Identity/Name	Identity->Name
Package/Identity/Publisher	Identity->Publisher
XBOX services > XBOX Settings > MSAAppId	MSAAppId

Os detalhes de identidade do Partner Center determinam o conteúdo do seu arquivo MicrosoftGame.config, conforme mostrado no exemplo a seguir.

Nome no Partner Center	Valor de exemplo
XBOX Title ID	64353034
Package/Identity/Name	41336MicrosoftATG.Achievements2017Redux
Package/Identity/Publisher	CN=A4954634-DF4B-47C7-AB70-D3215D246AF1
XBOX services > XBOX Settings > MSAAppId	0000000000000000

Trecho de exemplo do arquivo MicrosoftGame.config

<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">

  <Identity Name='41336MicrosoftATG.Achievements2017Redux' Version="1.1.0.0" Publisher='CN=A4954634-DF4B-47C7-AB70-D3215D246AF1' />


  <TitleId>64353034</TitleId>
  <MSAAppId>0000000000000000</MSAAppId>

  <ExecutableList>
    <Executable Name="Achievements2017_desktop.exe"
                TargetDeviceFamily="PC"
                Id="Game"/>
  </ExecutableList>

  <ShellVisuals DefaultDisplayName="Achievements2017 Desktop Sample"
                PublisherDisplayName="Xbox Advanced Technology Group"
                StoreLogo="Assets\StoreLogo.png"
                Square150x150Logo="Assets\Logo.png"
                Square44x44Logo="Assets\SmallLogo.png"
                Square480x480Logo="Assets\LargeLogo.png"
                Description="Achievements2017"
                ForegroundText="dark"
                BackgroundColor="#000000"
                SplashScreenImage="Assets\SplashScreen.png"/>
</Game>

Para obter uma visão geral do MicrosoftGame.config e informações sobre seus valores, consulte a Visão geral do MicrosoftGame.config.

Integrar a extensão do GDK ao seu projeto

No mínimo, seu projeto precisa chamar as seguintes funções para se integrar ao GDK.

Chame gdk_init para inicializar o GDK. Você deve chamar gdk_init antes de usar qualquer outra funcionalidade do GDK.
Chame gdk_update uma vez por quadro enquanto o GDK estiver ativo.
Chame gdk_quit para limpar o GDK quando seu projeto terminar e você não precisar mais de nenhuma funcionalidade do GDK.

Além disso, a extensão do GDK tem os seguintes módulos que fornecem acesso à funcionalidade do GDK.

Módulo Base: fornece um conjunto de funções que controlam a seleção de usuário/conta para o jogador
Módulo Storage: fornece um conjunto de funções que controlam o carregamento e o salvamento de dados associados a um usuário.
Módulo XBOX services: fornece funções para usar recursos dos XBOX services, incluindo estatísticas, placares de líderes, conquistas e Rich Presence.
Módulo In-App Purchases: fornece funções que integram projetos do GameMaker aos sistemas de comércio da Microsoft Store por meio do GDK.

O guia incluído no repositório GDKExtension fornece documentação para as funções do GDK na seção GDK Extension APIs. O guia, em formato .pdf, está em source/GDKExtension_gml/datafiles/GDK_Extension_Documentation.pdf.

Testar os XBOX services no seu jogo

Para testar a funcionalidade dos XBOX services (por exemplo, conquistas) no seu jogo, use uma área restrita e contas de teste que tenham acesso a essa área restrita.

Criar uma conta de teste

Para testar qualquer recurso dos XBOX services no seu jogo, crie contas de teste que tenham acesso à sua área restrita de desenvolvimento. Para obter instruções, consulte Criar contas de teste.

Alternar sua área restrita

Acesse o Partner Center.
Para encontrar o ID da sua área restrita, selecione XBOX services e, em seguida, selecione Gameplay settings.
O ID da sua área restrita aparece na primeira guia da página Gameplay settings. Ele usa um nome como “ABCDEF.0”.
Selecione o botão Iniciar.
Digite Microsoft GDK Command Prompts e pressione Enter.
Abra o primeiro prompt de comando e digite XblPCSandbox.exe <ID da sua área restrita>.
Depois que o prompt de comando iniciar vários aplicativos, entre no aplicativo XBOX usando sua conta de teste.

Se você conseguir entrar com êxito, poderá começar a testar na sua área restrita. Para obter mais informações sobre áreas restritas, consulte Visão geral das áreas restritas dos XBOX services.

Publicar seu jogo

Para se preparar para publicar seu jogo, verifique se você:

Criou um pacote MSIXVC usando Package as Zip no GameMaker Studio 2.
Atualizou seu arquivo MicrosoftGame.config com os valores corretos do projeto que você criou no Partner Center.
Integrou a extensão do GDK ao seu jogo.

Depois de concluir as etapas deste artigo, você estará pronto para publicar seu jogo. Para enviá-lo, acesse o Partner Center e siga as instruções na interface do usuário.

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

Instalar o software necessário

Atualizar o Gaming Runtime Services (GRTS) e o PC Bootstrapper

Baixar e instalar o GameMaker Studio 2

Configurar a extensão do GDK para o GameMaker Studio 2

Compilar a extensão do GDK

Criar um produto no Microsoft Partner Center

Testar a extensão do GDK

Atualizar o MicrosoftGame.config

Trecho de exemplo do arquivo MicrosoftGame.config

Integrar a extensão do GDK ao seu projeto

Testar os XBOX services no seu jogo

Criar uma conta de teste

Alternar sua área restrita

Publicar seu jogo

​Instalar o software necessário

​Atualizar o Gaming Runtime Services (GRTS) e o PC Bootstrapper

​Baixar e instalar o GameMaker Studio 2

​Configurar a extensão do GDK para o GameMaker Studio 2

​Compilar a extensão do GDK

​Criar um produto no Microsoft Partner Center

​Testar a extensão do GDK

​Atualizar o MicrosoftGame.config

​Trecho de exemplo do arquivo MicrosoftGame.config

​Integrar a extensão do GDK ao seu projeto

​Testar os XBOX services no seu jogo

​Criar uma conta de teste

​Alternar sua área restrita

​Publicar seu jogo

Instalar o software necessário

Atualizar o Gaming Runtime Services (GRTS) e o PC Bootstrapper

Baixar e instalar o GameMaker Studio 2

Configurar a extensão do GDK para o GameMaker Studio 2

Compilar a extensão do GDK

Criar um produto no Microsoft Partner Center

Testar a extensão do GDK

Atualizar o MicrosoftGame.config

Trecho de exemplo do arquivo MicrosoftGame.config

Integrar a extensão do GDK ao seu projeto

Testar os XBOX services no seu jogo

Criar uma conta de teste

Alternar sua área restrita

Publicar seu jogo