Pragma Engine 2026.3.X #
2026
Highlights #
Dedicated telemetry backend #
You can run telemetry on its own set of instances, so a surge of telemetry events can’t interrupt your game and social services. Telemetry infrastructure costs are also easier to separate out, which helps studios working with a centralized publisher. Game and social services reach the dedicated backend over the internal load balancer, keeping network costs down. For more details see Dedicated telemetry backend.
Login queue bypass #
Developers, community managers, partners, and streamers can skip the login queue and log in immediately, even when the game is at CCU capacity. Approved accounts are managed in backend config, so adding one requires no client build or code change. For more details see Login queue bypass.
Telemetry sampling for game clients and game servers #
You can turn telemetry volume up, down, or off for both game clients and dedicated game servers from backend config. Changes reach connected clients and servers in real time, with no redeploy. For more details see Client and game server event sampling.
Steam Family Sharing ban enforcement #
Banned players can no longer keep playing by lending their Steam license to a fresh account through Steam Family Sharing. Logins on a borrowed license are refused when the license owner is banned, and banning a player also bans the owner of the license they most recently played on. Both protections are on by default. For more details see Steam Family Sharing.
Broadcast notifications to game servers and operators #
You can now broadcast a notification to every connected game server or operator session, not just players. For example, warn every running game server of upcoming maintenance from a single service call. For more details see Broadcast notifications.
Unreal 5.8 support #
You can build your game on Unreal 5.8 with the Pragma SDK. For more details see SDK overview.
Fixes & Improvements #
Inbound and outbound worker fixes #
Improved cancellation exception handling in the background processes for inbound and outbound traffic.
PlayerData and RPC dispatch performance #
Reduced allocations in PlayerData generated code, and faster RPC dispatch on hot paths.
Unreal SDK updates through the Pragma CLI #
You no longer need to set up and maintain an SDK copy script in your game repo. A single Pragma CLI command regenerates your SDK types and copies the SDK into your Unreal project. For more details see Set up the Unreal SDK.
Session baggage SDK and service support #
The Unreal and Unity SDKs now expose session baggage updates (GameUpdateSessionBaggageV1, SocialUpdateSessionBaggageV1, and their PartnerV1 variants), and backend services can update a player or partner session’s baggage through the new UpdateSessionBaggageServiceV1 and UpdateSessionBaggageServicePartnerV1 RPCs. See Session baggage.
Outbound Http performance and reliability #
Improved outbound Http performance through connection reuse and the Apache5 engine. Game to social concurrency is capped by SocialBackendPartnerClientConfig.maximumConcurrentRequests, now hot-reloadable. See Outbound Http.
Database connection pool performance #
Improved database connection pool performance. New DatabaseConfig options hikariPrepStmtCacheSize and hikariPrepStmtCacheSqlLimit control prepared-statement caching. See Database connection pools.
Metrics and dashboards #
- Dashboards can be filtered by backend type, including dedicated telemetry nodes, and by node name.
- New metrics for JVM health (heap pressure, file descriptors, thread counts), internal message routing, PlayerData operation outcomes, and cache removals versus evictions. See Engine metrics.
- Database connection pool metrics emit far fewer histogram series, and partitioned DAOs report each pool separately. See integrations for the
poollabel change.
Player-traceable debug logging #
Debug logging in most request flows includes player Ids, so a single player’s calls can be followed through the system.
Config change broadcasts #
Fixed every node in a multinode shard rebroadcasting config changes.
Shard-wide cache limits #
Evicting caches can be sized for the whole shard with multinodeTotalSizeBeforeExpirationEnforced on EvictingCacheConfig, split evenly across instances.
Player token defaults #
TokenConfig.playerTokenExpirationMinutes defaults to 3 hours (was 24 hours), and playerTokenRefreshMinutes defaults to 15 minutes before expiration (was 45 minutes after issuance).
Rich Presence fix #
Fixed Rich Presence calls failing when a player’s base presence is unset.
Xbox fixes #
Improved Http performance for Xbox API calls. Collections calls now filter to consumable entitlements for the products in your order mappings, reducing the data returned. Take these fixes through the confidential Xbox import; see integrations.
PlayStation sandbox support #
The PlayStation identity and order provider plugins now support Sony’s DEV and CERT sandboxes through a new psnSandboxId config.
Portal improvements #
The portal displays telemetry configuration, and shows a clear unavailable state when a backend request fails, such as viewing orders while the OrderService is disabled.
Pragma CLI #
- Added
./pragma project currentto show which project is active. ./pragma run --backendType ALLstarts the game, social, and dedicated telemetry backends together.- Fixed CLI auto-complete. Enable it with
eval "$(./pragma completions)".
Documentation updates #
- The Authenticate with Steam tutorial was updated to an asynchronous flow. The example code now waits for Steam to register the auth ticket before the backend validates it, avoiding intermittent login failures.
- Customization docs are restructured, with working code examples drawn from a reference implementation.
- Login, session, and platform classifier docs are expanded.
Ktor upgrade #
Upgraded Ktor to 3.4.3.
Http compression #
Gateways, game to social calls, and telemetry client calls support Http compression. Enable with enableHttpCompression (default false), and set the minimum body size to compress with httpCompressionMinBodyBytes. See Http compression.
Load simulator #
The load simulator runs on a new reusable Kotlin client library for player, operator, and partner sessions. It can load-test a dedicated telemetry backend, and reports dropped connections and timeouts as connection errors instead of hanging. See Load test dedicated telemetry.
Unreal SDK provider token timing #
The Unreal SDK requests the provider token only after the player clears the login queue, so tokens no longer expire while queued. The token callback can also report that the token couldn’t be obtained, which ends the login immediately with Login_ProviderTokenUnavailable instead of waiting for the 30-second timeout. See integrations for migration steps.
SDK Compatibility #
The Pragma SDK has been compatibility tested with the following versions.
| SDK | Verified Versions |
|---|---|
| Unreal Engine | 4.27, 5.0, 5.1, 5.2, 5.3, 5.4, 5.5, 5.6, 5.7, 5.8 |
| Unity | 2021.3.16f1 |
Patches #
For information on updating to the latest Pragma version, see Update Pragma Engine.
2026.3.1 #
Removed UnsafeOrderService and the unsafe order routes that allowed for granting specific SKUs without going through a third-party
provider. UnsafeOrderProviderPlugin remains, with its chance-based receive, revoke, and error settings. Contact your CSM for the extra
unsafe order functionality.
Reduced metrics scrape cost. jvm.threads.states reads the thread table once per scrape instead of once per thread state.
2026.3.2 #
Fixed .gitattributes Images removed due to git-lfs are real files again.