Editor Versions

Separated out the pubnub text chat integration into the M2Extra

What’s broken and why?

The pubnub chat system has been moved fully into M2Extras_PubnubChat, and is not being used in the Morpheus Platform classes. This is because the pubnub authentication is being dropped by the web platform. The authentication flow we are moving into M2Deprecated, and removing references to them in our example content.

The outline of the changes done is as follows:

• BMPC_TextChatComponent - moved to M2Deprecated

• A similar component: BPMC_Pubnub_TextChatComponent has been added to the M2Extras_PubnubChat plugin. This has all the “send messages through BP_M2_PubnubConnection logic, but has a stub for users to add their own pubnub auth.

• The WebPlatform logic in the M2Extras_PubnubChat has been moved into M2Deprecated (e.g. BP_M2_SocialWorldService)

• BPMC_M2Example_TextChatComponent - removed the UsingPubnubChat - now it will only use the local flow, and not refer to the BPMC_TextChatComponent

The main noticeable effect of this would be that if you were using BPMC_M2Example_TextChatComponent, but had UsingPubnubChat checked, that flow will now not work - you will default to the Unreal chat flow.

How to fix it?

Please switch to using the Unreal-based text chat https://docs.msquared.io/creation/unreal-development/features-and-tutorials/communication/unreal-text-chat. This should handle most in-game text chat requirements. If you need an external chat system like pubnub, please reach out to a support engineer. We have some docs on how to use the M2Extra as a starting point here: https://docs.msquared.io/creation/unreal-development/features-and-tutorials/communication/text-chat

How to test it?

Try using text chat as intended by your experience. If you have a web based text chat, things may have been affected.

Deprecated the (JM) bootflow subsystem functions (plus some others)

What’s broken and why?

We have marked the following bootflow functions as deprecated:

• HandleAuthActorSpawned (JM)

• HandleAuthPawnSpawned (JM)

• GetAuthActor (JM)

We have also deprecated some other helpers:

• GetM2HUD

• Download Image (With Cache)

Therefore, any usage in your code will result in compiler warnings.

How to fix it?

Please use the advised alternative functions instead. These use the more generic base class MorpheusPawnActor. If you truly need the logic to use the deprecated JM_CharacterBase, you can cast the result.

Removed “UISkin” as a default Primary Asset Type to be scanned

What’s broken and why?

We have removed some references to our legacy UI Skinning system in our BaseGame.ini file, as the feature is due for deprecation and removal, and the default skin has already been deprecated. Without these lines, customers still using the legacy system will not be able to get past initial bootflow in their experiences without following the fix steps.

How to fix it?

To fix this you will need to go to Project settings > Asset Manager and find the UISkin entry at the bottom of the list of Primary Asset Types to Scan. You will then need to close and re-open the editor so the asset manager scans the appropriate directories.

Once this is done, launch the editor and go to Project Settings > M2 UI Skins and enable the Legacy Skinning System. Ensure your default skin is set, this will either be PDA_Skin_Origin (the previous M2 default) or something you have created project-side.

This will only continue to work while we still ship the M2 Deprecated plugin which we plan to eventually retire. We also plan to officially deprecate the functionality of the Legacy in the near future, so it is advised customers that require UI Skinning migrate onto the M2 Extras Skinning System.

How to test it?

Check you’re able to boot into your world in PIE and see your UI.

Removed game mode override in ControlPanelsGym

What’s broken and why?

The game mode override for control panels test gym was a deprecated game mode that used the old “Origin” content. This has been removed.

How to fix it?

Copy the map into your project folder, then set the game mode override to BP_GameMode (in M2 Deprecated).

Long term we plan to drop all support of control panels and the BP_GameMode uses a character with a soon to be deprecated Roles component, so our advice is to not use this and to build your own Control Panel test content if needed, as this can no longer be relied on long term.

How to test it?

Check that the roles related content works in the test gym.

Deprecated User Collections and Purchaseable systems

What’s broken and why?

The following systems have been deprecated, along with any of their functionality:

• User Collections

• Purchasing/Transactions/Wallets

• Avatar Editor

This is in line with the upcoming removal of the User Collections system from the web platform, at which point these Unreal APIs will stop functioning.

How to fix it?

If you need these systems, or encounter any compilation warnings as a result of these systems being deprecated, please reach out to your support engineer. Our intention is to not support these systems going forwards, so you will need to migrate off of these, onto other equivalents

How to test it?

Your game should build fine, with no additional compiler warnings.

Simplified BPMC_M2Example_CrowdAudioComponent

What’s broken and why?

We have cleaned up the example crowd audio implementation (BPMC_M2Example_CrowdAudioComponent) so that it no longer copies across all the functions from the deprecated BPMC_CrowdAudio. These functions were not used by example content, so would only break if the functionality was used in a downstream project that is attempting to use the deprecated functionality.

The main changes of note:

• The old functions to enable/disable voice e.g. InformMicrophoneButtonPressed/Released, SetPushToTalkMode, StartLoudspeakerRequest etc. have been removed. Instead we use the base CrowdAudioComponent's functions directly, e.g. SetVoiceInputEnabled. We no longer support both push to talk and toggle. We only have push to talk in our default UI, but toggle could be implemented in downstream logic via the SetVoiceInputEnabled function

• The “manually muted” logic has been removed, since it is unused

• The “choppiness detection” logic has been removed, since it is unused

• The GetCanUseVoice logic based on capabilities and moderation has been removed, but could be reimplemented downstream in the simplified CanUseVoice function.

How to fix it?

Any deprecated logic that is depended on should be fixed up, either by writing equivalents in project code, or switching the functions used.

If the deprecated functions are definitely needed in the downstream project, the deprecated BPMC_CrowdAudio is still present, and can be used as an off-ramp.

How to test it?

PIE - if there are any compile errors relating to usage of BPMC_M2Example_CrowdAudioComponent, they will need to be cleaned up.

Deprecated functions in M2M_PartyComponent

What’s broken and why?

Previously we had messaged that we were dropping support for parties in Unreal, but had not actively deprecated the functions used by BPMC_PartyComponent . That has been handled now, meaning BPMC_PartyComponent or any other class using functions from M2M_PartyComponent will give a compiler warning in Blueprints. The Unreal-to-web party functionality was deprecated and removed several versions ago leaving only basic party management which is implementable by anyone with Unreal experience.

How to fix it?

Firstly you need to remove BPMC_PartyComponent from any characters you wish to continue using. Then you will need to create a new party system to use in it’s place if this functionality is desired.

If you are unsure of how to build a party system, please reach out to your support engineer for guidance. We also have documentation on how to use broadcasting channels to allow users to voice chat with specific users, which can help build a “party chat” system https://docs.msquared.io/creation/unreal-development/features-and-tutorials/spatial-audio#broadcast-channels

Live config functions and console commands renamed (no longer JunoGameData)

What’s broken and why?

Nothing broken, just a callout: The live config helpers and console commands have been renamed, to get rid of the out of date Juno Game Data name. The following renames have happened:

• Console commands: JunoGameData.GetValue/SetValue,ClearOverride → M2.LiveConfig.GetValue/SetValue,ClearOverride

• GetGameDataAttributeValueAsString/Integer/etc. → GetLiveConfigValueAsString/Integer/etc.

How to fix it?

No changes necessary! The functions and console commands will all redirect, just be aware of the new names going forwards.

Launch Context removal from Live Config and Domain Configuration Subsystem

What’s broken and why?

Launch Contexts are not a user-facing concept and have been removed from the editor. The final change in this initiative is to remove LC from the domain configuration subsystem. This means content responding to the following live config variables will need to be changed:

