Connectivity troubleshooting

Figure out why you can't connect to the plugin.

If you are seeing the PMP download button instead of the plugin download button, this page can help you find out why.

Check common issues

There are several common issues that prevent the plugin from being discovered. Check the list below.

  • The Heliosphere plugin is not installed (instructions) or is outdated.
  • Your game is not open or plugins are disabled.
  • Your browser or a browser extension is blocking install requests.

    Known problematic browsers/extensions
    Brave

    Brave blocks requests to localhost by default, which interferes with install requests sent to the plugin. There are two options to fix this: turn off shields or add an exception for install requests.

    To add an exception for install requests:

    1. Navigate to brave://adblock.
    2. Add the following on a new line in the Create custom filters box:
      @@||localhost^$domain=heliosphere.app
    3. Click Save changes.
    uBlock Origin

    The list called Block Outsider Intrusion into LAN blocks requests to localhost, which interferes with install requests sent to the plugin. This can be fixed by unchecking that list or adding an exception.

    To add an exception for install requests:

    1. Click on the uBlock Origin extension icon
    2. Click the cog wheels in the bottom right to enter the settings
    3. Click the My filters tab
    4. On a new line in the text box, add the following:
      @@||localhost^$domain=heliosphere.app
    5. Click Apply changes
    uBlock Origin Lite

    The list called Block Outsider Intrusion into LAN blocks requests to localhost, which interferes with install requests sent to the plugin. This can be fixed by unchecking that list.

    To uncheck the list:

    1. Click on the uBlock Origin Lite extension icon
    2. Click the cog wheels in the bottom right to enter the settings
    3. Click the Filter lists tab
    4. Uncheck Block Outsider Intrusion into LAN
    Malwarebytes Browser Guard

    The Malwarebytes Browser Guard extension blocks all requests to localhost, even when disabled in the extension settings, which interferes with install requests sent to the plugin.

    There is no way to fix this unless you remove the extension.

Check network requests

Follow the steps below to identify what is blocking your connection.

  1. Make sure the game is open and the Heliosphere plugin is installed.
  2. Click on this page and then press F12 to open your browser's development tools.
  3. In the new pane that opened, click on the Network tab.

    Show me
    developer tools screenshot showing an arrow pointing at the network tab
    If the pane is on the side of your screen, you may not be able to see the Network tab. Click the arrow on the right side of the development tool tabs to see additional tabs.
  4. Click the button below to send a request to the plugin.