xbox_module_tests

Autowork integration tests for the native Blazium xbox_module.

Ports GDK coverage from XBOX-Godot-Sample to the engine's built-in Xbox module. Live Xbox Live scenarios are gated on environment variables so CI and local dev can run without credentials.

Requirements

• Windows (xbox_module is Windows-only)
• Microsoft Gaming GDK installed (default: C:\Program Files (x86)\Microsoft GDK)
• Blazium editor build with:
  • module_xbox_module_enabled=yes
  • module_autowork_enabled=yes

Build Blazium from the xbox-module branch:

cd path\to\blazium
python -m SCons module_xbox_module_enabled=yes module_autowork_enabled=yes platform=windows target=editor tests=yes windows_subsystem=console -j8

GDK runtime DLLs (Microsoft.Xbox.Services.C.Thunks.dll, libHttpClient.dll, XCurl.dll) are staged into blazium/bin/ automatically when GDK is detected.

Setup

Clone this repo next to your Blazium checkout (paths in the commands below assume that layout):

git clone https://github.com/blazium-games/xbox_module_tests.git
# sibling to blazium/

Running tests

From the project root:

..\blazium\bin\blazium.windows.editor.tests.x86_64.exe --headless -s run_tests.gd

Or use the console wrapper if present:

..\blazium\bin\blazium.windows.editor.tests.x86_64.console.exe --headless -s run_tests.gd

Test tiers

Tier	Env vars	Description
0/1	(none)	Class registration, validation, packaging, runtime lifecycle — no Xbox account
Live read	LIVE_TESTS=1	Signed-in user flows, achievements, presence, etc.
Live write	LIVE_TESTS=1 and LIVE_WRITE_TESTS=1	Stateful Xbox Live writes

$env:LIVE_TESTS = "1"
..\blazium\bin\blazium.windows.editor.tests.x86_64.exe --headless -s run_tests.gd

For sandbox testing, see Microsoft GDK custom-engine PC guidance.

Exit code equals the Autowork failure count (0 = success).

Project layout

xbox_module_tests/
├── .autoworkconfig.json   # Autowork discovery (tests/**/test_*.gd)
├── run_tests.gd           # Headless entry point
├── MicrosoftGame.config   # Fixture for GDK init-with-config tests
├── project.godot
└── tests/
    ├── support/           # xbox_test_base.gd, test_env.gd
    ├── packaging/         # MicrosoftGame.config / toolchain smoke
    └── test_*.gd          # Service and runtime suites

License

MIT — see LICENSE.