Search
K
Links

Debugging your Metaspace

To debug your metaspace and troubleshoot any issues, follow these steps:
  1. 1.
    Setup:
    • Click the green play button and select the three dots. Under Multiplayer Options, set the Number of Players to 1 and choose Net Mode -> Play as Client. This simulates the server-client setup used when deploying your metaspace on YOM.
      ClickThreeDots
      ClickPlayAsClient
    • Go to Tools -> Your Open Metaverse -> Metaspace Settings and adjust the following settings:
      • Use Solana Devnet: If enabled, it will use the Solana Devnet. If disabled, it will use the Solana Mainnet.
      • Use Test Player: If enabled, it uses a test wallet. If disabled, it uses real wallets.
      • Spawn Default Player: Enable this if you want the player to automatically spawn. Disable it if you want to connect via pixel streaming before the player spawns.
      • Allow Guests: Enable this for pixel streaming testing.
      • Local Preview Images: Creates a local cubemap for the world's portal. Can be used for cubemap creation.
      • Test Portals: If enabled, it retrieves data from a fake portal.
  2. 2.
    Debugging with a Signalling Server:
    • Go to Edit -> Editor Preferences -> Additional Launch Parameters and set it to "-AudioMixer -PixelStreamingUrl=ws://localhost:8888 -Log -res=1920x1080w". This enables audio, sets the pixel streaming URL, and opens the log.
    • Click the green play button, select the three dots, and choose Standalone Game to play as a standalone game.
    • If using the signalling server of Your Open Metaverse, go to Tools -> Your Open Metaverse -> Metaspace Settings and disable Spawn Default Player (if not already disabled). Enable Allow Guests.
    • Launch the signalling server and the game. They will automatically connect if the ports are the same. You can spawn a player from the browser by visiting http://localhost/. If they don't connect, check the signalling server's visibility at localhost, verify the Additional Launch Parameters, and ensure the config.json file of the Signalling Server has the correct port set (8888). To add your wallet, visit http://localhost/?solanaPublicKey=PutYourKeyHere.
  3. 3.
    Checking Logs:
    • If any of the provided Actors or Components by Yom are not working as expected, check the Output Log for warnings and useful information. Open it by clicking on "Output Log" next to the Content Drawer in the bottom bar of the editor.