> ## 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.

# Usar o GDK com o Godot

> Integre o XBOX GDK, os XBOX services, o PlayFab e o GameInput a um projeto do Godot usando o XBOX Godot Sample, somente de código-fonte, para lançar no XBOX no PC.

# 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](/pt-BR/build/gdk-and-engines/gdk-and-engines).

## Exemplo XBOX Godot

O [exemplo XBOX Godot](https://aka.ms/XBOXGodotSample) é 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](#release-notes).

> \[!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](/pt-BR/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-3-0#breaking-change-gdk-addon-type-rename).

### 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](#release-notes).

### 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](https://aka.ms/XBOXGodotSample) - Um exemplo de implementação que vincula o Microsoft GDK, o PlayFab e o GameInput ao Godot.
* **Microsoft GDK:** [microsoft/GDK](https://github.com/microsoft/GDK) - GDK público da Microsoft.
* **PlayFab SDK:** [PlayFab Unified SDK](https://aka.ms/PlayFabUnifiedSDK) - PlayFab Unified SDK.
* **GameInput:** [GameInput](https://aka.ms/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](https://aka.ms/XBOXGodotDocs) - Documentação do exemplo XBOX para Godot.
* **Problemas:** [XBOX Godot Issues](https://aka.ms/XBOXGodotIssues) - 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](/pt-BR/build/gdk-and-engines/overview) 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](https://github.com/microsoft/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](/pt-BR/build/gdk-and-engines/godot-release-notes/godot-netrumble-release-notes-0-1-0).

## 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.

* [Versão v0.1.0 do XBOX Godot NetRumble Sample](/pt-BR/build/gdk-and-engines/godot-release-notes/godot-netrumble-release-notes-0-1-0)
* [Versão v0.3.0 do XBOX Godot Sample](/pt-BR/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-3-0)
* [Versão v0.2.0 do XBOX Godot Sample](/pt-BR/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-2-0)
* [Versão v0.1.0 do XBOX Godot Sample](/pt-BR/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-1-0)

Para obter o histórico completo de versões e downloads, consulte [Versões do exemplo XBOX Godot](https://github.com/microsoft/XBOX-Godot-Sample/releases) 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](https://godotengine.org/consoles/) 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](/pt-BR/publishing/game-publishing/onboarding/onboarding-join-id-at-xbox) para começar.

## Tópicos relacionados

* [Microsoft Game Development Kit e mecanismos de jogo](/pt-BR/build/gdk-and-engines/gdk-and-engines)
* [Visão geral do guia de ponta a ponta para PC](/pt-BR/build/gdk-and-engines/overview)


## Related topics

- [Uso del GDK con Godot](/es/build/gdk-and-engines/godot.md)
- [Godot & Community Engines overview](/paths/community-engines/overview.md)
- [Visão geral de Godot e engines da comunidade](/pt-BR/paths/community-engines/overview.md)
- [Aperçu de Godot et des moteurs communautaires](/fr-CA/paths/community-engines/overview.md)
- [Información general de Godot y motores de la comunidad](/es/paths/community-engines/overview.md)