Metaspace Setup

This page will explain how to set up your metaspace to work with the features present in the YOM Replicator SDK.

Step 1: Enabling the plugins

To enable the necessary plugins for your metaverse project, follow these steps:
  1. 1.
    Start your metaverse project and navigate to the top menu.
  2. 2.
    Click on "Edit" and select "Plugins" from the dropdown menu. This will open the Plugins window.
  3. 3.
    In the search bar within the Plugins window, type 'YOM' to search for the YOM Replicator SDK plugin. If the plugin does not appear, try restarting the editor and repeat this step.
  4. 4.
    Once you locate the YOM Replicator SDK plugin, enable it by clicking the checkbox next to its name.
  5. 5.
    Next, search for the GltfRuntime and VaRest plugins in the same manner and enable them by clicking their respective checkboxes.
  6. 6.
    After enabling the plugins, it is recommended to restart the editor. This allows Unreal to load the plugins properly.
  7. 7.
    Once the editor is restarted, go to the "Settings" menu located at the top right corner of the Content Drawer.
  8. 8.
    From the dropdown menu, select "Show Plugin Content." This action will display all the plugin content provided by the Replicator SDK.

Step 2: Setting up the SDK

To configure the YOM Replicator SDK for your metaverse project, follow these steps:
  1. 1.
    Open the setup screen by navigating to "Tools" in the top menu.
  2. 2.
    Select "Your Open Metaverse" and then choose "Setup Metaspace." This will open the setup window.
    YOM SDK setup window
  3. 3.
    In the setup window, you will find several settings that need to be configured. Here is an explanation of each setting:
    • World (required): This setting determines the persistent level that should be loaded as the metaspace world, where players can spawn. Choose a level that remains loaded throughout the metaspace experience.
    • Player Asset (required): This setting defines the asset that players will control within the metaspace. It can be any character or object that allows player interaction. The default character provided by the Your Open Metaverse Plugin is the Yom_BP_ThirdPersonCharacter.
    • Multiplayer metaspace (enforced): This setting is currently enforced as true, as single-player metaspaces are not supported at the moment.
    • Voice Chat (optional): If enabled, this setting allows players to communicate with each other through voice chat within the metaspace.
    • Player Inventory (optional): Enabling this setting provides players with an inventory system in the game. The default inventory component provided by the Your Open Metaverse plugin is the YomDefaultInventoryComponent. You can also create your own inventory system using the Advanced Inventory Setup Guide.
    • Control hints (optional): If enabled, players will be presented with a control hint screen when they spawn into the game. The default control hints component provided by the Your Open Metaverse plugin is the YomDefaultControlHintsComponent.
    • Allow teleporting (optional): If enabled, players can teleport to and from this metaspace using portals. Portals can be set up by placing a YomDefaultPortal in your scene.
  4. 4.
    Click "Begin Setup," and if the settings are correctly configured, a message will appear in the bottom right corner, instructing you to restart the editor. Click "Restart" to apply the changes.
  5. 5.
    After restarting, navigate to Content Drawer -> Content. You should now see a MetaspaceGameMode and a MetaspacePlayer. These assets can be used to add further modifications and behavior to your metaspace. Note that the Default Pawn Class in the MetaspaceGameMode is intentionally set to None, as the pawn will be loaded into the game via the MetaspacePlayer.
  6. 6.
    To make any further adjustments or verify the setup, you can run the setup tool again or manually modify the settings.
To configure your maps, go to Edit -> Project Settings -> Maps & Modes. Set the server default map to the desired map, and for the game default map, select "ClientEntry." This ensures that the specified map will be loaded when clients join the metaverse.
Configuring the maps
Configure the GameMode as shown in the provided screenshot. Set the Default Pawn Class to None for proper pixel streaming and player spawning logic.
Configuring the GameMode


After pressing the play button, your selected character will spawn in the world. Make sure to add a Player Start to the level if the character does not spawn automatically. The character will have the inventory you selected, accessible by pressing 'I'. The default inventory contains an example item that can be spawned by clicking on it or pressing '1' on the keyboard. To modify the items in the inventory, edit the Plugins/YourOpenMetaverse/FakeResponses/testWalletResponse.json file.If multiplayer is enabled, you can test it by adjusting the Number of players in the play settings menu. For a seamless experience, ensure that any custom code in your PlayerController or GameMode is copied over to the MetaspacePlayer and MetaspaceGameMode, if necessary.Now, you're ready to unleash your creativity and design your own incredible metaspace. Enjoy the journey!