This folder is a pointer, not a project. NetRumble lives in its own repository: microsoft/XBOX-Godot-NetRumble
NetRumble is a complete Godot 4 multiplayer game that integrates the Microsoft Game Development Kit (GDK) and PlayFab. It is a 2D top-down space shooter: players fly ships through an asteroid field inside a walled arena, collect weapon power-ups, and shoot each other for points.
Where the tutorial samples in this repository demonstrate one surface at a time, NetRumble wires every service into actual gameplay. It is the reference for what a full title looks like once the addons are in use. It is a working sample, not a certified title.
- GDK sign-in exchanged for a PlayFab identity, and a sign-in screen that cooperates with the system account picker
- Join-code discovery with PlayFab Lobby, and PlayFab Party as a drop-in Godot
MultiplayerPeer - Host-authoritative replication with client prediction
- Multiplayer and communications privilege checks, plus per-player mute, block and avoid
- Voice chat, and text verification before user-authored content is published
- One-shot and incremental achievements
- Console Game Save for profile, history and counters, written to the Game Save folder
rather than
user:// - Suspend, resume, and constrained-mode handling
- Activity publishing, join-from-guide invites, and connectivity detection
Every platform call goes through a single services facade, so gameplay and UI never reach into GDK or PlayFab directly.
NetRumble consumes the addons authored here. It pins this repository as a submodule at
external/xbox-godot-sample and builds it into its own addons/ folder, so changes to the
GDK, PlayFab and GameInput addons flow into NetRumble when it moves that pin.
Godot 4.6 or later on Windows, with the addons built once from the submodule. Sign-in, multiplayer and achievements need the PC in the XDKS.1 sandbox and a signed-in test account. Exporting to XBOX Series X|S additionally requires a middleware console fork of Godot.
Full setup lives in the NetRumble repository's own README and docs/.
- Tutorials index
- Getting started
- Integrated XBOX + PlayFab sample:
sample/tutorial_integrated/