Home

ggscale

ggscale is an open-source backend for multiplayer games. It runs as one Go binary against one Postgres database, and you host it yourself. That gives a game player accounts, saves, leaderboards, social features, matchmaking, and a game-server fleet without stitching several services together.

Your data stays in your own database. A deployment fits on a single VPS and scales out when a game needs more. You do not run a message broker or a separate cache tier next to it, and there is no sidecar.

Features

The status column marks what is generally available (GA) and what is still beta.

Feature	Status	What it gives you
Authentication and players	GA	Email/password, anonymous, and custom-token sign-in, with global account linking across games.
Player profiles	GA	Per-project email and external console id (xuid); the display name lives on the global account.
Cloud saves (object storage)	GA	Per-player JSON store with If-Match optimistic concurrency.
Leaderboards	GA	Server-authoritative submit, with top and around-me reads.
Friends and presence	GA	Requests, blocks, and online state over WebSocket.
Game sessions and invites	GA	Pre-game rooms with 6-character join codes and short-lived invites.
Matchmaking	GA	Tickets with match_only, game_session, and fleet_allocation results. Fleet allocation is beta.
Realtime WebSocket events	GA	Presence, invites, and match delivery over one hub, recoverable by polling.
P2P connectivity and TURN relay	GA	Peer-to-peer handshake with an optional embedded relay for NAT traversal.
Server browser	GA	Heartbeat registry for persistent dedicated servers.
Game-server fleet	beta	On-demand game servers via Docker, Agones, or a plugin backend.

Where to go next

• Integrate your game. Start with the Quickstart, then read Core Concepts and the Feature Guides.
• Self-host the server. See Run in Production for Compose and bare-binary setups.
• Contribute. Read the Architecture page and the Contributing guide.