XBOX Godot Sample v0.3.0 Release

​

Key highlights

• Breaking type rename for broader engine compatibility. Script-visible types were renamed, such as GDKUser to XboxUser, so the addon can be dropped into Godot forks that provide an XBOX Series X|S console platform layer without colliding with the types those forks already register.
• Richer PlayFab Party voice and chat. Party chat indicators, voice controls, text-to-speech, and network diagnostics were added to the PlayFab track.
• More complete XUser coverage. The missing XUser API wrappers were implemented, which enables XR-112 conformance work.
• C# export fixes. An “XBOX on PC” export now ships the C# assemblies, and the executable and .pck are delegated to Godot’s own Windows export path.
• Community-reported fixes. Resolved issues around game-save quota queries, release builds linking the debug godot-cpp, and the GDK Tutorial 3 sample.

​

Breaking change: GDK addon type rename

​

What changed

• GDScript types are renamed, for example GDKUser to XboxUser, GDKResult to XboxResult, and GDKAchievement to XboxAchievement.
• The C# facade moved with them: namespace GodotGdk becomes GodotXbox, and the static entry-point class Gdk is renamed to match, as shown below.
• The bootstrap autoload is renamed from GDKBootstrap to XboxBootstrap.
• The MSIXVC packaging forwarder environment variables are renamed from GDKPKG_* to XBOXPKG_*.

# Before
var result: GDKResult = GDK.initialize()
var user: GDKUser = result.data

# After
var result: XboxResult = GDK.initialize()
var user: XboxUser = result.data

// Before
using GodotGdk;
GdkResult init = Gdk.Initialize();
GdkUser user = res.DataAs<GdkUser>();

// After
using GodotXbox;
XboxResult init = Xbox.Initialize();
XboxUser user = res.DataAs<XboxUser>();

​

Why it changed

​

What did not change

• The engine singleton is still registered as GDK. Calls such as GDK.initialize() and GDK.users.add_default_user_async() keep working unchanged.
• The addons/godot_gdk folder, the godot_gdk.gdextension entry point, and the gdk/runtime/* and gdk/packaging/* Project Settings.
• The PlayFab* and GameInput* types. The rename is scoped to the GDK addon.
• The gdk export feature tag, the “XBOX on PC” export platform, and the GodotGdkCSharp project and assembly name.

# Before
if GDK.get_class() == "GDK":

# After
if GDK.get_class() == "Xbox":

​

How to migrate

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

​

Notable changes

​

New features

• Party chat indicators, voice controls, text-to-speech, and network diagnostics in the godot_playfab addon.
• The missing XUser API wrappers, which enable XR-112 conformance work.
• A Project Setting that controls the engine singleton name.

​

Improvements

• Renamed the script-visible GDK addon types, for example GDKUser to XboxUser, with a migration guide and codemod. This is a breaking change.
• Improved README discoverability with a quick start, badges, and copy cleanup, plus blog and Discord links.
• Cleaned up documentation heading structure and fixed broken anchors.

​

Fixes

• An “XBOX on PC” export now ships the C# assemblies.
• The “XBOX on PC” export delegates the executable and .pck to Godot’s Windows export path.
• The game-save quota query now runs off the main thread.
• Release builds no longer silently link the debug godot-cpp.
• Dropped the Title Storage upload from the GDK Tutorial 3 sample.

​

Engineering and CI

• PR gates are skipped for documentation-only changes.

​

Related topics

• Getting started with Godot
• XBOX Godot Sample v0.2.0 Release
• XBOX Godot sample releases