• (deployment.json) Client.OverrideLaunchContextId.

Existing systems and APIs have already been updated to use World so in most cases, LC can be replaced with World usage.

Additionally, the following UProperties have been removed:

• (M2_UserDataStore) LaunchContextId.

• (M2_WorldConnectionApi) LaunchContextId.

• (M2_DomainConfigurationSubystem) LaunchContextId.

• (M2_DomainSettings) LaunchContextId.

How to fix it?

• Replace usages of Client.OverrideLaunchContextId with Client.OverrideWorldId

• Replace LaunchContextId UProperties with WorldId

Reach out to support if this does not resolve the issue.

How to test it?

• Check that the BPs recompile.

• Test that the system works as expected.

The boot-flow no longer blocks on having a player profile

What’s broken and why?

We are changing how user profiles work in MSquared. One part of this is that we are making the current user profiles system (the Profile Data Profiler class) optional, and so we no longer block in the boot-flow on the profile system loading a profile.

All existing MSquared logic is unaffected by this change, but there is a small chance that downstream project logic could encounter a race condition, if they attempt to get the profile early on in the bootflow (immediately after HandleBootflowStarted is satisfied), where they expect the profile to be ready, but it is not yet.

How to fix it?

If you have such logic, that expects the profile be ready early in the bootflow without checking (e.g. startup logic that happens before your character is spawned), it would be best to check that the profile is ready before attempting to use it. We have one such example implementation in BPMC_M2Example_PlayerNameComponent

How to test it?

Begin Play - all your custom logic that depends on the local player’s profile (e.g. find references to “profile data provider” in your codebase) should successfully get the profile when expected to.

Moved Carnival GetFromAssetId functions into UCarnivalWorldSubsystem

What’s broken and why?

Two static functions have been moved into a subsystem, to fix an issue with tracking meshes:

CarnivalSkeletalMesh::GetFromAssetId → CarnivalWorldSubsystem:: GetSkeletalMeshFromAssetId

UCarnivalStaticMesh::GetFromAssetId → CarnivalWorldSubsystem::GetStaticMeshFromAssetId

How to fix it?

Replace any calls to the GetFromAssetId functions with the corresponding on the CarnivalWorldSubsystem.

How to test it?

Blueprints will compile and function as before.

Removed LC from web platform utilities

What’s broken and why?

Requests made to the web platform now all use world context. Launch contexts have been phased out and launch context utilities have been removed.

Additionally, the enum value EM2_HttpRequestScope::LaunchContext has been removed.

How to fix it?

Replace the utilities and values that no longer exist:

• Get M2 Web Platform Launch Context ID > Get M2 Web Platform World ID

• EM2_HttpRequestScope::LaunchContext > EM2_HttpRequestScope::World

How to test it?

After making the replacements above, re-test your feature. If it still does not work, reach out to support.

Removed unused singletons from singletons list

What’s broken and why?

The following deprecated singleton classes have been removed from the named singletons list in the world settings:

• ActivityManagerClass (A deprecated system for tracking participants in “activities”, and loading appropriate sublevels)

• DataProviderSingletonClass (A system for providing data to UI that was never used)

• EffectManagerClass (A deprecated system for spawning gameplay effects, see uses of FAS_[X] assets or BP_[X]ApplicatorSettings)

• UserTagManagerClass

• PartyManagerClass

Before:

After:

In deprecating the user tags content, we have also removed the DT_M2_UserTags reference from the GameplayTagTableList, but this can easily be re-added downstream if needed:

How to fix it?

If you need any of the removed singleton classes, they can be re-added in your level using the AdditionalSingletons list:

How to test it?

Your gameplay systems should behave as before, with no additional warnings related to missing singletons/systems

Modified the GetJsonObjectAtLocation function

What’s broken and why?

The GetJsonObjectAtLocation function has had its nodes changed, so that instead of logging warnings and outputting a bool, it uses different execution pins for the assorted outcomes. This enables users to more clearly see the various failure cases and handle accordingly (instead of e.g. always warning if the object doesn’t exist, where it may actually be optional)

How to fix it?

Any nodes that fail to compile should be updated as in the screenshot above

How to test it?

Your logic should compile successfully.

Removed deprecated behaviors from BT_BotBehaviour

What’s broken and why?

The bot “roles” and “interact” behaviors have been removed from the BT_BotBehavior, since the functionality they were testing has been deprecated.

How to fix it?

If you referred to BT_BotBehavior and specifically want to test these two behaviors in your “full” behavior, you will need to add them manually to your Behavior Tree.

How to test it?

PIE - your BT should perform the behaviors you want it to.

Removed Launch Context from world travel structs

What’s broken and why?

Users will be unable to perform local PIE world travel when using deprecated world travel content (BPs and WBPs)

World travel structs no longer have a launch context field. As a result, the previous logic of attempting to use the launch context and falling back on the world or map has been replaced with logic where the world or map names are used directly.

This will have no effect for deployments and everything should work as expected even if using deprecated world travel content

How to fix it?

Use non-deprecated world travel engine content

How to test it?

Perform PIE world travel

Changed Carnival memory usage live config into a CVAR

What’s broken and why?

The Carnival.StreamClientTargetMaxInMemoryBytes live config value was used to specify how much crowd model data should be cached in memory. This has been changed to a scalability CVar r.CarnivalStreamClientMaxInMemoryMB so it can be set independently for different client hardware. The default value of 512 is the same as previously.

How to fix it?

If you’ve modified the Carnival.StreamClientTargetMaxInMemoryBytes live config default for your project you should instead add the CVar into your project’s <project>/Config/DefaultConsoleVariables.ini file with the same value. Example file contents:

[WorldBuilder]
r.CarnivalStreamClientMaxInMemoryMB=512

How to test it?

Crowd rendering should behave as before with the same memory usage.

Crash when using Movie Player on Mac native

We have identified a crash with Unreal Engine 5.5 when using movie playback on Mac native. The client will immediately crash when attempting to play a video.

We are currently investigating the issue and will provide a hotfix as soon as possible.

Missing Audio Component events

We have identified an issue with Unreal Engine 5.55 when it comes to playing audio components. After the world has initialized, the component's OnAudioPlaybackPercent and OnAudioFinished events stop playing (due to some internal failing when passing work between the audio thread and the game thread). So far we have not seen any other issues with the playing of audio, and the lack of these events can be worked around with tick behavior and delays based on the audio source's duration.

UX Subsystem delegates rename and function signature changes

What’s broken and why?

We have removed references to launch context from the World Builder UX Subsystem in favour of using world Id.

The following blueprint exposed functions, delegates and variables have been renamed:

• OnLaunchContextQueryHandled > OnWorldQueryHandled

• OnBeginLaunchContextImageDownload > OnBeginWorldImageDownload

• OnLaunchContextInfoUpdated > OnWorldInfoUpdated

• LaunchContextDescription > WorldDescription

• LaunchContextName > WorldName

• UpdateLaunchContextInfo > UpdateWorldInfo

The following function signatures have also been changed:

• UpdateWorldInfo

  • ➖ OrganizationId (FString)

  • ➖ ProjectId (FString)

  • ➖ LaunchContextId (FString)

  • ➕ WorldId (FString)

How to fix it?

Users should search for all occurrances of the old named functios, variables and delegates usage and resolve any blueprint compilation errors by making replacements according to the mapping above

How to test it?

You will know when your blueprints are compiling again

Removing SetAnimatedCrowdIsHidden function

What’s broken and why?

SetAnimatedCrowdIsHidden(...) blueprint callable function to locally check hidden status for crowd on a morpheus actor has been removed.

