Skip to main content
Este artículo describe cómo empezar a usar Godot para crear juegos de XBOX para PC con el Microsoft Game Development Kit (GDK). Le remite al ejemplo de Godot para XBOX, que muestra cómo integrar el GDK, los servicios de XBOX y PlayFab en un proyecto de Godot, y explica dónde encontrar orientación para publicar un juego de Godot en XBOX Series X|S o XBOX One. Godot es uno de los varios motores que puede usar con el GDK. Para obtener información general sobre las opciones de motores y cómo encaja el GDK en cada una, consulte Microsoft Game Development Kit y motores de juegos.

Ejemplo de Godot para XBOX

El ejemplo de Godot para XBOX es una referencia pública, solo de código fuente, en GitHub. Es un ejemplo funcional de cómo puede crear una extensión de Godot que integra el Microsoft GDK, los servicios de XBOX y PlayFab. Puede compilar su título para XBOX en PC sin salir del motor que ya le encanta. Este ejemplo proporciona una referencia modular que incluye cómo integrar el Microsoft GDK y el SDK de PlayFab juntos o por separado.
Las versiones v0.2.0 y v0.3.0 agregan indicadores de chat de PlayFab Party, controles de voz, texto a voz y diagnósticos de red, completan los contenedores de la API XUser, agregan compatibilidad con Godot .NET (C#), amplían la compatibilidad con versiones del GDK y de Godot, y amplían la cobertura de la referencia de la API del GDK al 100%, junto con correcciones notificadas por la comunidad. Para obtener detalles sobre estas versiones, consulte las notas de la versión.
v0.3.0 contiene un cambio importante. Se cambió el nombre de todos los tipos visibles desde scripts en el complemento del GDK; por ejemplo, GDKUser ahora es XboxUser, y el espacio de nombres de C# GodotGdk ahora es GodotXbox. No se proporcionan alias en desuso, por lo que los proyectos existentes deben actualizar sus referencias de tipos antes de que se carguen. El singleton del motor sigue llamándose GDK, por lo que las llamadas como GDK.initialize() no se ven afectadas. El ejemplo incluye un codemod para automatizar la mayor parte del cambio. Para obtener más información, consulte Cambio importante: cambio de nombre de los tipos del complemento del GDK.

Qué incluye

El ejemplo de Godot para XBOX cubre una parte sustancial de lo que un desarrollador de juegos de Godot necesita para compilar para XBOX en PC, con características clave demostradas en:
  • Servicios de plataforma del Microsoft GDK
  • Servicios de XBOX
  • PlayFab Core + Services
  • PlayFab Multiplayer (Lobby, Matchmaking, Party)
  • PlayFab Game Saves
  • GameInput (incluido el puente con Input / InputMap de Godot)
A partir de v0.2.0, el ejemplo también admite proyectos de Godot .NET (C#) a través de una ruta de C# administrado, además de GDScript. Desde los servicios de XBOX hasta GameInput, este ejemplo le muestra cómo incorporar el inicio de sesión, las funcionalidades de compatibilidad con mandos y mucho más a su juego con Godot. Incluye información útil y código de integración reutilizable, y admite desde el primer momento una amplia gama de ediciones del GDK y versiones de Godot. Para conocer las ediciones y versiones específicas validadas en cada versión, consulte las notas de la versión.

Qué es y qué no es

  • Este es un ejemplo solo de código fuente, no un producto. Tiene licencia MIT en la capa de contenedor; las dependencias del GDK y PlayFab siguen requiriendo sus propias instalaciones y aceptación de licencia, en consonancia con nuestros otros ejemplos de XBOX.
  • No hay una cadencia de actualización establecida para el soporte o el mantenimiento. Observaremos el repositorio, supervisaremos las incidencias e iteraremos donde tenga sentido, pero esto no es una versión comercial. Dicho esto, estamos encantados de escuchar sus comentarios y ver cualquier PR de la comunidad, a medida que evolucionamos esto juntos.
  • Este es el primer paso para llevar Godot a XBOX en PC. Planeamos hacerlo evolucionar con el tiempo en función de lo que la comunidad nos diga que es más valioso.
  • Este ejemplo está creado específicamente para XBOX en PC. No incluye compatibilidad con XBOX Series X|S ni XBOX One. Para obtener información sobre la compatibilidad con consolas, consulte la sección de compatibilidad con XBOX Series X|S y XBOX One más abajo.

Introducción

Use estos recursos para clonar el repositorio, compilar la extensión y empezar a integrar con su proyecto de Godot:
  • XBOX Godot Sample: XBOX Godot Sample: una implementación de ejemplo que enlaza el Microsoft GDK, PlayFab y GameInput con Godot.
  • Microsoft GDK: microsoft/GDK: GDK público de Microsoft.
  • PlayFab SDK: PlayFab Unified SDK: SDK unificado de PlayFab.
  • GameInput: GameInput: una API de entrada de nueva generación que expone dispositivos de entrada de todo tipo a través de una única interfaz coherente.
  • Documentación: XBOX Godot Docs: documentación del ejemplo de Godot para XBOX.
  • Incidencias: XBOX Godot Issues: informe errores, solicite características o contribuya.
Después de haber integrado el Microsoft GDK con su proyecto de Godot, siga el resto de la guía de PC de un extremo a otro para registrar su título, configurar su producto en Partner Center y publicar su juego en Microsoft Store.

Notas de la versión

El ejemplo de Godot para XBOX evoluciona con el tiempo en función de los comentarios de la comunidad. Las notas de cada versión describen las nuevas características, mejoras y correcciones de cada versión, junto con las ediciones del GDK y las versiones de Godot validadas para esa versión. Para ver el historial completo de versiones y descargas, consulte las versiones del ejemplo de Godot para XBOX en GitHub.

Compatibilidad con XBOX Series X|S y XBOX One

El ejemplo de Godot para XBOX está creado específicamente para XBOX en PC y no incluye compatibilidad con XBOX Series X|S ni XBOX One. Dado que Godot es de código abierto y tiene licencia MIT, la Godot Foundation no mantiene oficialmente plantillas de exportación para consolas. Los SDK de consola se distribuyen bajo acuerdos de confidencialidad y requieren contratos legales y acceso cerrado que son incompatibles con el modelo de desarrollo abierto del motor. Para obtener detalles actualizados sobre el proceso de portabilidad a consolas, la lista de proveedores de middleware y vínculos a orientación adicional de la Godot Foundation, consulte Godot and console porting en el sitio web oficial de Godot Engine. Si ya está desarrollando para XBOX Series X|S o XBOX One, póngase en contacto con su representante de XBOX. Si aún no está registrado, consulte Registro en el programa ID@XBOX para empezar.

Temas relacionados

Última modificación el 28 de agosto de 2026