> ## 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.
# Versión v0.3.0 de XBOX Godot Sample
> Cambio importante de nombre de tipos, nuevas características, mejoras y correcciones en la versión v0.3.0 de XBOX Godot Sample para crear juegos de Godot que se publican en XBOX en PC.
***Fecha de lanzamiento: 19 de agosto de 2026***
El [ejemplo de Godot para XBOX](https://aka.ms/XBOXGodotSample) es una referencia pública, solo de código fuente, que muestra cómo crear una extensión de Godot que integra el Microsoft GDK, los servicios de XBOX y PlayFab, para que pueda compilar su título para XBOX en PC. Este artículo resume los cambios de la versión **v0.3.0 - Compatibility + Community Fixes**.
Para obtener una lista completa de confirmaciones, consulte el [registro de cambios completo de v0.3.0](https://github.com/microsoft/XBOX-Godot-Sample/compare/v0.2.0...v0.3.0) en GitHub. Para obtener la versión, consulte [v0.3.0 en GitHub](https://github.com/microsoft/XBOX-Godot-Sample/releases/tag/v0.3.0).
Esta versión contiene un cambio importante. Se cambió el nombre de todos los tipos visibles desde scripts en el complemento `godot_gdk`, por lo que `GDKUser` ahora es `XboxUser` y `GDKResult` ahora es `XboxResult`, y no se proporcionan alias en desuso. Si está actualizando un proyecto existente, consulte [Cambio importante: cambio de nombre de los tipos del complemento del GDK](#breaking-change-gdk-addon-type-rename).
## Aspectos destacados
* **Cambio importante de nombre de tipos para una compatibilidad más amplia con el motor.** Se cambió el nombre de los tipos visibles desde scripts, como `GDKUser` a `XboxUser`, para que el complemento pueda incorporarse a bifurcaciones de Godot que proporcionan una capa de plataforma para la consola XBOX Series X|S sin entrar en conflicto con los tipos que esas bifurcaciones ya registran.
* **Voz y chat de PlayFab Party más completos.** Se agregaron indicadores de chat de Party, controles de voz, texto a voz y diagnósticos de red a la ruta de PlayFab.
* **Cobertura de XUser más completa.** Se implementaron los contenedores de la API XUser que faltaban, lo que habilita el trabajo de conformidad con XR-112.
* **Correcciones de exportación de C#.** Una exportación "XBOX on PC" ahora incluye los ensamblados de C#, y el ejecutable y el `.pck` se delegan a la propia ruta de exportación de Windows de Godot.
* **Correcciones notificadas por la comunidad.** Se resolvieron problemas relacionados con las consultas de cuota de guardado de juegos, las compilaciones de versión que vinculaban el `godot-cpp` de depuración y el ejemplo GDK Tutorial 3.
## Cambio importante: cambio de nombre de los tipos del complemento del GDK
En v0.3.0, todos los tipos visibles desde scripts en el complemento `godot_gdk` recibieron un nombre nuevo: `GDKUser` ahora es `XboxUser`, `GDKResult` ahora es `XboxResult`, y así sucesivamente. **No se proporcionan alias `GDK*` en desuso**, por lo que cualquier proyecto que nombre estos tipos directamente debe actualizarse antes de que se cargue.
### Qué cambió
* Se cambió el nombre de los tipos de GDScript, por ejemplo, `GDKUser` a `XboxUser`, `GDKResult` a `XboxResult` y `GDKAchievement` a `XboxAchievement`.
* La fachada de C# se movió con ellos: el espacio de nombres `GodotGdk` pasa a ser `GodotXbox`, y la clase de punto de entrada estática `Gdk` se renombra en consecuencia, como se muestra a continuación.
* El autoload de arranque se renombró de `GDKBootstrap` a `XboxBootstrap`.
* Las variables de entorno del reenviador de empaquetado MSIXVC se renombraron de `GDKPKG_*` a `XBOXPKG_*`.
```gdscript theme={null}
# Before
var result: GDKResult = GDK.initialize()
var user: GDKUser = result.data
# After
var result: XboxResult = GDK.initialize()
var user: XboxUser = result.data
```
```csharp theme={null}
// Before
using GodotGdk;
GdkResult init = Gdk.Initialize();
GdkUser user = res.DataAs();
// After
using GodotXbox;
XboxResult init = Xbox.Initialize();
XboxUser user = res.DataAs();
```
### Por qué cambió
Godot registra las clases de extensión en un único espacio de nombres plano `ClassDB`, por lo que dos proveedores que exponen el mismo nombre de tipo no pueden coexistir en un proyecto. Las bifurcaciones de Godot que agregan compatibilidad con la consola XBOX Series X|S proporcionan su propia capa de plataforma, exportaciones y tipos, y el prefijo `GDK` entraba en conflicto con nombres que esas bifurcaciones ya usan. Cambiar el nombre de los tipos del complemento los mantiene diferenciados para que pueda incorporarse a dichas bifurcaciones.
La misma compilación del complemento se ejecuta en PC y en consola. No hay una compilación de consola independiente, ni un valor preestablecido, ni una definición condicional, y `godot_gdk.gdextension` sigue declarando solo las bibliotecas `windows.*.x86_64`.
### Qué no cambió
* El singleton del motor sigue registrado como `GDK`. Las llamadas como `GDK.initialize()` y `GDK.users.add_default_user_async()` siguen funcionando sin cambios.
* La carpeta `addons/godot_gdk`, el punto de entrada `godot_gdk.gdextension` y los valores de Project Settings `gdk/runtime/*` y `gdk/packaging/*`.
* Los tipos `PlayFab*` y `GameInput*`. El cambio de nombre se limita al complemento del GDK.
* La etiqueta de característica de exportación `gdk`, la plataforma de exportación "XBOX on PC" y el nombre del proyecto y ensamblado `GodotGdkCSharp`.
El nombre de clase de `ClassDB` y el nombre del singleton ahora son cadenas diferentes. El singleton sigue registrado como `GDK`, pero la clase que hay detrás no, por lo que una comprobación como `is_class("GDK")` ya no coincide. Compare con la clase renombrada en su lugar:
```gdscript theme={null}
# Before
if GDK.get_class() == "GDK":
# After
if GDK.get_class() == "Xbox":
```
### Cómo migrar
El ejemplo incluye un codemod junto con la guía de migración. Confirme primero su proyecto, porque el codemod reescribe los archivos en su lugar.
```powershell theme={null}
.\tools\migrate_gdk_to_xbox.ps1 -Path C:\path\to\your\godot\project -WhatIf
.\tools\migrate_gdk_to_xbox.ps1 -Path C:\path\to\your\godot\project
```
El codemod deliberadamente no reescribe un token `GDK` aislado, porque en la mayoría de los proyectos ese token es el singleton, que no debe cambiar. Informa de las apariciones ambiguas que encuentra para que pueda revisarlas manualmente.
Para ver las tablas completas de asignación de nombres antiguos a nuevos para GDScript y C#, consulte [Migración a v0.3.0](https://github.com/microsoft/XBOX-Godot-Sample/blob/main/docs/gdk/migration-v0.3.md) en el repositorio del ejemplo.
## Cambios destacados
### Nuevas características
* Indicadores de chat de Party, controles de voz, texto a voz y diagnósticos de red en el complemento `godot_playfab`.
* Los contenedores de la API XUser que faltaban, que habilitan el trabajo de conformidad con XR-112.
* Un valor de Project Setting que controla el nombre del singleton del motor.
### Mejoras
* Se cambió el nombre de los tipos del complemento del GDK visibles desde scripts, por ejemplo, `GDKUser` a `XboxUser`, con una guía de migración y un codemod. Este es un cambio importante.
* Se mejoró la capacidad de descubrimiento del README con un inicio rápido, insignias y limpieza del texto, además de vínculos al blog y a Discord.
* Se limpió la estructura de encabezados de la documentación y se corrigieron anclas rotas.
### Correcciones
* Una exportación "XBOX on PC" ahora incluye los ensamblados de C#.
* La exportación "XBOX on PC" delega el ejecutable y el `.pck` a la ruta de exportación de Windows de Godot.
* La consulta de cuota de guardado de juegos ahora se ejecuta fuera del hilo principal.
* Las compilaciones de versión ya no vinculan de forma silenciosa el `godot-cpp` de depuración.
* Se eliminó la carga de Title Storage del ejemplo GDK Tutorial 3.
### Ingeniería y CI
* Las puertas de PR se omiten para los cambios que solo afectan a la documentación.
## Temas relacionados
* [Introducción a Godot](/build/gdk-and-engines/godot)
* [Versión v0.2.0 de XBOX Godot Sample](/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-2-0)
* [Versiones del ejemplo de Godot para XBOX](https://github.com/microsoft/XBOX-Godot-Sample/releases)
## Related topics
- [Uso del GDK con Godot](/es/build/gdk-and-engines/godot.md)
- [Versión v0.1.0 de XBOX Godot Sample](/es/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-1-0.md)
- [Versión v0.2.0 de XBOX Godot Sample](/es/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-2-0.md)
- [Uso del GDK con Unity, Unreal y otros motores](/es/build/gdk-and-engines/gdk-and-engines.md)
- [Información general de Godot y motores de la comunidad](/es/paths/community-engines/overview.md)