Pragma Engine 0.0.75
July 12th, 2022
Features #
- New Operator endpoint added to list and filter player identities with an additional requirement for game shard ID.
- Description: We’ve added a new endpoint
GetPragmaPlayerOverviewsOperatorV1
. This has the same filtering capabilities as theGetPragmaAccountOverviewsOperatorV1
endpoint, but also requires a game shard ID. - Postman Path:
- Description: We’ve added a new endpoint
- Portal: Instanced items can now be removed from player inventories.
- Description: Visit Player Support > Players and select a player, then click Inventory. From the Instanced tab, items can be removed using the remove button at the end of the row.
- Portal: Previous search criteria is now saved and repopulated when clicking the back button.
- Description: When filtering information on any page, clicking the back button will show the last search criteria used.
- For example, from the Accounts page, you can filter player information, select a player to see their details page, and then click the back button–the original search criteria will be used.
- If a page is opened through a shared link, clicking the back button will return a page without any saved search criteria.
- Portal: Amounts of stackable items in player inventories can now be modified.
- Description: Visit Player Support > Players and select a player, then click Inventory. Select a stackable item name, then Edit Item to modify the Amount field.
- Note that if an item is not set to be removed at 0 in the content catalog, it will remain in the table with the amount of 0. Otherwise, it will be removed from the table.
- Portal: Improved JSON validation error messages.
- Description: New targeted JSON validation messages are now available in Portal. These messages can be clicked, causing the editor to scroll and select the relevant line.
- Unreal users no longer need to write SDK boilerplate for custom services RPC APIs.
- Description: Unreal raw service code is now automatically generated based on protobuf RPCs. These classes can be found under the generated
Public/Dto
folder after runningmake gen-sdk-types-unreal4
. - Related note: See integration note for steps required to enable this feature and guidelines for keeping any handwritten raw services.
Social → RPC Operator → Account → GetPragmaPlayerOverviewsOperatorV1
- Description: Unreal raw service code is now automatically generated based on protobuf RPCs. These classes can be found under the generated
Deprecations #
- Replace
ReportCapacityUntilMatchAllocated
withStartReportCapacityPolling
. Note that the order of theReportCapacityTimeout
argument and callback (the last 2 arguments) needs to be reversed.- Description: This change will make sure that
ReportCapacity
continues to poll even after finding a match.Original Replacement Removal Patch ReportCapacityUntilMatchAllocated
StartReportCapacityPolling
0.0.77
- Description: This change will make sure that
Integrations #
- Portal: If you’re using the current
redirectSigninToSocial
default (true
), you will need to add a config flag, as the default has changed.- Description: We’ve changed Portal’s default for
redirectSigninToSocial
tofalse
to avoid hostname issues with providers like Discord. If you’re currently using the redirect default, you’ll need to add a config flag. - Integration step:
- If you’re using the current redirect default, you will need to add this config flag:
pluginConfigs: GameOperatorGatewayNodeService.portalPlugin: class: "pragma.gateway.FilePortalModulePlugin" config: redirectSignInToSocial: true
- Description: We’ve changed Portal’s default for
- Unreal: Configure the game server SDK to use HTTP, and specify Social backend in RPC files for automatic generation. Make sure any handwritten raw services have unique class names.
- Description: To enable the new automatically generated SDK service code, you’ll need to set a new SDK config option and specify backend type for Social RPCs (otherwise it defaults to Game). If you’d rather continue using your own handwritten raw service code, you can continue to do so as long as class names are different.
- Integration steps:
- Automatic generation setup:
- Game Server only: Change SDK config option
ProtocolType
toHTTP
(defaults toWebSocket
). This can also be set via command line with-PragmaProtocolType="Http"
. - Add the following line at the top of
Rpc.proto
files for any Social backend RPCs to make sure code generation correctly identifies them:option (backend_type) = SOCIAL
;
- Game Server only: Change SDK config option
- Handwritten raw service integration:
- Confirm there are no conflicting file names with the new automatically generated files.
- Automatic generation setup:
- Related note: See Unreal automatic generation feature note above.
Bugs and Fixes #
- Unreal payloads >2048 characters are now truncated in
Verbose
. They will still be full length inVeryVerbose
.
Docs #
- [Updated User Guide] Updated Crafting guide to reflect changes in various interfaces.
- [Updated User Guide] Updated Crafting: Time-based guide to reflect changes in various interfaces.
- [Updated User Guide] Updated Items guide to reflect changes in various interfaces.