gravitlauncher/launcher

Purpose and topology

A multi-module Java/Gradle launcher platform: it operates a LaunchServer, builds/distributes launcher binaries and game assets, authenticates users, and starts configured client/server processes. Shared protocol, profile, module, and filesystem abstractions separate server and local-launcher concerns.

• settings.gradle.kts

• components/build.gradle.kts

• openapi.yaml

Entry points and deployment

The server process starts through Main, which constructs and runs LaunchServer; launcher-side startup uses a wrapper before entering the runtime engine. The repository includes Docker packaging and CI publication workflows.

• components/launchserver/src/main/java/pro/gravit/launchserver/Main.java

• components/launchserver/src/main/java/pro/gravit/launchserver/LaunchServerStarter.java

• components/launcher-start/src/main/java/pro/gravit/launcher/start/ClientLauncherWrapper.java

Shared contracts and extensibility

launcher-api defines the client/server request-event protocol, client/game profiles, configuration conventions, and lifecycle-based modules. launcher-core supplies API façades, serialization, hashing, launch primitives, and trust/network foundations. Module managers and phase events are the primary extension boundary for both client and server code.

• components/launcher-api/src/main/java/pro/gravit/launcher/base/request/Request.java

• components/launcher-api/src/main/java/pro/gravit/launcher/base/modules/LauncherModulesManager.java

• components/launcher-core/src/main/java/pro/gravit/launcher/core/api/LauncherAPI.java

Network request flow

Launcher clients issue typed requests through request services, principally WebSocket implementations, with offline/HTTP feature alternatives. LaunchServer’s Netty endpoint dispatches these to response handlers for authentication, profiles, updates, security, and management; it also exposes HTTP/file-serving handlers.

• components/launcher-api/src/main/java/pro/gravit/launcher/base/request/websockets/ClientWebSocketService.java

• components/launchserver/src/main/java/pro/gravit/launchserver/socket/LauncherNettyServer.java

• components/launchserver/src/main/java/pro/gravit/launchserver/socket/WebSocketService.java

Identity, authorization, and protection

Server authentication is provider-based: in-memory, SQL-backed MySQL/PostgreSQL, merged, and OpenID implementations are available. Password verifiers, sessions, permissions/features, texture/profile integration, hardware reports, secure-level key verification, and join-server protection are handled behind authentication/protection interfaces. External dependencies can therefore include SQL databases and an OpenID provider.

• components/launchserver/src/main/java/pro/gravit/launchserver/manangers/AuthManager.java

• components/launchserver/src/main/java/pro/gravit/launchserver/auth/core/AuthCoreProvider.java

• components/launchserver/src/main/java/pro/gravit/launchserver/auth/protect/ProtectHandler.java

Artifact, update, and runtime pipeline

The server maintains profiles and update sources, then composes signed JAR or EXE launcher binaries through an ordered binary pipeline. At runtime, LauncherEngine obtains backend settings/resources, downloads and verifies client content, applies profile-selected options, and creates the client JVM process. VFS abstractions support local, cached, URL, overlay, and encrypted resource layers.

• components/launchserver/src/main/java/pro/gravit/launchserver/binary/BinaryPipeline.java

• components/launcher-runtime/src/main/java/pro/gravit/launcher/runtime/LauncherEngine.java

• components/launcher-runtime/src/main/java/pro/gravit/launcher/runtime/client/ClientLauncherProcess.java>

Trust and operational boundaries

Certificate generation/pinning and key agreement protect launcher/server communication and signed artifacts. Server console commands manage builds, profiles, modules, keys, and service state; deployers configure the process and optional modules rather than changing protocol code.

• components/launcher-core/src/main/java/pro/gravit/launcher/core/CertificatePinningTrustManager.java

• components/launchserver/src/main/java/pro/gravit/launchserver/manangers/CertificateManager.java

• components/launchserver/src/main/java/pro/gravit/launchserver/config/LaunchServerConfig.java