From 7ae316b9266f01e0e027ed9ff4f1888ffbaeb044 Mon Sep 17 00:00:00 2001
From: "Zach Hooper (XBOX)" <189283928+zachhooper@users.noreply.github.com>
Date: Fri, 11 Sep 2026 17:17:45 -0700
Subject: [PATCH] Add Godot samples category linking the external XBOX Godot
samples
Adds Samples/Godot/readme.md pointing at XBOX-Godot-Sample and
XBOX-Godot-NetRumble, which are maintained in their own repositories,
and lists the new Godot category in gdk-samples-list.md and README.md.
---
README.md | 1 +
Samples/Godot/readme.md | 13 +++++++++++++
gdk-samples-list.md | 12 ++++++++++++
3 files changed, 26 insertions(+)
create mode 100644 Samples/Godot/readme.md
diff --git a/README.md b/README.md
index 14897720..64c35d9a 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,7 @@ This repo contains game development samples written by the Microsoft Xbox Advanc
* [Media](/Media) contains media files used by the samples
* [Samples](gdk-samples-list.md) contains samples
* [Audio](gdk-samples-list.md#Audio)
+ * [Godot](gdk-samples-list.md#Godot)
* [Graphics](gdk-samples-list.md#Graphics)
* [Handheld](gdk-samples-list.md#Handheld)
* [IntroGraphics](gdk-samples-list.md#IntroGraphics)
diff --git a/Samples/Godot/readme.md b/Samples/Godot/readme.md
new file mode 100644
index 00000000..d7a2558f
--- /dev/null
+++ b/Samples/Godot/readme.md
@@ -0,0 +1,13 @@
+# Godot
+
+Samples demonstrating Microsoft Game Development Kit (GDK) integration with Godot 4.
+
+These are external samples, built by XBOX, and are maintained in their own repositories rather than in this one. Follow the links below for requirements, build instructions, and full documentation.
+
+## [XBOX Godot Sample](https://github.com/microsoft/XBOX-Godot-Sample)
+
+Reference GDExtension addons that bind the Microsoft GDK, XBOX Services, PlayFab, and GameInput into Godot 4, usable from both GDScript and C#/.NET. Drop the addons into an existing Godot project to build your title for XBOX on PC, and work through the tutorial projects covering sign-in, achievements, leaderboards, Game Saves, lobbies, Party, and controller input.
+
+## [XBOX Godot NetRumble](https://github.com/microsoft/XBOX-Godot-NetRumble)
+
+A complete multiplayer XBOX game built in Godot 4: a 2D top-down space shooter with lobby and Party voice chat, invites from the guide, achievements, and a saved match history. Built on the XBOX Godot Sample addons, it wires each Microsoft GDK and PlayFab service into the place a shipping title would really call it, around a real game loop.
diff --git a/gdk-samples-list.md b/gdk-samples-list.md
index 3e6d21b5..746a2aa4 100644
--- a/gdk-samples-list.md
+++ b/gdk-samples-list.md
@@ -7,6 +7,7 @@ Following is a list of categories for the samples.
- [Microsoft Game Development Kit samples](#microsoft-game-development-kit-samples-list)
- [Categories](#categories)
- [Audio](#audio)
+ - [Godot](#godot)
- [Graphics](#graphics)
- [Handheld](#handheld)
- [IntroGraphics](#intrographics)
@@ -32,6 +33,17 @@ Following is a list of categories for the samples.
| __SimpleWASAPICapture__ | This sample demonstrates how to capture audio using WASAPI on Xbox. | ✓ | |
| __SimpleWASAPIPlaySound__ | This sample demonstrates how to play setup and play a simple sound (sine tone) to a WASAPI render endpoint on Xbox. | ✓ | |
+
+
+### Godot
+
+External samples, built by XBOX, that demonstrate GDK integration with Godot. These are maintained in their own repositories rather than in this one; see [Samples/Godot](Samples/Godot/readme.md).
+
+| Sample | Description | Console | PC |
+| ------ | ----------- | ------- | -- |
+| __[XBOX Godot Sample](https://github.com/microsoft/XBOX-Godot-Sample)__ | Reference GDExtension addons binding the Microsoft GDK, XBOX Services, PlayFab, and GameInput into Godot 4, usable from both GDScript and C#/.NET. | | ✓ |
+| __[XBOX Godot NetRumble](https://github.com/microsoft/XBOX-Godot-NetRumble)__ | A complete multiplayer XBOX game built in Godot 4, wiring the Microsoft GDK and PlayFab services into a real game loop. | ✓ | ✓ |
+
### Graphics