Notable changes

Added

• Add new runtime function to update storage objects with retries.

Changed

• Update Satori client to match latest API spec.
• Add configurable retries to the Satori client.

Fixed

• Ignore negative custom runtime counter deltas to avoid panics during metrics collection.
• Set account empty fields to null appropriately on console account import.
• Correctly cancel context after matchmaker matched function completes.
• Fix X-Forwarded-For header handling regression.

Notable changes

Added

• Add runtime Satori client feature to delete identities.
• Add device identifiers as lookup options for runtime account get operations.
• Add Go runtime function to import an account export snapshot.
• Add TypeScript/JavaScript runtime function to import an account export snapshot.
• Add Lua runtime function to import an account export snapshot.
• Better searching by account display name in the Console UI.

Changed

• Better logic for determining client IP addresses from incoming requests.
• Limit the number of custom metric scopes to prevent adding user identifiers as tags.

Fixed

• Correct field usage in voided Google In-App Purchase subscription notifications.
• Fix an issue where the Storage Index would keep entries which should have been filtered.
• Fix an issue that could prevent leaderboard/tournament end/reset hooks from firing.
• Avoid logging unnecessary context cancellation errors on storage operations.

NOTE: For developers who use the Go server runtime support. The nakama-common package at v1.45.0 must be used with this release.

env GO111MODULE=on go get "github.com/heroiclabs/nakama-common/runtime@v1.45.0"

Notable changes

Added

• Support Apple JWS receipts in In-App Purchase validation APIs.
• Expose new Prometheus RPC metrics with label per gRPC status.

Fixed

• Fix permission check on Console Group AddMembers operation.
• Fix Lua runtime random generator seeding.

NOTE: For developers who use the Go server runtime support. The nakama-common package at v1.44.2 must be used with this release.

env GO111MODULE=on go get "github.com/heroiclabs/nakama-common/runtime@v1.44.2"

Notable changes

Changed

• Improvements to Console user setup and management.
• Option for faster cleanup of parties that are idle and empty.
• Build with Go 1.25.5.

Fixed

• Ensure party leader username is recorded on party creation.
• Ensure ended matches are removed from the Console UI list more quickly.

NOTE: For developers who use the Go server runtime support. The nakama-common package at v1.44.1 must be used with this release.

env GO111MODULE=on go get "github.com/heroiclabs/nakama-common/runtime@v1.44.1"

Notable changes

Fixed

• Correctly wire context propagation in Session Start/End runtime event hooks.

NOTE: For developers who use the Go server runtime support. The nakama-common package at v1.44.0 must be used with this release.

env GO111MODULE=on go get "github.com/heroiclabs/nakama-common/runtime@v1.44.0"

Notable changes

Added

• New runtime Satori client options for time-based caching.
• Additional information for transactions in console UI details side panel.
• Console API status endpoint now returns number of active Parties per node.
• Console UI status view now displays number of active Parties per node and total.
• Console API status endpoint now returns the startup time when each node was created.
• Console UI status view now displays time since each node was started.

Changed

• Adjust unit of measure for Satori client timeout.
• Nakama will not start if attempting to register custom HTTP handlers without a '/' prefix in the path pattern.
• Nakama will not start if attempting to register custom console HTTP handlers without a '/' prefix in the path pattern.
• Add runtime Satori client additional filters for live-events listing.
• Add runtime Satori client live-event join function.
• Configurable timeout for server initiated socket disconnects graceful close wait period.
• Fix an issue in the console ACL database schema migration that would prevent it from being applied in CockroachDB.
• Better display for long transaction identifiers in console UI.

Fixed

• Fix migration script to correctly revert console fine-grained access control changes.
• Avoid unnecessary cache check in runtime Satori client Properties lookup.
• Fix an issue that would prevent the console data reset operation from completing successfully.
• Fix an issue with Apple In-App Purchase notification handling that would prevent the notification from being processed.
• Fix an issue with Google In-App Purchase notification handling that would prevent refund/voided types from being processed.
• Fix incorrect error message in the console UI when storage import operations actually succeed.
• Fix incorrect display of ascending/descending leaderboard indicator in console UI.
• Fix incorrect display of pagination indicators for filtered storage lookups in console UI.
• Fix issue where disabling tournament ranks might not use the correct timezone for lookups.

NOTE: For developers who use the Go server runtime support. The nakama-common package at v1.44.0 must be used with this release.

env GO111MODULE=on go get "github.com/heroiclabs/nakama-common/runtime@v1.44.0"

Notable changes

Added

• Add trace identifier to RPC function contexts.
• Add runtime Satori client feature to send direct messages.
• Add runtime Satori client option to fetch messages by a set of identifiers.
• New TypeScript/JavaScript runtime function to generate secure random bytes.
• New Lua runtime function to generate secure random bytes.

NOTE: For developers who use the Go server runtime support. The nakama-common package at v1.43.1 must be used with this release.

env GO111MODULE=on go get "github.com/heroiclabs/nakama-common/runtime@v1.43.1"

Notable changes

Added

• New Go runtime initializer function to register raw console HTTP handlers.

Changed

• Satori client functions now allow filtering by both names and labels.

Fixed

• Use correct leaderboard ranks disable hook in the Go runtime.
• Release database connections faster in notification deletion operations.
• Release database connections faster when listing console users.
• Release database connections faster when disabling ranks for leaderboards or tournaments.

NOTE: For developers who use the Go server runtime support. The nakama-common package at v1.43.0 must be used with this release.

env GO111MODULE=on go get "github.com/heroiclabs/nakama-common/runtime@v1.43.0"

Notable changes

Fixed

• Fix an issue with Hiro dependencies vendoring.
• Remove usage of database random generator function in migrations for compatibility with older PostgreSQL versions.

NOTE: For developers who use the Go server runtime support. The nakama-common package at v1.42.2 must be used with this release.

env GO111MODULE=on go get "github.com/heroiclabs/nakama-common/runtime@v1.42.2"

Notable changes

Added

• Add Hiro integration to Console UI.
• Console UI display and interaction with Hiro Inventory.
• Console UI display and interaction with Hiro Progressions.
• Add support for importing accounts in Console UI.
• Add support for exporting and importing storage object values.
• Expanded support for access controls in Console UI and API.
• Support for access control templates in Console UI.
• Console UI integration with Satori, if configuration is present.
• Allow sending Satori messages directly from the Console UI.
• Add support for account notes in Console UI.
• Add support for additional filtering options in Console UI Purchases and Subscriptions views.
• Add support for additional filtering options in Console UI Wallet Ledger view.
• Allow sending In-App Notifications from Console UI.

Fixed

• Add missing return value in Google In-App Purchase subscription validation.

NOTE: For developers who use the Go server runtime support. The nakama-common package at v1.42.2 must be used with this release.

env GO111MODULE=on go get "github.com/heroiclabs/nakama-common/runtime@v1.42.2"