How to fix it?

Use the blueprint callable function SetHiddenLocally(...) of UMorpheusActorRenderTargetComponent

How to test it?

Calling SetHiddenLocally(...) and IsHiddenLocally() instead of UMorpheusActorRenderTargetComponent will change the local visibility of the morpheus actor, regardless of the render target.

Deleted Unused Loudspeaker Prop “BP_LoudspeakerVolume_VisualFeedback”

What’s broken and why?

The asset BP_LoudspeakerVolume_VisualFeedback.uasset has been removed from the M2 Example plugin as it contained multiple references to deprecated content and was overly complex as an example of using the global audio channel.

How to fix it?

If you require specific functionality from this prop, copy it into your project or use BP_LoudspeakerVolume_MicStand_VisualFeedback in M2 Deprecated.

Otherwise we have BP_LoudSpeaker_Example which can be found in the Example Map which is a more up to date and simplified example of how to implement this functionality.

Changing UserID Tracker Subsystem from a GameInstance subsystem to a World Subsystem

What’s broken and why?

The getter for the UserID Tracker Subsystem as a GameInstance Subsystem will no longer work.

How to fix it?

Change the getter for the UserID Tracker Subsystem to get it as a World Subsystem instead.

How to test it?

Ensure that the Get World Subsystem node returns the UserID tracker subsystem correctly and that the UserID Tracker Subsystem is tracking users as expected.

Removed unused Niagra System “NS_CombatTest_NDC_Beam”

What’s broken and why?

The “NS_CombatTest_NDC_Beam” particle system we were not using has been removed from our content.

How to fix it?

Duplicate the asset and fix up references if needed. If you have not created your own assets using our particles, it is highly unlikely this will affect you as there were not references to the asset in our codebase.

Removed unused PlayerController “BP_M2_PlayerController”

What’s broken and why?

Created and never used, this has been replaced by BP_M2Example_PlayerController in our example content.

How to fix it?

It is unlikely you will have referenced this asset, but if you have either duplicate this into project space before taking the update or re-base onto BP_M2Example_PlayerController .

How to test it?

Ensure functionality remains intact

Changed Launch Context as the pubnub channel name to World Id

What’s broken and why?

We have renamed the live config variables and default channel naming behaviour in order to use the worldId:

• Social.Chat.LaunchContextId → Social.Chat.World

• Social.Chat.LaunchContextSource → Social.Chat.WorldSource

• Social.Chat.Editor.LaunchContextId → Social.Chat.Editor.World

• Social.Chat.Editor.LaunchContextSource → Social.Chat.Editor.WorldSource

The pubnub channel will now be named <world Id> and will use the value found in the domain settings at runtime by default for both editor and deployments.

We recommend you use these settings unless you need to specify a specific channel name for use as it gates chat by the world that is being used and allows pubnub chat to be used in editor with no additional configuration.

The WorldSource (previously LaunchContextSource) options have been changed to:

• LiveConfig - Changeable at runtime for ALL players in a world

• CommandLine - Static at runtime and set when the client is launched

• Domain - (default) Changeable at runtime for each client

How to fix it?

If users have not previously modified the live config variables listed above in the following files then nothing needs to be done.

• M2LiveConfig/Config/deployment.schema.json - Check for var modifications

• <project>/Config/LiveConfig/Overrides/deployment.override.json - Check for var existence

If you have previously modified the live config variables, you will need to modify the WorldSource value to one of the below, depending on your usecase

• Empty or Domain - this will set the pubnub channel name to your local world ID. To use this, you must have "Use Local World in PIE" enabled in your editor's sign in settings

