croupier

Croupier is a general-purpose GM backend system for game operations, serving multi-game and multi-environment scenarios within a single game company. The system adopts a three-layer architecture: Web Console → Server (control plane, supporting high availability) → Agent (deployed in game VPC) → Game Server/SDK. TCP sessions (TLS enabled by default) are used between the Agent and Server, while TCP sessions (TLS disabled by default) are used between the SDK and Agent; both links share the same session transport base, differing only in handshake messages and business semantics. The business scope is defined by gameId (game identifier) and env (environment identifier such as dev/staging/prod), decoupled from physical deployment locations. Core capabilities include a unified function registration and scheduling model, lightweight session transport (single-connection bidirectional requests, reconnection, backpressure, stream removal), a message format consisting of JSON business data + Protobuf envelopes, and an Ant Design Pro console driven by JSON Schema capability contracts. It supports SQLite (for development and testing), MySQL (recommended for production), PostgreSQL, and SQL Server databases. Official SDKs are provided for Go, C#, Java, C++, Python, and JS/TS, with documentation covering architectural design, scope models, transport protocols, and SDK usage guides.