Exception During Sync

From Resonite Wiki
Revision as of 21:33, 20 April 2024 by Delta (talk | contribs) (Add to troubleshooting category)

Rarely, you may encounter a sync error that isn't providing any of the common errors but instead shows a more generic `Exception during sync.` These can indicate an issue outside of just your account such as a network connectivity issue, a change in infrastructure requiring a game update, or a service outage for the api.

Ensure you're reading the right guide

We have multiple guides for Sync related matters, please ensure you are reading the correct one for your problem, for the "Hub" of these see Sync Errors BEFORE you start.

These problems are slightly different and may require differing steps, so we've split them into separate guides.

DO NOT

  • Delete your Resonite data/database or cache files. Doing this will likely make you lose your un-synced items, and can cause other side effects
  • Try to save and sync any more items/worlds. Doing this will add to your sync queue and if your items/worlds are not syncing properly.
  • Click "Exit & Save Homes". Doing this will also add to your sync queue.
  • Send any objects or voice messages through the Contacts tab. Doing this will also add to your sync queue and will not send until any syncing issues are fixed.
  • Change any settings. Doing this will also add to your sync queue and will not save properly until any syncing issues are fixed.
  • Reinstall Resonite. Doing this does not help syncing issues, as these are stored in a separate location.

Diagnosing an Exception During Sync

Before continuing, you should confirm you are on the latest version of the game and check the Resonite Status Page for any service outages. If there are issues shown in your area, you may be best off waiting for the service issues to be resolved and trying again at a later time.

If there are no issues reported on the status page and you see an error like `Exception running PUT request to https://skyfrost-archive.resonite.com/assets/` with a `Error: ConnectFailure` then there is likely an issue between you and the server.

  1. Try to access the url listed in the exception directly in a web browser. If your browser states that it is unable to connect to the server there may be a firewall setting, dns issue, or isp issue preventing you from connecting.
  2. You may want to start with simply restarting your internet router and retrying.
  3. Check your DNS settings, some ISP provided ones may block some sites or have additional 'safety settings' applied that limit the sites available. You may consider changing your DNS settings to use ones provided by Cloudflare `1.1.1.1` or Google Public DNS `8.8.8.8` to avoid those and see if it may be the cause of being unable to complete some requests.