dot-platform

dot-auth says who you are. dot-user says what we know about you. dot-user-avatar says what you look like. None of them knows about the others — that is what makes them adoptable one at a time — and so nothing joined them up. This does.

Requires dot-core and dot-server.

It requires dot-core and dot-server, and finds the other three at run time. Any subset works, including none.

var hub := DotPlatformHub.new()
add_child(hub)

var admitted := await hub.admit(identity)
var player: DotPlatformPlayer = admitted.value

player.key()            # scoped id — what everything else uses
player.display_name()   # from the profile, falling back to the identity
player.avatar           # resolved, conformed, entitlement-checked

On a dot-server, load the module instead and it does that per connection:

server.modules.load_module("res://addons/dot_platform/dot_platform_module.gd")

It finds the hub through DotRegistry, admits every authenticated client, puts the result on session.data["platform"], applies the profile’s name, releases the state when they leave, and adds platform_status and platform_name to the console.

The translation it exists to do

identity.uid          "backbone:acc-1"     global; a server must never see this
   -> profile.user_key  "sWrM4ym4beWFH0Nx"  scoped; what everything else keys on
   -> avatar filed under the SAME scoped key

Keying the avatar on the account id instead works perfectly in testing and quietly hands every server operator a global identifier for every player. DotPlatformHub is the only place that translation happens, and DotPlatformPlayer.account_uid() is named to be conspicuous at the call site.

Everything optional stays optional

A sandbox that required all three to start would be unusable on the first day of a project, which is the day people decide whether to adopt something.

Where a game plugs in

DotPlatformModule

Load it into a dot-server and admission is wired. Subclass it, or call DotPlatformHub.admit directly, for a different join flow.

DotPlatformHub.entitlement_sourceCallable

Where “what does this player own” comes from — a purchase, a season pass, a site group. Unset, a player owns nothing, which is the loud default rather than the silent one.

DotPlatformConfig

Timeouts, whether onboarding is required, and what an absent subsystem means.

Signals

player_admitted, player_refused, player_released, avatar_changed.