diff --git a/server/README.md b/server/README.md new file mode 100644 index 0000000..8bdad2d --- /dev/null +++ b/server/README.md @@ -0,0 +1,14 @@ +# Airship multiplayer server + +Go transport/authentication service for the Phaser airship game. + +Current slice: + +- verifies Keycloak access tokens +- persists authenticated player profiles to PostgreSQL +- issues one-time 30-second WebSocket tickets +- maintains one live connection per Keycloak subject +- validates and broadcasts player transform/hull snapshots at 10 Hz +- exposes `/health`, `/api/me`, `/api/ws-ticket`, and `/ws` + +This is intentionally a transport/presence milestone. Player combat, pirates, projectiles, trading and economy still run in the Phaser client and are the next systems to move server-side.