Skip to main content

​
Introdução ao Godot

Este artigo descreve como começar a usar o Godot para criar jogos XBOX para PC com o Microsoft Game Development Kit (GDK). Ele direciona você para o exemplo XBOX Godot, que mostra como integrar o GDK, os XBOX services e o PlayFab a um projeto do Godot, e para o XBOX Godot NetRumble, um jogo multijogador completo criado com base nele. Ele também explica onde encontrar orientações para lançar um jogo do Godot no XBOX Series X|S ou no XBOX One. O Godot é um dos vários mecanismos que você pode usar com o GDK. Para obter uma visão geral das opções de mecanismos e de como o GDK se encaixa em cada uma delas, consulte Microsoft Game Development Kit e mecanismos de jogo.

​
Exemplo XBOX Godot

O exemplo XBOX Godot é uma referência pública, somente de código-fonte, no GitHub. É um exemplo funcional de como criar uma extensão do Godot que integra o Microsoft GDK, os XBOX services e o PlayFab. Com ele, você pode criar seu título para XBOX no PC sem sair do mecanismo que você já adora. Este exemplo fornece uma referência modular que mostra como integrar o Microsoft GDK e o PlayFab SDK em conjunto ou separadamente.
[!TIP] As versões v0.2.0 e v0.3.0 adicionam indicadores de chat do PlayFab Party, controles de voz, conversão de texto em fala e diagnósticos de rede, completam os wrappers de API do XUser, adicionam suporte ao Godot .NET (C#), ampliam a compatibilidade com versões do GDK e do Godot e expandem a cobertura da referência de API do GDK para 100%, além de trazer correções relatadas pela comunidade. Para obter detalhes sobre essas versões, consulte Notas de versão.
[!NOTE] A v0.3.0 contém uma alteração significativa. Todos os tipos visíveis em script no complemento GDK foram renomeados; por exemplo, GDKUser agora é XboxUser, e o namespace C# GodotGdk agora é GodotXbox. Nenhum alias obsoleto é fornecido, portanto os projetos existentes precisam atualizar suas referências de tipo antes de serem carregados. O singleton do mecanismo ainda se chama GDK, então chamadas como GDK.initialize() não são afetadas. O exemplo inclui um codemod para automatizar a maior parte da alteração. Para obter detalhes, consulte Alteração significativa: renomeação de tipos do complemento GDK.

​
O que está incluído

O exemplo XBOX Godot abrange uma parte substancial do que um desenvolvedor de jogos do Godot precisa para criar para XBOX no PC, com os principais recursos demonstrados em:
  • Serviços de plataforma do Microsoft GDK
  • XBOX services
  • PlayFab Core + Services
  • PlayFab Multiplayer (Lobby, Matchmaking, Party)
  • PlayFab Game Saves
  • GameInput (incluindo a ponte para Input / InputMap do Godot)
A partir da v0.2.0, o exemplo também oferece suporte a projetos do Godot .NET (C#) por meio de uma trilha gerenciada em C#, além do GDScript. Dos XBOX services ao GameInput, este exemplo mostra como incorporar ao seu jogo no Godot recursos de entrada, suporte a controles de jogo e muito mais. Ele inclui insights e código de integração reutilizável, e oferece suporte a uma ampla variedade de edições do GDK e versões do Godot sem configurações adicionais. Para conhecer as edições e versões específicas validadas em cada versão, consulte Notas de versão.

​
O que isto é e o que não é

  • Este é um exemplo somente de código-fonte, não um produto. Ele é licenciado sob MIT na camada de wrapper; as dependências do GDK e do PlayFab ainda exigem suas próprias instalações e aceitação de licença, de forma consistente com nossos outros exemplos do XBOX.
  • Não há uma cadência definida de atualizações para suporte ou manutenção. Acompanharemos o repositório, monitoraremos os problemas e faremos iterações quando fizer sentido, mas esta não é uma versão comercial. Dito isso, estamos ansiosos para receber seus comentários e ver PRs da comunidade à medida que evoluímos isso juntos.
  • Este é o primeiro passo para levar o Godot ao XBOX no PC. Planejamos evoluí-lo ao longo do tempo com base no que a comunidade nos disser que é mais valioso.
  • Este exemplo foi criado especificamente para XBOX no PC. Ele não inclui suporte para XBOX Series X|S ou XBOX One. Para obter informações sobre o suporte a consoles, consulte a seção de suporte ao XBOX Series X|S e ao XBOX One abaixo.

​
Introdução

Use estes recursos para clonar o repositório, compilar a extensão e começar a integração com seu projeto do Godot:
  • XBOX Godot Sample: XBOX Godot Sample - Um exemplo de implementação que vincula o Microsoft GDK, o PlayFab e o GameInput ao Godot.
  • Microsoft GDK: microsoft/GDK - GDK público da Microsoft.
  • PlayFab SDK: PlayFab Unified SDK - PlayFab Unified SDK.
  • GameInput: GameInput - Uma API de entrada de última geração que expõe dispositivos de entrada de todos os tipos por meio de uma interface única e consistente.
  • Documentação: XBOX Godot Docs - Documentação do exemplo XBOX para Godot.
  • Problemas: XBOX Godot Issues - Relate bugs, solicite recursos ou contribua.
Depois de integrar o Microsoft GDK ao seu projeto do Godot, siga o restante do guia de ponta a ponta para PC para registrar seu título, configurar seu produto no Partner Center e publicar seu jogo na Microsoft Store.

​
XBOX Godot NetRumble

O XBOX Godot NetRumble é um jogo multijogador completo e jogável do Godot 4 criado com os complementos do exemplo XBOX Godot. Lançado em 10 de setembro de 2026, ele mostra o GDK, os XBOX services e o PlayFab funcionando juntos em um único título em execução, em vez de exemplos isolados por API. Entrada, descoberta de sessões por código de participação, rede do Party, voz e texto digitado, privilégios e privacidade, moderação, conquistas e Game Save estão conectados de ponta a ponta em um pequeno jogo de arena, para que você veja a ordem das chamadas, o tratamento de falhas e o trabalho de ciclo de vida que um título lançado precisa acertar. O PlayFab Party é encapsulado como um MultiplayerPeer do Godot pronto para uso, então cada @rpc no exemplo continua sendo um RPC comum do Godot e seu código de rede existente continua funcionando. Cada chamada de plataforma fica atrás de uma única fachada de serviços, com um arquivo por responsabilidade, para que você possa extrair a parte de que precisa. O exemplo também mapeia cada XBOX Requirement que abrange para o código que o implementa, o que dá a você uma vantagem inicial na certificação. O mesmo projeto tem como destino o XBOX no PC e o XBOX Series X|S. A exportação para console também requer o fork do Godot para consoles da W4 Games. Assim como o exemplo XBOX Godot, o NetRumble é uma referência somente de código-fonte, licenciada sob MIT, e não um título certificado. Para obter detalhes, consulte Versão v0.1.0 do XBOX Godot NetRumble Sample.

​
Notas de versão

O exemplo XBOX Godot evolui ao longo do tempo com base nos comentários da comunidade. As notas de cada versão descrevem os novos recursos, melhorias e correções de cada versão, junto com as edições do GDK e as versões do Godot validadas para ela. Para obter o histórico completo de versões e downloads, consulte Versões do exemplo XBOX Godot no GitHub.

​
Suporte ao XBOX Series X|S e ao XBOX One

O exemplo XBOX Godot foi criado especificamente para XBOX no PC e não inclui suporte para XBOX Series X|S ou XBOX One. Como o Godot é de código aberto e licenciado sob MIT, a Godot Foundation não mantém oficialmente modelos de exportação para consoles. Os SDKs de console são distribuídos sob NDA e exigem contratos legais e acesso fechado, que são incompatíveis com o modelo de desenvolvimento aberto do mecanismo. Para obter detalhes atuais sobre o processo de portabilidade para consoles, a lista de provedores de middleware e links para orientações adicionais da Godot Foundation, consulte Godot and console porting no site oficial do Godot Engine. Se você já estiver desenvolvendo para XBOX Series X|S ou XBOX One, entre em contato com seu representante XBOX. Se você ainda não estiver registrado, consulte Registrar-se no programa ID@XBOX para começar.

​
Tópicos relacionados

Last modified on October 6, 2026