B44.Godot

Godot-side adapters and headless composition smoke testing for B44 games, published as the B44.Godot package on nuget.org.

This is the engine-coupled counterpart to B44.Common. It exists as its own repository so every other B44 repository can keep its engine-free MSBuild guard literally true, with no carve-outs — and so Godot-side code can churn on the engine's release cadence without dragging the engine-free packages with it.

Planned work and known defects are tracked in BACKLOG.md.

What's in it

Namespace	Types	Purpose
B44.Godot.Smoke	IB44StartupProbe, B44StartupState	The game-side surface: expose whether startup succeeded, and why not
B44.Godot.Smoke	SmokeEvaluation, SmokeObservation, SmokeResult	Godot-free pass/fail rules, and the marker + exit-code contract
B44.Godot.Smoke	B44SmokeRunner	Thin Node shell that gathers observations and quits with a verdict

Composition smoke testing

A game implements IB44StartupProbe, adds B44SmokeRunner to a smoke scene, and calls the reusable workflow:

jobs:
  smoke:
    uses: DA-Sandman-Jr/B44.Godot/.github/workflows/reusable-godot-smoke.yml@<sha>
    with:
      godot-version: '4.7.0'      # required; no default
      project-path: '.'
      smoke-scene: 'res://tests/Smoke.tscn'

godot-version is deliberately required and unset by default so each game owns the version it tests against, and this repository never needs editing when Godot releases.

The workflow asserts on a standardized marker line and the process exit code. That contract is owned here — games conform to it rather than inventing their own, because three games with three protocols is the duplication this package exists to prevent.

Versioning

B44.Godot, B44.Common, and B44.Standards each version independently from their own public repositories. Consumers float B44.Godot as 0.<minor>.* while it is pre-1.0. Any change to the smoke marker or exit codes is contract-expanding and bumps the minor version.

Building

dotnet test

No Godot installation is required to build or test: GodotSharp is a compile-time-only package reference, and every pass/fail rule is deliberately free of Godot types. The Node shell and the workflow are covered by a consuming game running the workflow in CI.

License

None — all rights reserved. The source is public for reference; it is not licensed for reuse. See LICENSE and THIRD-PARTY-NOTICES.md.