• LiveConfig - will grab the world value from live config (e.g. the one set at Social.Chat.Editor.World

• CommandLine - will grab the CLI launch arg worldId value (least likely to be used)

If any modifications have been made, please tranfer the values set in the old live config variables to each equivalent new variable according to the mapping above.

How to test it?

Launch a deployment or PIE and send a message. If the message is successfully sent the sender will see it appear in the chat widget and this has been successful.

Renamed the web platform world services

What’s broken and why?

We have renamed the MSquared world service classes, to better match our conventions:

• BP_M2_WPKeyValueStoreService → BP_M2_KVStoreService

• BP_M2_WPProfileDataProvider → BP_M2_ProfileDataProvider

• BP_M2_WPRoleDataProvider → BP_M2_RoleDataProvider

The references have been fixed up, and the world settings’ default config has been updated MSquared-side. However, If you modified the world service classes in your project’s own config, referencing the old names, they will need to be updated

How to fix it?

If you see missing classes in your world settings, check for the old file names in your project’s config and update them, or alternatively select the right files in the dropdown.

If you modified the world service classes in your project’s own config,

How to test it?

Go to your world settings, and search for “services”. The three named world services should still be present.

Flipped bCheckIfRolesDataTableIsValid to “false” by default

What’s broken and why?

This is unlikely to affect most projects. If you are still using the legacy Roles (now located in the Morpheus Platform - Deprecated|Roles section of our World Settings), which we deprecated in a previous release, you will find the default value of bCheckIfRolesDataTableIsValid has changed from True to False. This is because we no longer require this check in the currently supported Roles system and leaving this legacy setting enabled could cause confusion when warnings are given to customers using the new system.

How to fix it?

Go to Morpheus Platform - Deprecated|Roles in the affected map and change bCheckIfRolesDataTableIsValid to True.

How to test it?

Warning should be given if no Roles table provided

Disabled email-based fallback sign in

What’s broken and why?

Previously we were able to use multiple methods of signing in, but now the only accepted method of authentication is SSO. We had a widget that would pop up on failed sign in that would give the option to sign in with email or password. Now this option is not provided and if SSO fails, users will not be able to enter via alternative means.

How to fix it?

There is no fix for this. If this is required functionality, please reach out.

Replaced references to BPM_VideoScreen in BP_MillicastCapture

What’s broken and why?

Under Scene Capture > Show Only Actors in BP_MillicastCapture we no longer use BPM_VideoScreen, having replaced it with the non-deprecated BPM_VideoPlayer asset.

How to fix it?

If you use BPM_VideoScreen still, you will need to re-add this to your list of actors to be shown. This can be done on instances of your BP_MillicastCapture or a locally modifiable duplicate of this asset.

How to test it?

Confirm functionality remains as before.

Deprecated old “user data” and Key Value/persistence APIs

What’s broken and why?

The following systems have been deprecated, in favour of our single KV Store system (https://docs.msquared.io/creation/unreal-development/features-and-tutorials/online-services/kv-store-service):

• UserDataStore

• WebPlatformKeyValueStoreService (not to be confused with the still present M2_KeyValueStoreWorldService, renamed to M2_KVStoreService)

• M2_PersistenceSubsystem

  • Since we are no longer using this system, the now irrelevant bootflow steps HandleUserDataReady and HandleInitialValuesReceived have been deprecated too.

How to fix it?

Please move to the new system as soon as convenient. Your existing logic won’t break, but you will get compiler warnings, and you won’t be able to use the deprecated nodes past their current usage in your project.

If you were using the persistence subsystem, we have a guide for ease of migration: My project is using the now-deprecated Persistence Subsystem. How can I migrate across?

How to test it?

Your logic does not have compiler warnings for using the old systems

Changes to the KV Store implementation

What’s broken and why?

There have been a few changes to the example KV Store service (BP_M2_WPKeyValueStoreService) and its related files, that would require some attention, if it is currently being used:

• SM2_WP_KvStoreObject has been removed, and SM2_WP_KvStoreReadItem has been updated to treat the object as a generic Json Object.

  • This makes the struct more flexible, supporting other json value types, rather than just JsonObject for the fields within the object field, e.g. Data

  
• We now no longer reject “non-json” string values, instead treating them as “json string values”. e.g. a string Hello will now be treated as the json value "Hello", rather than being rejected.

  • This improves the UX for generic KVStore usage, enabling stores more akin to Store(”KeyName”, “ExampleValue”), rather than needing Store("KeyName", { "Value": "Examplevalue"})

How to fix it?

• If you referenced SM2_WP_KvStoreObject, or SM2_WP_KvStoreReadItem, please update your logic accordingly, e.g. by following the example in BP_M2_WPKeyValueStoreService::ParseReadResponseItem

• If your logic depended on non-json strings being rejected, please update the KVStoreServiceClass to a custom implementation of your choice, using BP_M2_WPKeyValueStoreService as a starting point

How to test it?

Everything should compile correctly

Example Moderation Component now uses Example Crowd Audio Component

What’s broken and why?

Previously BPMC_M2Example_ModerationComponent used our legacy Crowd Audio component (BPMC_CrowdAudio) when sending transcripts to a moderator. As we are simplifying the CrowdAudio component but want to leave the legacy version intact, we have replaced the reference here to BPMC_M2Example_CrowdAudioComponent .

How to fix it?

This issue will only affect users that are using BPMC_M2Example_ModerationComponent with a legacy character class, or that still use the BPMC_CrowdAudio .

If you use BPMC_CrowdAudio, you will need to duplicate BPMC_M2Example_ModerationComponent replace all references to BPMC_M2Example_CrowdAudioComponent with BPMC_CrowdAudio and then replace your moderation component with this duplicated and modified version.

It should be noted that we will not be maintaining BPMC_CrowdAudio any further, so if you want a higher level of support it is recommended you switch to the example component as the legacy one will be removed when the M2 Deprecated plugin is removed.

How to test it?

Ensure moderation functionality is maintained after following the above steps and you are still able to receive transcriptions.

Removed Interaction widget from Example HUD

What’s broken and why?

The Example HUD created when starting a new project from a template no longer features the deprecated Interaction widget. This will also affect anyone directly using the engine version of WBP_M2Example_HUD

How to fix it?

We highly recommend you do not use the M2 Interaction system as this is deprecated. If you are dependent on this and relied on it in this HUD, you will need to re-add the M2Deprecated/M2Core/M2ObjectInteraction/WBP_M2_FullInteractionMenu widget to your HUD

How to test it?

Ensure that desired interaction functionality is still present

Changed AutoProfiler SessionData Fields

What’s broken and why?

Previously, all ActorCommandExecutorTasks in the AutoProfiler SessionData would be called with the same optional parameter. This meant that Carnival would attempt to load avatars with the name of sublevels to load and the world would attempt to load a sublevel with an MML URL. Now the SessionData requires the specific task and parameter for each ActorCommandExecutorTask. The original “Optional Parameter” field has been removed in order to improve this.

How to fix it?

ActorCommandExecutorTasks in any AutoProfiler SessionData assets will need to be reconfigured by filling in the new fields.

How to test it?

The AutoProfiler should function as expected prior to this change and should not interfere with other ActorCommandExecutorTasks .

Removed the world travel portal from WorldTravelDestination_P

What’s broken and why?

The WorldTravelDestination_P test map has had its world travel portal removed. This is because it used the now deprecated interaction system, and the map has been updated to use the simplified character, which doesn’t use said system. This means that if you do try and access that world, you will not be able to world travel using the portal

How to fix it?

In the unlikely case that you were using WorldTravelDestination_P, you will need to use alternative approaches to world travel out of the map. e.g. instead of interacting with the world travel portal, you can instead use the WorldTravel.TravelToWorld [WorldId] console command

Removed Walk binding from IMC_CharacterMovement

What’s broken and why?

As we no longer have a walking animation in our default Animation Blueprint, we have removed the corresponding key binding

How to fix it?

You will need to use an Input Mapping Context in your project that maps IA_CharacterWalk to an input (previously the Ctrl keyboard button)

How to test it?

Implement the above and ensure character moves as expected when button is used

Get BPCharacter removed from ABP_M2_Human.uasset

What’s broken and why?

The function “Get BPCharacter” in ABP_M2_Human is no longer available. It has been removed as there are no references to it within the Morpheus Platform and it’s presence creates a dependency on deprecated content.

How to fix it?

If you rely on this within the default ABP you can either duplicate the asset to preserve your current version, or duplicate the new version and add the following:

Please not that due to the lack of Child ABP’s, duplicating this asset means you will have to repeat this any time you wish to take further ABP updates from our default class.

How to test it?

Follow the steps above if applicable and ensure functionality is consistent.

Analytics BP API Removed

What’s broken and why?

Analytics API that was deprecated in v34 has now been removed in full. Please see the release notes on v34 for further information.

How to fix it?

Customers are expected to replace any usage of this API with their own analytics integration. See https://docs.msquared.io/integrations/3rd-party-analytics#setting-up-mixpanel-analytics for an example integration.

M2 Human ABP simplified and multiple states removed

What’s broken and why?

The base ABP for M2 projects, ABP_M2_Human, has been reworked, resulting in a more streamlined ABP with improved combat animations using assets from Lyra and less custom M2 behaviour overall.

The following functionality has been removed from the ABP:

• Double jump

• Walking

• Launch

• Low gravity

• Bounce

• Zero G

• Non-combat head turning

• Multiple random idle animations

The old ABP is now ABP_M2_Human_Old in the Deprecated plugin.

How to fix it?

If your project relied on the above removed animation behaviour, you can temporarily set your characters to use the ABP_M2_Human_Old ABP (in the Deprecated plugin) instead. This will be removed in a future release, so if you rely on this behaviour, we recommend copying the logic you rely on from this old ABP to your own ABP class.

How to test it?

Test all your gameplay and observe whether the animations are behaving as expected.

Check replicability of blueprint properties at compile time

What’s broken and why?

In the blueprint editor, it’s possible but erroneous to mark an Event Dispatcher as “Replicated”. That causes an Ensure to fire in PIE, and maybe in standalone.

This change makes that mistake visible by introducing a blueprint compile error.

How to fix it?

Disable replication for Event Dispatchers in blueprints.

How to test it?

Only affects blueprint compilation - if everything cooks then all is well.

Removed AudioControls and AudioMixManager from default Singletons

What’s broken and why?

The Audio Controls Class and Audio Mix Manager Class is no longer present in the default Singletons list in World Settings. This is because we are deprecating the BP content used for these.

How to fix it?

You will need to add BPM_AudioControls and BPM_M2_Audio_MixManager as additional singletons to your World Settings for any map you intend to use these in.

How to test it?

Ensure your world still has access to this functionality after adding them manually.

Crowd audio changes to schema and removal of echo cancellation and dynamic occlusion

What’s broken and why?

• Echo Cancellation has been removed as an option from crowd audio settings.

• Dynamic Occlusion has been removed as an option from crowd audio settings.

• PreprocessorSettings has been split into NoiseSettings and VolumeNormalisationSettings.

• Some ObserverSettings have been separated into OcclusionSettings.

• Some parameters have changed their category in LiveConfig.

How to fix it?

Echo cancellation and dynamic occlusion are no longer supported features. It’s unlikely your project was using them in a noticeable way, but if they were, please reach out to @Samuel Silvester.

If your project has any live config overrides to crowd audio settings, check the latest morpheus.schema.json to make sure your live config overrides still match the schema. Make sure that your editor sessions run without any schema warnings or errors, or your live config overrides will not be respected.

If your project has modified any crowd audio settings in BPs, double check to make sure these are still applied correctly.

How to test it?

Run editor sessions and ensure no live config errors or warnings are output.

Ensure that the crowd audio in your world is still functioning as intended.

Observer Control singletons no longer default M2 Singletons

What’s broken and why?

As we move to turning off the M2 Deprecated plugin by default, we are removing dependencies on legacy content. Our Observer role is scheduled to be simplified, but currently it is tied to the legacy classes which means it cannot be a default singleton. Specifically the control panels often used in this mode will not be available and you will see the following logs:

LogBlueprintUserMessages: [BP_ObserverPawn_C_0] Observer Camera Control Panel isn't present in the level! Keybinding will not work.

LogBlueprintUserMessages: [BP_ObserverPawn_C_0] Observer HUD Control Panel isn't present in the level! Keybinding will not work.

How to fix it?

The following needs to be done for any map in which you want to use the Observer role.

1. Navigate to World Settings

2. Search for Additional Singletons

3. Add the required Singletons

   1. BPM_ObserverCameraControls

   2. BPM_ObserverHUDControls

How to test it?

Ensure Observer functions as expected.

USkeletalCrowdMeshStore removed

What’s broken and why?

USkeletalCrowdMeshStore and UJ_ModularCrowdMeshStore types have been removed.

These were previously optional but deprecated. This change removes support for them in an effort to clean up and simplify the USkeletalAnimatedCrowdData.

USkeletalAnimatedCrowdData::DefaultMeshIndices has also been removed. It was generally unused and no longer makes sense in context.

How to fix it?

Any existing mesh store assets should now be deleted.

USkeletalAnimatedCrowdData data assets will need updating to specify the USkeleton used by the crowd, if this hasn’t been done already. See below:

How to test it?

Test that crowd continues to work as before.

Network Level callbacks renamed to Net Relevancy

What’s broken and why?

The OnNetworkLevelChanged callback has been renamed OnNetRelevancyLevelChanged.

The NetworkLevel struct has been renamed NetRelevancyLevel.

How to fix it?

There are core redirectors so these renames will be automatically be applied in your project, but you should use the new names where possible.

How to test it?

Project compiles.

Made the example map use simplified base classes (e.g. M2M_CharacterBase instead of JM_CharacterBase)

What’s broken and why?

As part of our planned simplification work, we are cleaning up the logic in our Example content, removing deprecated features and providing simplified alternatives to core/example features that we are cleaning up.

We have now reparented the example content to new base classes (e.g. M2M_CharacterBase, instead of JM_CharacterBase, where the former is a parent of the latter). This means that a bunch of the logic added at the JM_CharacterBase level or below has been removed.

This includes:

• Character resizing (awaiting simplification)

• Roles (awaiting simplification)

• Capabilities (can be re-added in downstream projects if desired)

• Out of bounds auto-respawning (awaiting simplification)

• Camera zoom

• Approachability movement (click to move, etc.)

• Sliding & bounce components

• Motion warping

• motion capture

• traversals

• over-the-shoulder/topdown cameras

• "inhibitor component"/Player capture component

• Interaction

• focus cam

• Inventory/equipment

• deprecated chat

• Ability system

• debug command component (looks unused, part of the old live config system?)

If you are using the deprecated character (e.g. basing your character off of BPM_Origin_PlayerCharacter, or accessing the JM_CharacterBase directly), there should be no changes. If you are basing your character off of e.g. BPM_M2Example_PlayerCharacter, some functionality will have been removed.

How to fix it?

If you depend on any of the features removed, get in touch - the features will either be re-added in due time, or are not being supported by MSquared. If any are absolutely essential to your project, you can fall back to using the deprecated Origin classes for now, but this is not advised in the long run.

How to test it?

Review the removed features, check your core functionality is still as expected.

Deprecation of Juno/M2 Activities and Venue_Orb Map

What’s broken and why?

The legacy Activities system has been deprecated. This was used extensively in the Venue_Orb map. The blueprint facing API has been deprecated and all assets referencing these functions have either been deleted or modified to remove the references, depending on complexity of their connection to this system.

Areas of note:

• Venue_Orb_P

  • Removed entirely

• BP_PlayerController

  • References to Activity widget removed

• BP_OrbUtility

  • Handle teleport logic removed

• BPM_FadeToBack

  • No longer gated behind a capability that was previously removed from the platform (Capabilities.ActivityControls)

• For a full list of affected classes, please refer to ActivityDeprecationCodeChanges.txt

• For a full list of affected assets, please refer to ActivityDeprecationChanges.txt

If you have content that was built on the Activities API, you will find the deprecation warnings will cause a warning at compile time for your blueprints. If you use our asset linter, assets using this API will fail the linting rules due to these warnings.

How to fix it?

The general advice here is to remove all references to this system ahead of taking this update. Soon we will remove this functionality altogether, which means anything that is still using it will break entirely.

If you are unsure as to whether or not you have used this, you can do a dry run on taking this update and see if there are any new warnings created when linting your content.

If there are warnings and you are not yet ready to remove the content, you can get the linter to ignore these for the time being. To do this, you’ll need to ensure your linting rules use a modified version of JLR_BP_Compiles and you need to add the specific strings to be ignored in the “Allowed Blueprint Warnings Regex” array. This will not work once we fully remove the underlying C++, so please plan accordingly.

If your project relies on any content removed as part of this process, you will need to create duplicates of the affected assets and keep them in project-space to avoid unwanted changes. If these assets inherit from Activity related classes, you must anticipate that these classes will also be removed in the near future.

How to test it?

Check all affected content works as expected.

Performance regression at 18K CCU on Windows native

We are currently investigating a performance regression which was identified during our scale tests using 18000 bots when using an AMD Ryzen 9 5900X / NVIDIA GeForce RTX 3080 device.

This results on framerates of ~20FPS, rather than our 30FPS target.

Unreal D3D12 Memory Leak in cooked clients if minimised

It was observed that if you minimize the game client, it may eventually crash. The resulting callstack may vary, with one observed example being:

[2025.03.26-08.26.30:297][400]LogD3D12RHI: OnlineHeap RollOver Detected. Increase the heap size to prevent creation of additional heaps
[2025.03.26-08.26.30:398][406]LogD3D12RHI: Error: Interfaces.CopyCommandList->Close() failed 
 at C:\b\Game\Engine\Source\Runtime\D3D12RHI\Private\D3D12CommandList.cpp:284 
 with error E_OUTOFMEMORY

Ahead of such crashes, it is clear that memory is leaking, by observing logs along the lines of [2025.03.27-09.26.37:982][760]LogJunoMetrics: Process memory high water mark: 17554MB physical, 22196MB virtual. Until this is fixed, we recommend advising users to not minimize their game window.

SkeletalCrowd supports dynamic addition of meshes at runtime

What’s broken and why?

• SkeletalCrowdMeshStore mesh list is now ignored - meshes are now processed and useable by SkeletalCrowdComponent on demand at runtime. This shouldn’t break anything, but may mean processing of meshes is happening at a different time in the fame.

• This change in turn has simplified a lot of setup required to get meshes added during BeginPlay, and means we can remove the ISkeletalCrowdMeshProviderInterface and all uses of it

• All code related to avatars and attachments has been updated to handle this

How to fix it?

ISkeletalCrowdMeshProviderInterface is removed. If code/BP was previously using this it can now be removed. When creating an FAnimatedCrowdMemberInitializer using one of these (formerly) provided meshes:

• For skeletal meshes there is nothing to do

• For static meshes, previously the crowd got its attachment information from the mesh store data, which in turn was supplied from the mesh provider interface. This no longer exists. Therefore it must be passed in using the new StaticMeshSocket and StaticMeshTransform members on the FAnimatedCrowdMemberInitializer .

Similarly, CharacterAssetComponent’s AddedCrowdStaticMeshesOverride array has changed type. It is no longer a list of static meshes, but a list of M2_StaticMeshAttachment types (including socket, transform and custom data as well). Code / BP usage of this array will need fixing up, or ideally, changing to use the AddAttachment function which is the preferred path.

Carnival Model Component

What’s broken and why?

Blueprint functions to manually add and remove carnival meshes.

How to fix it?

To manually add a mesh (e.g. attachment) to a Carnival model, you can use the UJ_ModularCharacterComponent as usual.

How to test it?

Carnival characters and attachments should work as usual.

Made the example map use new simplified character classes

What’s broken and why?

The base classes used by the example map, and the example plugin have been reparented, so that they use less of the deprecated content (e.g. the interaction system). The example map’s functionality should remain largely unchanged, but any classes extending off the M2Example bases that depend on features in M2Deprecated may not work.

The changes to the example content are as follows:

• The ExampleMap now uses its own BP_M2Example_BotBehaviorStore, instead of the default one

  • This uses a different chat behavior

• WBP_M2Example_TextChat has been retargeted to use the BPMC_M2Example_TextChatComponent instead of the deprecated text chat component. If you are using this widget without using the other example classes, this may fail.

• BPM_Example_PlayerCharacter has been reparented to a simplified base class. This removes some functionality, such as the deprecated interaction system

• BP_Example_PlayerCharacter has been reparented to BP_M2_PlayerCharacter. This replaces some features, such as nameplates, and removes some deprecated functionality

NOTE: This change does not affect users exclusively using the content in M2Deprecated, e.g. WBP_Origin_HUD and BP_Origin_PlayerCharacter, only those using content in the M2Example plugin.

How to fix it?

If you have assets extending example content, but that depends on deprecated content, you will need to either migrate away from using the deprecated content, or reparent your assets onto the deprecated base classes, e.g. BP_Origin_PlayerCharacter.

How to test it?

Check whether your core classes extend any of the following:

• BP_M2_PlayerCharacter

• BP_Example_PlayerCharacter

• BPM_Example_PlayerCharacter

And check whether your UI includes WBP_M2Example_TextChat. If these are true, you may need to update their usage, if there are any compile errors, or deprecated features stop working.

Made M2_WorldBuilderUXSubsystem::bUpdateRequired read only

What’s broken and why?

UpdateRequired was previously BlueprintReadWrite, but is not intended to be modified externally in blueprints. It has therefore now been made BlueprintReadOnly. Any downstream uses where it was set should be removed.

Change to Persistence Subsystem Read Query

What’s broken and why?

The response after reading from the KVStore has been minorly adapted to also return information about whether a key exists within the store. Instead of a map of key and value strings, it’s replaced with a struct that also contains a success boolean that indicates whether that key exists.

This means that the On Persistent Value Query Complete delegate will execute for both successfully found keys and non-successfully found keys.

How to fix it?

If you’re relying on the above delegate to execute only for successfully found keys, you will need to use Get Session Value String in your custom event to add an additional check for whether the key exists or not, before continuing with any logic.

How to test it?

Persistence systems should operate as normal.

BP facing Analytics API removed

What’s broken and why?

The following analytic events have been removed from Blueprints

• BPC_ApproachabilityMovement

  • Removed event control_interactions_tracked

    • In function “Process Tap”

• BP_WBL_WaitingPawn

  • Removed event download_launch_context_image_finish

    • After event “Download On Url Received”

• BP_ItemExecutor_LoudspeakerDevice

  • Removed event loudspeaker_request_event

    • In functions “Turn Off Loudspeaker” and “Turn On Loudspeaker”

• BPM_VideoScreen

  • Removed event Exit Screen Interaction option

    • In event “On Button Option Requested”

• BPMC_CrowdAudio

  • Removed event loudspeaker_change_event

    • In functions “Start Loudspeaker Request” and “Stop Loudspeaker Request”

• BP_AvatarEditorActor

  • Removed event avatar_editor_opened

    • In event “OnAvatarInitialized”

  • Removed event avatar_editor_closed

    • In event “DoneButton”

• BP_LaunchPad

  • Removed event launchpad_jump

    • In function "Jump"

• BP_ItemExecutor_Ping_LocationSelector

  • Removed event ping_ability_used

    • In event "HandleLocationSelected"

• BP_ItemExecutor_Silencer_PlayerSelector

  • Removed event silencer_event

    • In function "Apply to Selected"

• BP_LoudspeakerVolume_MicStand

  • Removed event loudspeaker_request_event

    • In function "Enable Loudspeaker"

    • In function "Disable Loudspeaker"

• WBP_EmoteSelector

  • Removed event menu_opened

    • In event "Event notify Activated"

  • Removed event menu_closed

    • In event "Event Notify Deactivated"

• BPC_MovementAnalyticsComponent

  • Deleted entire component, removing several events

    • heartbeat_location

    • xyz_movement

    • xy_movement

  • Component will no longer be present on BP_M2_PlayerCharacterBase or it’s children

How to fix it?

To implement your own Analytics, please refer to this guide: https://docs.msquared.io/integrations/3rd-party-analytics#setting-up-mixpanel-analytics

To preserve the analytics listed above and the associated logic, duplicates of the affected assets need to be made before upgrading to this version, and the analytics called replaced with the appropriate call to the implemented analytics system of your choosing.

How to test it?

Ensure that analytics are captured for the events required.

Change Morpheus terminology to use "split authority" and remove the term “net ownership”

What’s broken and why?

SpawnMorpheusActorWithClientAuthority has been deprecated and replaced with SpawnMorpheusActorWithSplitAuthority.

GetOwningClientConnection has been deprecated and replaced with GetAuthoritativeClientConnection.

The SpawnMorpheusActorWithClientAuthority function was misleading, since the spawned actor is still largely server authoritative. “Split authority” is being adopted as more accurate terminology.

“Owning client connection” in Morpheus is identical to “authoritative client connection”, so we’re removing this terminology entirely to simplify Morpheus.

How to fix it?

Replace all instances in BP code of SpawnMorpheusActorWithClientAuthority with SpawnMorpheusActorWithSplitAuthority and GetOwningClientConnection with GetAuthoritativeClientConnection.

How to test it?

Ensure your Blueprints all compile.

Modified M2 Extras: Skins System

What’s broken and why?

• Some functions and classes have been modified in the M2 Extras: Skins System

  • ListenToSkinUpdates now takes a delegate called OnSkinUpdated, rather than OnConditionMet.

  • The GetSettingByClass helper takes specifically M2_InstancedObject classes, not any Object

    
  • These should be fixable by checking for any compile errors in any downstream logic that uses these functions, and reconnecting the pins.

How to test it?

If you are using M2 Extras: Skins System, there may be compile errors. If there are though, they should be simple to fix.

Removed Scale Test related Level Instances

What’s broken and why?

All Level Instances used in ScaleTestMap_Surround_Example have been broken down into the assets that composed them, with the Level Instances then being deleted.

How to fix it?

If these instances have been used elsewhere in your project, please copy the following assets out of the engine and into your project, then fix references to point to the new copies:

M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Gameplay01.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Gameplay02.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Gameplay03.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_PyramidVenue.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Rocks01.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Screens01.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Screens02.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_SetDressing_Aa.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_StadiumLights01.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Structures_Aa.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Structures_Ab.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Structures_Ba.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Structures_Ca.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Structures_Cb.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Walkways_Aa.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Walkways_Ab.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Walkways_Ac.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Walkways_Ad.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Walkways_Ae.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Walkways_Ba.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Walkways_Bb.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Walkways_Bc.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Walkways_Bd.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Walkways_Be.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Walkways_Bf.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Walkways_Bg.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Walkways_Bh.umap M2Unreal/M2Example/Content/Maps/SubLevels/Maps_LevelInstances/LI_Nexus_Walkways_Bi.umap

How to test it?

Ensure the Level Instances you have used still appear as they did previously.

Parallel delegates for background high frequency events removed from Blueprints

What’s broken and why?

In the combat helper classes, the parallel versions of the background high frequency events (ShootableComponent::OnHitReceivedBackgroundParallel and CombatComponent::OnShotFiredBackgroundParallel) have been make inaccessible to Blueprints.

The OnHighFrequencyEventReceivedParallel parameter in the BP initialiser for background high frequency events UBackgroundHighFrequencyEventLibrary::InitializeBackgroundHighFrequencyEvent has been removed, and the bUseNonParallelDelegates argument is removed with it.

This is because it’s impractical to write thread-safe code from Blueprints. Using them from BPs often resulted in clients crashing, and faulty BP code should never cause a client crash.

How to fix it?

If any functionality is bound to the above events, move the functionality to the non-parallel versions of the delegates instead.

How to test it?

Check that your OnHitReceived, OnShotFired, and any other custom background high frequency event behaviour continues to work as usual.

M2Extras: Widget Handler moved into M2Example, as “UI Mode Helpers”

What’s broken and why?

The old “M2Extras: Widget Handler” plugin has been removed, in favor of the same functionality in M2Example, now that it is being used in our example UI setup. If you relied on the old helpers, you will need to migrate them over.

How to fix it?

Any uses of the old BPFL_WidgetHandler methods will need updating to the BPFL_UIModeHelpers equivalents:

• MarkWidgetNeedsUIMode has been replaced with RequestUIMode

• UnmarkWidgetNeedsUIMode has been replaced with ReleaseUIModeRequest

• HandleUIModeChangeRequest has been replaced with BindToUIModeChangeRequests

How to test it?

If you have no compile errors, you should be good to go!

You cannot World Travel to the same map

If you attempt to world travel between worlds that use the same map, it will currently fail, giving LogWorldTravel: Error: Cannot use world builder world travel to travel between the same map '/Game/ExampleMap'.

We are looking into enabling this flow, and will update this in an upcoming release

"Mesh Reproduction Sprite" Niagara systems unsupported on Carnival

Making particle systems that track the character's mesh (e.g. following the tutorial outlined here: https://youtu.be/5yI6FU-6Jzo?t=499) will not currently work with carnival actors. This means that non-auth characters using MML avatars (including LOD0) will not be able to display such particle effects.

Some M2 assets fail to package correctly

NOTE: This has been fixed in hotfix v33.0.2 - if this change impacts you, please upgrade to the hotfix!

A small number of assets currently fail to package within WB projects due to some failing Unreal redirector logic. Assets that fail to resolve will log within the Unreal process:

LogStreaming: Error: CreateExport: <path> - Could not find class object for <classname>
LogStreaming: Warning: Missing Dependency, missing package import 0x110000000C for package <path>

You can workaround this temporarily by copying the M2 asset to your project locally, and referencing that version instead. This will affect functionality such as control panels

Cancelled value added to EM2_HttpResponseStatus

Affected Features: Http

What’s broken and why?

We have added a new “Cancelled” status to the EM2_HttpResponseStatus enum. Whilst this in itself is not breaking, users me be using the “Switch” block in blueprint to handle the http results.

If this is the case, the addition of the new Cancelled status will result in an unmapped pin, which may cause your blueprint to not handle the case of cancelled requests. This would only happen if you explicitly cancel a request.

How to fix it?

You have two options:

1. If you are using the enum and mapping all but the “OK” pin to a failure state, you should swap to using an Equals “OK” and branch node.

1. If you still wish to use the switch, you must map this to your cancellation handler (or failure case)

How to test it?

Check your http requests are handling the responses you expect.

World Builder settings migration

Affected Features: World Builder

What’s broken and why?

We’ve migrated some settings from DefaultEditorPerProjectUserSettings.ini to DefaultGame.ini. Nothing will break, but some steps are provided to avoid this causing issues with version control.

How to fix it?

We migrate the settings automatically.

If you’re using a version control system, you’ll need to submit the modified Config/DefaultGame.ini as part of the upgrade.

How to test it?

Navigate to Project Settings -> M2 World Builder and ensure your old settings e.g. Mod Id and Maps are still present:

Crowd Animation blend support

Affected Features: CrowdAnimBlueprint, SkeletalCrowd

What’s broken and why?

Nothing should be broken. In order to support blend nodes within crowd ABP, this change contains some very fundamental modifications to how crowd animations are running, and as such projects should double check crowd animations are working as expected.

How to test it?

Crowd members should be animating as they used to before the change, precisely what this means will depend on the project.

Pubnub-based Chat simplification

Affected Features: Social (Chat)

What’s broken and why?

As part of the Pubnub-based text chat simplification process, we have ported the chat from C++ to Blueprint to allow customers to take control of the implementation. As a result of this, there is one change that must be addressed when taking this version of MSquared.

In order to continue using the current version of text chat you must add the ps.pndsn.com domain to your Developer Dashboard url allow list settings for the Client. See the next section for details.

Secondly, we have removed the “announcements” support. This feature was not used by any projects as so there should be no project impact.

Additionally, the “Fetch Channel History” function on the UM2_TextChatComponent has changed signature from having a delegate passed in, to using a broadcast delegate for all history messages. This is due to the function implementation being moved from C++ to Blueprint. This should only be impactful if you have implemented a custom chat UI.

How to fix it?

To add the ps.pndsn.comas an allowed domain, you must:

1. Navigate to your developer dashboard

2. Select the Admin tab

3. Select External Urls

4. Expand the Client section

5. Set "External Url Access" section to "Allow content to access only URLs with specified domains"

6. Click “+ Add Domain”

7. Add "ps.pndsn.com" to the new entry

8. Click Update to save the setting

If your chat UI is using the announcement messages feature of the M2_TextChatComponent; then it is recommended you begin removing the use of it, as in the future the functions will be removed.

When binding Fetch Channel History, you should now bind to the broadcast delegate “On Chat History Message Received” delegate to continue receiving the historical responses.

How to test it?

General chat should function as normal; minus the ability to receive announcement messages.

• Check your history messages still appear

• Check you can still send and receive normal chat messages

Cleaned up/consolidated excess DT Roles tables

Affected Features: Roles

What’s broken and why?

The following data tables have been removed:

• DT_ApproachabilityGym_Roles

• DT_FeatureTestGym_Roles

• DT_NexusRoles

• DT_QARoles

• DT_RolesExampleMap

• DT_RolesScaleTestMap

Any uses of them internally have been replaced with our default DT_RolesExample.

The example roles table has also had some changes to it:

• The “starting inventory assets” have been removed, since this is a feature that is being deprecated.

• The Director role has been granted 4 “sizes” that it can switch between using + and -.

How to fix it?

If you want the default roles setup, please use DT_RolesExample. If you want custom roles behavior, it is best to use your own roles table. (See https://docs.msquared.io/creation/unreal-development/features-and-tutorials/game-roles#example-setup )

How to test it?

In your level(s), go to the world settings, and filter by “role” - if the default role or data tables arrays have missing values, it may be that you were using one of the removed data tables. This will need to be replaced.

Similarly, if you try to change roles, and see that the roles are missing, or that your startup character isn’t as expected, that could be a sign that the role data table needs updating.

You will also see warnings along these lines:

LogLinker: Warning: [AssetLog] [X]: Failed to load '[Y]': Can't find file.
LogLinker: Warning: [AssetLog] [X]: VerifyImport: Failed to load package for import object '[Y]'

If so, that will highlight the removed data tables that are being referenced.

Party Functionality Permanently Disabled

Affected Features: Parties

What’s broken and why?

As part of the M2 Platform simplication process, we have permanently disabled parties and related functionality. As such, it is no longer possible to:

• Enable party support

• Create a party

• Join a party

• Leave a party

• Send a party message

• Receive party messages

• Use party voice chat

The Party Component is still present but is no longer functional. It will be removed in a future version of the M2 Platform.

How to fix it?

If parties are required in your project, you will need to create or integrate a third party solution. Contact your support representative if you require assistance.

Removed UM2_WebPlatformRealtimeNFTWebsocket

Affected Features: Collections

What’s broken and why?

As part of M2 platform simplification, the UM2_WebPlatformRealtimeNFTWebsocket class has been removed.

How to fix it?

If you require this funtionality, you can implement it in your own project by using the Web Socket Connection and M2 Web Platform API documentation

Interface Change: UM2_WebServicesRoleDataProvider / UM2_WebServicesProfileDataProvider

Affected Features: Web Platform Integration

What’s broken and why?

The interfaces to UM2_WebServicesRoleDataProvider / UM2_WebServicesProfileDataProvider have changed. Instead of taking FM2_AuthUserContext as a parameter, they now take int LocalUserIndex. This is to simplify / remove assumptions about users for custom web platform integrations.

This change should not impact anyone yet unless they have implemented their own data providers.

How to fix it?

Instead passing FM2_AuthUserContext to any of the functions (which was hard to determine in Blueprint), you can pass LocalUserIndex. In 99% of cases, this will be 0, except for bots, which would be the index of the current bot.

How to test it?

Profile and role fetching should function as normal.

Deleted UserRolesSubsystem / UserRolesService

Affected Features: Services

What’s broken and why?

As part of MSquared platform simplification; the C++ querying of user roles has been removed to allow users to perform their own queries to either the web platform, or a service of their own choosing.

As a result of this, existing C++ Web Platform roles integration code has been removed.

This change should not impact users as it extremely unlikely that you’ll be manually querying role data.

How to fix it?

If previously you queried roles via either the UserRolesSubsystem or the UserRolesService (Web Platform), then you need to replace those calls with a Get World Service query, passing M2 Web Platform Roles Data Provider or an explicit derivative.

How to test it?

Role querying should work as normal.

CorrelationId added to Response of SendHttpRequest

Affected Features: Http

What’s broken and why?

CorrelationId has been added to the Response event used by SendHttpRequest. This is to allow users to correlate a response event with the request that initiates it; which is useful for storing state between the sending and response handling.

However, if you are using a bound function to handle the responses, you will experience a blueprint compile error due to the signature of the event changing.

How to fix it?

For every function you have bound to the completion delegate of SendHttpRequest, you must add an extra parameter to the Signature:

Name: CorrelationId, Type: Guid

Once you have done this, try compling the blueprint again and saving it.

How to test it?

If the blueprint compiles correctly, then no further action is required (once you’ve saved it).

Skin PDAs need a resave

What’s broken and why?

The underlying skins logic has been moved, but PDAs don’t handle redirectors nicely. As a result, without a resave of the active skin, PIE will be blocked in the “waiting for HUD” step.

How to fix it?

If you have a custom skin for your project, find it, and resave it. Easiest way to check what skin is being used is by going to the project settings → M2 UI Skins, and checking the Default Skin

How to test it?

If you can PIE and successfully enter the world, it has been fixed!

Disabled Remote Viewers Web Platform Connectivity

Affected Features: Remote Viewers

What’s broken and why?

The Remote Viewers feature is being removed as part of platform simplification. This step disables the connectivity of the Remote Viewers system to the M2 Web Platform services, effectively disabling the feature.

Removed JLR_Plugin_NoFPDependencies

Affected Features: Linting

What’s broken and why?

The firepit linting rule does not do anything, so has now been removed. That means the classes JunoLintRule_Plugin_NoFPDependencies and JLR_Plugin_NoFPDependencies are no longer present. If you have any custom lint rules, the file will be missing.

How to fix it?

There will be a “none” in place of the removed linting rule in any of your custom rule set assets. Remove these. (Or a resave would also be sufficient to stop things complaining)

How to test it?

If your preflights run fine, all is well!

Health in HealthComponent no longer replicated in background

Affected Features: Health Component

What’s broken and why?

The Health variable as part of the HealthComponent is no longer replicated in the background. This is because it was very expensive and could limit the scale of deployments.

How to fix it?

If your project is relying on background health, or the health increased / damage taken callbacks in the background, the game design will need to be adjusted to avoid this.

How to test it?

Check that any health based functionality in your project still works.

Improved Raycastable Crowd Prioritization

Affected Features: Shooting

What’s broken and why?

Raycastable Crowd prioritization is now more configurable from Blueprints.

How to fix it?

Open the RaycastableCrowd asset used by your project’s Animated crowd. This will most likely be in the DA_Pawns asset linked in your Roles Data table.

In the RaycastableCrowd asset, there is a new PriorityCalculation property that exposes multiple prioritization strategies and their configurations.

The default strategies that were in-use before this change were the View Frustum and the Area Of Influence so you will need to enable and configure (based on your project needs) both of these strategies like the following:

Refer to Enabling Raytracing for Crowd Members for more guidance.

How to test it?

1. Start a PIE session with bots/other players.

2. Force everyone into LOD1 so they will be using RaycastableCrowd

3. Shoot at other players and verify they are still receiving damage/interacting.

Removed JM_ModularCharacterComponent and AddedCrowdStaticMeshesOverride

Affected Features: Avatars

What’s broken and why?

In v29 the JM_ModularCharacterComponent was deprecated with the removal of modular characters, and its functions merged into M2M_CharacterAssetComponent. In v30 JM_ModularCharacterComponent has been removed entirely.

JM_CharacterBase::AddedCrowdStaticMeshesOverride and JM_CharacterBase::UpdateDefaultCrowdMemberInitializer have also been removed in favour of the equivalent functions on M2M_CharacterAssetComponent as they’ve been deprecated for several version.

How to fix it?

Anywhere you call a function on JM_ModularCharacterComponent, you should instead call the equivalent function on M2M_CharacterAssetComponent instead. The JM_CharacterBase class has both of these components, so you can get the M2M_CharacterAssetComponent directly from the same actor. v29 had deprecation messages on each function to tell you the equivalent - they are nearly all named exactly the same, except for functions with Interop in the name where this word has been removed.

If you’ve set an asset in JM_ModularCharacterComponent::PostProcessAnimBlueprint you should instead set it in M2M_CharacterAssetComponent::PostProcessAnimBlueprint as this can’t be automatically migrated.

Anywhere you set JM_CharacterBase::AddedCrowdStaticMeshesOverride you should instead set M2M_CharacterAssetComponent::AddedCrowdStaticMeshesOverride. Any call to JM_CharacterBase::UpdateDefaultCrowdMemberInitializer should be replaced by M2M_CharacterAssetComponent::ReloadCharacter.

How to test it?

Blueprints will compile and avatars will behave the same as before.