Native iOS

As of Morpheus Platform Release v39.1, we have enabled native iOS support, available to approved partners.

A note on "being approved to use iOS clients"

Use of our Morpheus Platform app is currently tightly controlled, due to it being in an experimental state. Additionally, we require that any partner wanting to launch iOS-supported world adheres to Apple's guidelines: https://developer.apple.com/app-store/review/guidelines/

You will need to reach out to support to be granted access. Without this, you will be unable to enable iOS clients for your project, or for specific worlds.

How to enable iOS

The following are the steps required to enable a world. Some require MSquared Admin access, so you will need to request this from support:

Uploading iOS clients

1. In your project's .uproject file, add the IOSClient to your TargetPlatforms list.

   
2. Then you can upload mods as normal. The mods will then also cook the required content for IOSClient builds.

   1. You should then see logs along the lines of the following when uploading, to confirm that the iOS client is being included

      LogWorldBuilderEditor: Display: modpakchunk0-iosclient.utoc: [Completed Successfully]
      LogWorldBuilderEditor: Display: modpakchunk0-iosclient.pak: [Completed Successfully]

Enabling iOS clients for your project

• Before you can launch worlds that use iOS clients, you will need to enable iOS clients for your project. This is done in your Dashboard's Admin settings' Projects tab. If the iOS Clients field is not ticked, then your project does not yet support native iOS.

  

  • Edit the project, and tick the Allow iOS clients to be used in this project.

  

  • If that checkbox is not visible for you, that's a sign that you have not been approved yet to use iOS clients. You will need to reach out to support.

Launching iOS-supported worlds

A note on iOS-supported worlds

We currently only support iOS client access to public worlds. This means that there is no restriction on who can access an iOS-supported world. This means that anyone using the iOS will be able to connect to the world, including members of the public.

We are looking to add functionality to create iOS-supported worlds that are restricted to certain users, e.g. only visible to members of your organisation. In the meantime though, please be aware that the worlds will be public even when doing your own testing.

For worlds using mods that have enabled #Uploading iOS clients, in a project that has enabled iOS clients (#Enabling iOS clients for your project), you can make them visible to the iOS client's "World Browser" by doing the following:

• In your Dashboard, select the world's General tab, tick Public downloads enabled and Allow iOS

  

  • You will only be able to tick Allow iOS if the project has been

• In the Access tab, tick Public Stream Client Access

  
• If you want a customized thumbnail for your world, go to General, and Upload world image

  

Configuring roles for iOS clients

• We do not currently support iOS users creating accounts via e.g. Google. Instead, we create "guest accounts" for them, tied to their device.

• If you want to configure In-Game Roles for iOS users, add an access group with the email domain guest.m2worlds.io.

  

The Morpheus Platform app

The iOS client is launched through the Morpheus Platform app, available for public download (https://apps.apple.com/gb/app/morpheus-platform/id6745405787).

A note on minimum requirements

The minimum requirements for the iOS app are outlined in Hardware Requirements #Native iOS Game Client

If you have older devices than these, the app may run, but expect poor performance and potential crashes. If you are running an event that guides users to use the app, we recommend that you draw their attention to this limitation.

This app uses a "World Browser", to view all currently active iOS-supported worlds (see #Launching iOS-supported worlds). If you Follow the above steps, your world will be visible on this page, and be available to connect to.

This world browser is shared across all projects that have been approved to use iOS clients, so may display the worlds of any of our partners. If you want a custom app for your project, rather than using the shared World Browser, that will require bespoke work - reach out to support if this is something you are interested in.

A note on release versions

Each release of the app is tied to a particular release of the Morpheus Platform editor. Its world browser will only display worlds for the corresponding Morpheus Platform release. e.g. Version 1.3 of the app is tied to Morpheus Platform Release v39.1.

For this reason, you will need to be on the latest release of the Morpheus Platform to create worlds for the latest version of the iOS app.