Troubleshooting

Getting stuck on loading screen

Rooms may have complex 3D models or objects in them, which can increase the load time, particularly on less powerful devices (i.e., mobile phones and standalone VR headsets). If you are getting stuck on the loading screen, try refreshing the page or loading the scene on another browser or device.

Audio sounds choppy

Choppy sounding audio could indicate that your device/network is having trouble with the complexity of the room. This could be because of the complexity of objects in the scene, or the number of other room members present. If you are on a mobile phone, you may find audio quality and performance improves if you enter the room from a more powerful device, such as a computer.

Wired-in headset is not working

If your wired-in headset isn't connecting, we recommend checking the following:

  • Does your browser support WebVR? We recommend Firefox for wired-in WebVR experiences. See if your set-up works at https://webvr.info/samples/XX-vr-controllers.html.
  • Is your browser up to date?
  • Do you have SteamVR (Vive / Windows Mixed Reality) or Oculus App (Rift) installed and up to date?
  • Does your VR headset require other supporting software (e.g., Windows Mixed Reality Portal)? Is this installed and up to date?
  • If you are using Windows Mixed Reality, have you also installed the Steam VR Tooling for WMR headsets?
  • Is your browser using the same graphics card as the VR Headset?

There is echo in the room

Echo may occur if a participant is not wearing headphones. You can ask participants to mute their mic when they are not speaking, or as a room moderator you can mute them yourself in their avatar menu. You can also reduce the volume of the user in their avatar menu. See MUD Features for more information.

I have generally bad performance in a room on an otherwise powerful computer

Confirm that your browser has hardware acceleration enabled. This will allow your browser to utilize the graphics card, which is important for rendering MUD with better performance. If you are on a laptop with a discrete GPU, you should also confirm that the browser is using the dedicated card in the computer settings.

"Unable to connect" error

An error that says "unable to connect" is often caused by a firewall. At a minimum, MUD needs your computer to connect to external ports 80 and 443, both via TLS. Ideally, you should also open up ports 51610-65535 on UDP and TCP for MUD on your router's firewall.

Note that for self-hosted versions of MUD you need to open ports 49152-60999 on UDP and TCP. You will also need to open port 19302 on UDP and TCP.

MUD landing page is blank

If you are using Internet Explorer, try opening the website on another browser. If it doesn't appear on other pages, try clearing your cache and cookies for that page.

Mic not working

If no sound is being picked up from your voice, first check that your mic is properly plugged in and that you selected the right mic in the browser permissions (typically to the left of the address bar). If it is still not working, you may need to look in the privacy and security settings on your computer to ensure that mic permissions are not being blocked. If it still does not work, try in another browser. MUD works best in Firefox and Chrome, but it also runs on Edge and desktop Safari.

If the mic is picking up your voice, but it sounds distorted. Check you aren't using a Bluetooth headset mic, as these do not always work well with browser-based tools.

Screen sharing / webcam not working

Similar to mic issues, if you can't get screen sharing or the webcam to work, first ensure that any required peripherals (webcam) are plugged in. Ensure they have the right permissions to run in your browser (typically to the left of the address bar). If it is still not working, you may need to look in the privacy and security settings on your computer to ensure that permissions are not being blocked. If it still does not work, try in another browser. MUD works best in Firefox and Chrome, but it also runs on Edge and desktop Safari.

Objects disappear after leaving the room

By design, any objects you create in a room will disappear when you leave. This prevents the room from becoming cluttered and slow as things are left behind. If you do want an object to stay in the room, open the object's controls (hover your cursor over it and press the space bar on the desktop), and select "pin". A pinned object will stay in the room until it is unpinned or deleted.

Objects appear as broken media link

If you try to import an object, and it loads as a broken link, it could be an unsupported file format, or the file might be too large. MUD supports file uploads up to 150MB.

Images aren't displaying

Some older systems have trouble rendering 2D objects in the scene. If you suspect this is happening, try reloading the page with the following flag at the end of the URL: ?disablebatching. For example:

https://mud.foundation/sgKNM3h/smart-magnificent-gala?disablebatching

YouTube is not working

YouTube videos don't work reliably in MUD. We recommend trying Vimeo or saving your video to Dropbox and streaming from there.

Need help with something else?

Anything unclear? Please reach out: support@mud.foundation