v0.3.0 - Compatibility + Community Fixes

[Zach Hooper (XBOX) (zachhooper)]

What's Changed

• BREAKING CHANGE: refactor(gdk)!: rename GDK* classes to Xbox* to avoid collisions with console-capable Godot forks (v0.3.0) by James Lenell (@jameslen-atg) in refactor(gdk)!: rename GDK* classes to Xbox* to avoid collisions with console-capable Godot forks (v0.3.0) #156
• Fix [Bug]: Title Storage upload fails in Sample #136: drop Title Storage upload from GDK Tutorial 3 sample by James Lenell (@jameslen-atg) in Fix #136: drop Title Storage upload from GDK Tutorial 3 sample #140
• feat(addons): make the engine singleton name a Project Setting by James Lenell (@jameslen-atg) in feat(addons): make the engine singleton name a Project Setting #142
• Fix XBOX on PC export preset does not copy C# .dll to build directory #144: ship C# assemblies from an "XBOX on PC" export by James Lenell (@jameslen-atg) in Fix #144: ship C# assemblies from an "XBOX on PC" export #146
• Implement the missing XUser API wrappers (XR-112 enablement) by James Lenell (@jameslen-atg) in Implement the missing XUser API wrappers (XR-112 enablement) #147
• Fix broken doc anchors and clean up H1 titles by Zach Hooper (XBOX) (@zachhooper) in Fix broken doc anchors and clean up H1 titles #149
• Improve README discoverability: quick start, badges, and copy cleanup by Zach Hooper (XBOX) (@zachhooper) in Improve README discoverability: quick start, badges, and copy cleanup #148
• Skip PR gates for documentation-only changes by Zach Hooper (XBOX) (@zachhooper) in Skip PR gates for documentation-only changes #150
• Fix XBOX on PC export preset does not copy C# .dll to build directory #144: delegate the XBOX on PC .exe and .pck to Godot's Windows ex… by James Lenell (@jameslen-atg) in Fix #144: delegate the XBOX on PC .exe and .pck to Godot's Windows ex… #151
• fix(godot_gdk): run game-save quota query off the main thread ([Bug]: Gdk.GameSave calls do not work #145) by James Lenell (@jameslen-atg) in fix(godot_gdk): run game-save quota query off the main thread (#145) #152
• docs: add Visit our Blog and Join our Discord badges to README by Zach Hooper (XBOX) (@zachhooper) in docs: add Visit our Blog and Join our Discord badges to README #153
• feat(godot_playfab): Party chat indicators, voice controls, TTS, and network diagnostics by James Lenell (@jameslen-atg) in feat(godot_playfab): Party chat indicators, voice controls, TTS, and network diagnostics #154
• fix(build): stop release builds from silently linking the debug godot-cpp by James Lenell (@jameslen-atg) in fix(build): stop release builds from silently linking the debug godot-cpp #155

Warning

Breaking change: GDK* classes are now Xbox*. Every script-visible type was renamed from the GDK prefix to the Xbox prefix — GDKUser → XboxUser, GDKResult → XboxResult, GDKAchievement → XboxAchievement, and so on. The C# facade moved with them: namespace GodotGdk → GodotXbox, static class Gdk → Xbox. No deprecated GDK* aliases are provided, so type references must be updated.

Why: to let this addon enable console support inside compatible Godot forks. Those forks provide the console platform layer and expose their own types, and the GDK* prefix collided with names they already use. Moving to the Xbox* prefix keeps this addon's types distinct so it can be dropped into such a fork and light up console scenarios there. Godot itself is unchanged — the engine's own console support is not something this repo provides.

One binary covers both. The same addon build runs on PC and on console — there is no separate console compilation, preset, or #define. godot_gdk.gdextension declares only the windows.*.x86_64 libraries, and those are what a console-capable fork loads too.

The singleton is still called GDK. Calls like GDK.initialize() and GDK.users.add_default_user_async() keep working unchanged — only the type names moved. The addons/godot_gdk folder, the gdk/runtime/* Project Settings, and the godot_gdk.gdextension entry point are all unchanged as well.

# before
var r: GDKResult = GDK.initialize()
var u: GDKUser = r.data

# after
var r: XboxResult = GDK.initialize()
var u: XboxUser = r.data

One consequence worth calling out: the ClassDB class name (Xbox) and the singleton name (GDK) are now different strings. If your code class-checks the singleton, compare against "Xbox" — is_class("GDK") no longer matches.

See Migrating to v0.3.0 for the full old → new table, or run the codemod:

.\tools\migrate_gdk_to_xbox.ps1 -Path <your-project> -WhatIf

---

This discussion was created from the release v0.3.0 - Compatibility + Community Fixes.