Releases: microsoft/GDK
October 2023 GDK Update 3 Public Release
October 2023 Microsoft Game Development Kit (GDK) release notes
Introduction
Welcome to the October 2023 Microsoft Game Development Kit release. You can use the GDK to develop games that can be certified and approved for release on Windows 11 PCs and Windows 10 PCs.
About this document
We have organized this document into the following sections.
- What's new
- Release notes:
- Documentation
What's new in the October 2023 Microsoft Game Development Kit
- The GDK is released in two types: Major (focused on features, three times a year) and Updates (focused on fixes, as often as needed).
- To view the full What's New section, see the online version of What's New.
October 2023 GDK Update 2
Issue fixes
PlayFab
Fixed an issue that could result in a "dll not found" error message when attempting to reference
PlayFab.CoreorPlayFab.Serviceslibraries.
Packaging
Fixed an issue where the MicrosoftGame.Config editor would delete certain fields if the user added them to the file using a text editor.
October 2023 GDK Update 1
Issue fixes
System
Fixed an issue where protocol activation wasn't properly handling relative paths to the target executable.
Streaming
Fixed several issues where the title could crash or the streaming client properties would report no data if a streaming client connected while the
XGameStreamingInitializeAPI was executing.
Xbox services
Fixed a race condition in
WinHttpWebsocketteardown on suspend that could cause the title to crash or stop responding.
Fixed an issue where using XSAPI or PlayFab with trace logging enabled at information or verbose levels could cause the title to crash.
Fixed an issue that could cause the title to crash when calling
PeoplehubService::DeserializeTitleHistoryfor certain locales.
October 2023 GDK
Notifications
Visual Studio support
The GDK currently supports building game projects with the Visual Studio 2017 compiler and linker toolset (version v141) either from the command line or from the Visual Studio 2019 or Visual Studio 2022 IDEs.
Support for building game projects with the v141 toolset will be removed in the October 2024 version of the GDK.
Issue fixes
Commerce
Fixed an issue with
XStoreQueryAssociatedProductsAsyncwhere themaxItemsToRetrievePerPageparameter wasn't returning the correct number of results when 26 or more products were requested.
Known issues
Middleware
Systems using the GDK Unity Package that have only the public GDK installed will have missing DLL issues in Unity projects until the next plugin release.
For more information and a quick fix, see Plugin fails to load DLLs/Tools for public GDK installs Issue #93 microsoft/gdk-unity-package.
October 2023 GDK Update 2 Public Release
October 2023 Microsoft Game Development Kit (GDK) release notes
Introduction
Welcome to the October 2023 Microsoft Game Development Kit release. You can use the GDK to develop games that can be certified and approved for release on Windows 11 PCs and Windows 10 PCs.
About this document
We have organized this document into the following sections.
- What's new
- Release notes:
- Documentation
What's new in the October 2023 Microsoft Game Development Kit
- The GDK is released in two types: Major (focused on features, three times a year) and Updates (focused on fixes, as often as needed).
- To view the full What's New section, see the online version of What's New.
October 2023 GDK Update 2
Issue fixes
PlayFab
Fixed an issue that could result in a "dll not found" error message when attempting to reference
PlayFab.CoreorPlayFab.Serviceslibraries.
Packaging
Fixed an issue where the MicrosoftGame.Config editor would delete certain fields if the user added them to the file using a text editor.
October 2023 GDK Update 1
Issue fixes
System
Fixed an issue where protocol activation wasn't properly handling relative paths to the target executable.
Streaming
Fixed several issues where the title could crash or the streaming client properties would report no data if a streaming client connected while the
XGameStreamingInitializeAPI was executing.
Xbox services
Fixed a race condition in
WinHttpWebsocketteardown on suspend that could cause the title to crash or stop responding.
Fixed an issue where using XSAPI or PlayFab with trace logging enabled at information or verbose levels could cause the title to crash.
Fixed an issue that could cause the title to crash when calling
PeoplehubService::DeserializeTitleHistoryfor certain locales.
October 2023 GDK
Notifications
Visual Studio support
The GDK currently supports building game projects with the Visual Studio 2017 compiler and linker toolset (version v141) either from the command line or from the Visual Studio 2019 or Visual Studio 2022 IDEs.
Support for building game projects with the v141 toolset will be removed in the October 2024 version of the GDK.
Issue fixes
Commerce
Fixed an issue with
XStoreQueryAssociatedProductsAsyncwhere themaxItemsToRetrievePerPageparameter wasn't returning the correct number of results when 26 or more products were requested.
Known issues
Middleware
Systems using the GDK Unity Package that have only the public GDK installed will have missing DLL issues in Unity projects until the next plugin release.
For more information and a quick fix, see Plugin fails to load DLLs/Tools for public GDK installs Issue #93 microsoft/gdk-unity-package.
October 2023 GDK Update 1 Public Release
October 2023 Microsoft Game Development Kit (GDK) release notes
Introduction
Welcome to the October 2023 Microsoft Game Development Kit release. You can use the GDK to develop games that can be certified and approved for release on Windows 11 PCs and Windows 10 PCs.
About this document
We have organized this document into the following sections.
- What's new
- Release notes:
- Documentation
What's new in the October 2023 Microsoft Game Development Kit
- The GDK is released in two types: Major (focused on features, three times a year) and Updates (focused on fixes, as often as needed).
- To view the full What's New section, see the online version of What's New.
October 2023 GDK Update 1
Issue fixes
System
Fixed an issue where protocol activation wasn't properly handling relative paths to the target executable.
Streaming
Fixed several issues where the title could crash or the streaming client properties would report no data if a streaming client connected while the
XGameStreamingInitializeAPI was executing.
Xbox services
Fixed a race condition in
WinHttpWebsocketteardown on suspend that could cause the title to crash or stop responding.
Fixed an issue where using XSAPI or PlayFab with trace logging enabled at information or verbose levels could cause the title to crash.
October 2023 GDK
Notifications
Visual Studio support
The GDK currently supports building game projects with the Visual Studio 2017 compiler and linker toolset (version v141) either from the command line or from the Visual Studio 2019 or Visual Studio 2022 IDEs.
Support for building game projects with the v141 toolset will be removed in the October 2024 version of the GDK.
Issue fixes
Commerce
Fixed an issue with
XStoreQueryAssociatedProductsAsyncwhere themaxItemsToRetrievePerPageparameter wasn't returning the correct number of results when 26 or more products were requested.
Known issues
GDK tools
The Microsoft Game Config editor can't be used to edit the new
<shareable>element that has been added to<PersistentLocalStorage>in the October 2023 GDK. You must edit the game config file manually to add the<shareable>element.If the Microsoft Game Config editor is used to open a file that contains the
<shareable>element, it will be inadvertently deleted when the file is saved.
Xbox services
Fixed an issue that could cause the title to crash when calling
PeoplehubService::DeserializeTitleHistoryfor certain locales. [45433556]
Middleware
Systems using the GDK Unity Package that have only the public GDK installed will have missing DLL issues in Unity projects until the next plugin release.
For more information and a quick fix, see Plugin fails to load DLLs/Tools for public GDK installs Issue #93 microsoft/gdk-unity-package.
March 2023 GDK Update 7 Public Release
March 2023 Microsoft Game Development Kit (GDK) release notes
Introduction
Welcome to the March 2023 Microsoft Game Development Kit release. You can use the GDK to develop games that can be certified and approved for release on Windows 11 PCs and Windows 10 PCs.
About this document
We have organized this document into the following sections.
- What's new
- Release notes:
- Documentation
What's new in the March 2023 Microsoft Game Development Kit
- The GDK is released in two types: Major (focused on features, three times a year) and Updates (focused on fixes, as often as needed).
- To view the full What's New section, see the online version of What's New.
March 2023 GDK update 7
Issue fixes
GDK tools
Fixed an issue that caused wdapp.exe to incorrectly report error code 0x800705b4 (This operation returned because the timeout period expired.) when installing a .msixvc file on a PC that has the latest public release of the Gaming Services component installed. [45598405]
Xbox services
Fixed an issue that could cause the title to crash when calling
PeoplehubService::DeserializeTitleHistoryfor certain locales. [45433556]
System
Fixed an issue with user mini dumps that caused memory dumps to either fail or be much larger than needed when writing a user mini dump with the
MiniDumpWithFullMemoryandMiniDumpFilterWriteCombinedMemoryflags.The issue caused user mini dumps to not filter out the memory blocks with protection set to
PAGE_WRITECOMBINE.The code has been updated to make sure that the filtering for
PAGE_WRITECOMBINE(whenMiniDumpFilterWriteCombinedMemoryis used) is applied for the memory writing phase, in addition to the descriptor writing phase.
March 2023 GDK update 5
Issue fixes
Xbox services
Fixed an issue where
XblCleanupAsyncwould never complete when called without any ongoing requests. [45364143]
GDK tools
Fixed an issue that caused the Microsoft Game Config editor to scale incorrectly when the PC was set to a non-English language. [45264919]
March 2023 GDK update 1
Notifications
Lighting
As of the March 2023 recovery, the GDK Lighting API only supports the following devices on console. Support for additional devices will be added in future recovery releases.
- Razer Turret for Xbox One (keyboard and mouse)
- Razer BlackWidow Tournament Edition Chroma V2
Issue fixes
Packaging
Fixed an issue where
makepkg packwould not create a package if the source files were read-only.
Xbox service
PlayFab Party titles that use peer-to-peer (P2P) for connectivity will now fall back to relayed connectivity if P2P connectivity is disrupted and unrecoverable.
March 2023 GDK
Breaking changes
If you're updating from a GDK version earlier than October 2022 GDK Update 2, check the release notes for previous releases for additional breaking changes that might affect you.
Notifications
Visual Studio
Side-by-side GDK uninstall issues
A bug in Visual Studio Installer version 17.4 can cause GDK components in Visual Studio 2019 and Visual Studio 2022 to work incorrectly after installing multiple GDK versions side-by-side on the same PC. The installer can also cause GDK uninstall failures.
This bug is fixed in Visual Studio Installer versions 17.4.6, 17.5.3 and 17.6.
Release notes
GDK Tools
Fixed a known issue where using the Visual Studio 2022 Debug Quick Resume option could result in a
failure to launch the titleerror message.
Input
Improved support for Japanese keyboard layouts in
GameInput.
Xbox services
Live Trace Analyzer (LTA)
Added checks to the LTA tool to detect if an Azure PlayFab title is using a known sample
titleid. The tool now returns a red failure that indicates that a sampletitleidis being used and must be configured to use a non-sampletitleidprior to being shipped to retail.
PlayFab
Added the PlayFab SDK Unreal Marketplace Plugin and GitHub Source to the ongoing official GDK compatibility matrix. Both releases were tested and are compatible with the March 2023 GDK and later.
Documentation
You can view the documentation online at Game Development Kit (GDK) documentation.
October 2023 GDK Public Release
October 2023 Microsoft Game Development Kit (GDK) release notes
Introduction
Welcome to the October 2023 Microsoft Game Development Kit release. You can use the GDK to develop games that can be certified and approved for release on Windows 11 PCs and Windows 10 PCs.
About this document
We have organized this document into the following sections.
- What's new
- Release notes:
- Documentation
What's new in the October 2023 Microsoft Game Development Kit
- The GDK is released in two types: Major (focused on features, three times a year) and Updates (focused on fixes, as often as needed).
- To view the full What's New section, see the online version of What's New.
October 2023 GDK
Notifications
Visual Studio support
The GDK currently supports building game projects with the Visual Studio 2017 compiler and linker toolset (version v141) either from the command line or from the Visual Studio 2019 or Visual Studio 2022 IDEs.
Support for building game projects with the v141 toolset will be removed in the October 2024 version of the GDK.
Issue fixes
Commerce
Fixed an issue with
XStoreQueryAssociatedProductsAsyncwhere themaxItemsToRetrievePerPageparameter wasn't returning the correct number of results when 26 or more products were requested.
Xbox services
Fixed an issue that could cause the title to crash when calling
PeoplehubService::DeserializeTitleHistoryfor certain locales. [45433556]
Known issues
GDK tools
The Microsoft Game Config editor can't be used to edit the new
<shareable>element that has been added to<PersistentLocalStorage>in the October 2023 GDK. You must edit the game config file manually to add the<shareable>element.If the Microsoft Game Config editor is used to open a file that contains the
<shareable>element, it will be inadvertently deleted when the file is saved.
Middleware
Systems using the GDK Unity Package that have only the public GDK installed will have missing DLL issues in Unity projects until the next plugin release.
For more information and a quick fix, see Plugin fails to load DLLs/Tools for public GDK installs Issue #93 microsoft/gdk-unity-package.
June_2023_Update_3
2024.03.29 - Administrator Note:
No change with this release - fixing an error with the release notes that were stuck in draft and not fully published. Release notes will be restored by April 2024.
June 2023 GDK Update 2 Public Release
June 2023 Microsoft Game Development Kit (GDK) release notes
Introduction
Welcome to the June 2023 Microsoft Game Development Kit release. You can use the GDK to develop games that can be certified and approved for release on Windows 11 PCs and Windows 10 PCs.
About this document
We have organized this document into the following sections.
What's new in the June 2023 Microsoft Game Development Kit
- The GDK is released in two types: Major (focused on features, three times a year) and Updates (focused on fixes, as often as needed).
- To view the full What's New section, see the online version of What's New.
June 2023 GDK Update 2
Issue fixes
GDK tools
Fixed an issue that caused the MicrosoftGame.config file in Visual Studio to be reformatted when the xml was edited directly. This was caused because the GUI version of the game config editor was saving the file and overwriting the formatting.
Fixed an issue that caused wdapp.exe to incorrectly report error code 0x800705b4 (This operation returned because the timeout period expired) when installing a .msixvc file on a PC that has the latest public release of the Gaming Services component installed.
June 2023 GDK Update 1
Issue fixes
GDK tools
Fixed an issue that caused the Microsoft Game Config editor to scale incorrectly when the PC was set to a non-English language.
Services
Fixed an issue where
XblCleanupAsyncwould never complete when called without any ongoing requests.
June 2023 GDK
Breaking changes
If you're updating from a GDK version earlier than March 2023 GDK Update 3, check the release notes for previous releases for additional breaking changes that might affect you.
Services
Microsoft Azure PlayFab APIs that previously took
XTokenin the request structure now takeXUserHandle.
The following requests are affected.
PFInventoryRedeemMicrosoftStoreInventoryItemsRequestPFFriendsClientGetFriendsListRequestPFAccountManagementClientLinkXboxAccountRequestA compile error now occurs when
XTokenis used in these APIs.
Notifications
Xbox services
Multiplayer Session Directory and SmartMatch features deprecation timeline
We're announcing a deprecation timeline for new titles that use the MPSD and SmartMatch features in the GDK. These features will be deprecated by March 2024 and will be replaced with Microsoft Azure PlayFab Lobby and PlayFab Matchmaking. Titles should use Multiplayer Activity (MPA) for XR compliance. Developers can continue to use their own in-house or third-party multiplayer services in combination with MPA. We'll begin warning on API usage in the October 2023 GDK.
New titles will lose access to these features in March 2024. There will be a process for applying for exceptions after March 2024. Existing titles will continue to have access to the GDK APIs past that date. However, new titles will be prevented from access in Partner Center to configure SmartMatch Hoppers or MPSD Session Templates unless these titles are given an exception. For more information, members of a managed program can see MPSD deprecation on the GDK forums.
Issue fixes
Services
Fixed an issue where Xbox Services API (XSAPI) real-time event callbacks weren't invoked on
XTaskQueuethat was provided to XSAPI during initialization.
Fixed a rare crash in Achievement manager that was caused by retrieving un-cached achievements during a Real-Time Activity service resync.
Documentation
You can view the documentation online at Game Development Kit (GDK) documentation.
March 2023 GDK Update 6 Public Release
March 2023 Microsoft Game Development Kit (GDK) release notes
Introduction
Welcome to the March 2023 Microsoft Game Development Kit release. You can use the GDK to develop games that can be certified and approved for release on Windows 11 PCs and Windows 10 PCs.
About this document
We have organized this document into the following sections.
- What's new
- Release notes:
- Documentation
What's new in the March 2023 Microsoft Game Development Kit
- The GDK is released in two types: Major (focused on features, three times a year) and Updates (focused on fixes, as often as needed).
- To view the full What's New section, see the online version of What's New.
March 2023 GDK update 5
Issue fixes
Xbox services
Fixed an issue where
XblCleanupAsyncwould never complete when called without any ongoing requests. [45364143]
GDK tools
Fixed an issue that caused the Microsoft Game Config editor to scale incorrectly when the PC was set to a non-English language. [45264919]
March 2023 GDK update 1
Notifications
Lighting
As of the March 2023 recovery, the GDK Lighting API only supports the following devices on console. Support for additional devices will be added in future recovery releases.
- Razer Turret for Xbox One (keyboard and mouse)
- Razer BlackWidow Tournament Edition Chroma V2
Issue fixes
Packaging
Fixed an issue where
makepkg packwould not create a package if the source files were read-only.
Xbox service
PlayFab Party titles that use peer-to-peer (P2P) for connectivity will now fall back to relayed connectivity if P2P connectivity is disrupted and unrecoverable.
March 2023 GDK
Breaking changes
If you're updating from a GDK version earlier than October 2022 GDK Update 2, check the release notes for previous releases for additional breaking changes that might affect you.
Notifications
Visual Studio
Side-by-side GDK uninstall issues
A bug in Visual Studio Installer version 17.4 can cause GDK components in Visual Studio 2019 and Visual Studio 2022 to work incorrectly after installing multiple GDK versions side-by-side on the same PC. The installer can also cause GDK uninstall failures.
This bug is fixed in Visual Studio Installer versions 17.4.6, 17.5.3 and 17.6.
Release notes
GDK Tools
Fixed a known issue where using the Visual Studio 2022 Debug Quick Resume option could result in a
failure to launch the titleerror message.
Input
Improved support for Japanese keyboard layouts in
GameInput.
Xbox services
Live Trace Analyzer (LTA)
Added checks to the LTA tool to detect if an Azure PlayFab title is using a known sample
titleid. The tool now returns a red failure that indicates that a sampletitleidis being used and must be configured to use a non-sampletitleidprior to being shipped to retail.
PlayFab
Added the PlayFab SDK Unreal Marketplace Plugin and GitHub Source to the ongoing official GDK compatibility matrix. Both releases were tested and are compatible with the March 2023 GDK and later.
Documentation
You can view the documentation online at Game Development Kit (GDK) documentation.
June 2023 GDK Update 1 Public Release
June 2023 Microsoft Game Development Kit (GDK) release notes
Introduction
Welcome to the June 2023 Microsoft Game Development Kit release. You can use the GDK to develop games that can be certified and approved for release on Windows 11 PCs and Windows 10 PCs.
About this document
We have organized this document into the following sections.
- What's new
- Release notes:
- Documentation
What's new in the June 2023 Microsoft Game Development Kit
- The GDK is released in two types: Major (focused on features, three times a year) and Updates (focused on fixes, as often as needed).
- To view the full What's New section, see the online version of What's New.
June 2023 GDK Update 1
Issue fixes
GDK tools
Fixed an issue that caused the Microsoft Game Config editor to scale incorrectly when the PC was set to a non-English language.
Services
Fixed an issue where
XblCleanupAsyncwould never complete when called without any ongoing requests.
June 2023 GDK
Breaking changes
If you're updating from a GDK version earlier than March 2023 GDK Update 3, check the release notes for previous releases for additional breaking changes that might affect you.
Services
Microsoft Azure PlayFab APIs that previously took
XTokenin the request structure now takeXUserHandle.
The following requests are affected.
PFInventoryRedeemMicrosoftStoreInventoryItemsRequestPFFriendsClientGetFriendsListRequestPFAccountManagementClientLinkXboxAccountRequestA compile error now occurs when
XTokenis used in these APIs.
Notifications
Xbox services
Multiplayer Session Directory and SmartMatch features deprecation timeline
We're announcing a deprecation timeline for new titles that use the MPSD and SmartMatch features in the GDK. These features will be deprecated by March 2024 and will be replaced with Microsoft Azure PlayFab Lobby and PlayFab Matchmaking. Titles should use Multiplayer Activity (MPA) for XR compliance. Developers can continue to use their own in-house or third-party multiplayer services in combination with MPA. We'll begin warning on API usage in the October 2023 GDK.
New titles will lose access to these features in March 2024. There will be a process for applying for exceptions after March 2024. Existing titles will continue to have access to the GDK APIs past that date. However, new titles will be prevented from access in Partner Center to configure SmartMatch Hoppers or MPSD Session Templates unless these titles are given an exception. For more information, members of a managed program can see MPSD deprecation on the GDK forums.
Issue fixes
Services
Fixed an issue where Xbox Services API (XSAPI) real-time event callbacks weren't invoked on
XTaskQueuethat was provided to XSAPI during initialization.
Fixed a rare crash in Achievement manager that was caused by retrieving un-cached achievements during a Real-Time Activity service resync.
Documentation
You can view the documentation online at Game Development Kit (GDK) documentation.
March 2023 GDK Update 2303 Public Release Notes
March 2023 Microsoft Game Development Kit (GDK) release notes
Introduction
Welcome to the March 2023 Microsoft Game Development Kit release. You can use the GDK to develop games that can be certified and approved for release on Windows 11 PCs and Windows 10 PCs.
About this document
We have organized this document into the following sections.
- What's new
- Release notes:
- Documentation
What's new in the March 2023 Microsoft Game Development Kit
- The GDK is released in two types: Major (focused on features, three times a year) and Updates (focused on fixes, as often as needed).
- To view the full What's New section, see the online version of What's New.
March 2023 GDK update 5
Issue fixes
Xbox services
Fixed an issue where
XblCleanupAsyncwould never complete when called without any ongoing requests. [45364143]
GDK tools
Fixed an issue that caused the Microsoft Game Config editor to scale incorrectly when the PC was set to a non-English language. [45264919]
March 2023 GDK update 1
Notifications
Lighting
As of the March 2023 recovery, the GDK Lighting API only supports the following devices on console. Support for additional devices will be added in future recovery releases.
- Razer Turret for Xbox One (keyboard and mouse)
- Razer BlackWidow Tournament Edition Chroma V2
Issue fixes
Packaging
Fixed an issue where
makepkg packwould not create a package if the source files were read-only.
Xbox service
PlayFab Party titles that use peer-to-peer (P2P) for connectivity will now fall back to relayed connectivity if P2P connectivity is disrupted and unrecoverable.
March 2023 GDK
Breaking changes
If you're updating from a GDK version earlier than October 2022 GDK Update 2, check the release notes for previous releases for additional breaking changes that might affect you.
Notifications
Visual Studio
Side-by-side GDK uninstall issues
A bug in Visual Studio Installer version 17.4 can cause GDK components in Visual Studio 2019 and Visual Studio 2022 to work incorrectly after installing multiple GDK versions side-by-side on the same PC. The installer can also cause GDK uninstall failures.
This bug is fixed in Visual Studio Installer versions 17.4.6, 17.5.3 and 17.6.
Release notes
GDK Tools
Fixed a known issue where using the Visual Studio 2022 Debug Quick Resume option could result in a
failure to launch the titleerror message.
Input
Improved support for Japanese keyboard layouts in
GameInput.
Xbox services
Live Trace Analyzer (LTA)
Added checks to the LTA tool to detect if an Azure PlayFab title is using a known sample
titleid. The tool now returns a red failure that indicates that a sampletitleidis being used and must be configured to use a non-sampletitleidprior to being shipped to retail.
PlayFab
Added the PlayFab SDK Unreal Marketplace Plugin and GitHub Source to the ongoing official GDK compatibility matrix. Both releases were tested and are compatible with the March 2023 GDK and later.
Documentation
You can view the documentation online at Game Development Kit (GDK) documentation.