Sync Conflict

From Neos Wiki
Revision as of 12:04, 2 September 2022 by FuzzyBot (talk | contribs) (Updating to match new version of source page)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Other languages:
English • ‎中文 • ‎日本語

Sync Conflicts can occur when a local asset is out of sync with the data stored on the cloud. This can occur for a variety of reasons. You can check the Log Files to see which files are conflicting, and whether the local, or cloud storage is newer. Just open these in a text editor to view them.

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.


  • Delete your Neos data/database or cache files. Doing this will likely make you lose your unsynced 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 Neos. Doing this does not help syncing issues, as these are stored in a separate location.

What to do

Figuring out what isn't syncing

This step is optional, but think about what you were doing just before the sync conflict occurred. Were you working on something important? How you follow these next steps may determine if this work is recoverable or not. So it is a good idea to think about what you were doing and how important it was. The following steps can help you.

  1. Find your log files and open the LATEST one.
  2. Once the log file is open, look for the phrases "unsynced record", "failed sync", "Record preprocessing failed" or similar, using the "Find" feature(usually CTRL + F)
  3. If you find instances of this text then you can read them to figure out what is not syncing. For example it might say near this text something like "Home" or "Avatar". This will tell you what's failing to sync.
  4. Based on what is failing to sync, think about how important that work was.

If you're not sure, ask in our discord, make sure to provide the log file and someone will be able to help you.

Adding a command line argument

Now you've had a chance to think about/look at what is not syncing, you will need to make a choice between two options:

  1. Deleting the un-synced content this will lose any work that did not successfully make it to the cloud.
  2. Forcing an overwrite from your local content to the cloud. This is good if you know the copy of your content on your computer is newer.

Based on your decision, you will then need to add ONE of the following command line arguments to your copy of Neos:

  1. -DeleteUnsyncedCloudRecords will delete any local(to your computer) un-synced files/items from your computer and re-download the cloud copies. Only use this command if you are certain you will not lose important files/items when they are deleted from your computer.
  2. -ForceSyncConflictingCloudRecords will force the conflicting local files/items to be uploaded to the cloud. This will overwrite the existing cloud files/items with your local copies. This can overwrite your cloud data with an earlier/incorrect version, so use it carefully.

To add these to Neos follow the following steps, for either the Steam or Standalone build:

For the Steam build

  1. Open Steam
  2. Right click on Neos VR in your library
  3. Select "Properties" and then "Set Launch Options".
  4. Enter the command you need to use, exactly as it appears above and Run Neos.

Setting custom launch options via Steam

Now, if Neos is launched via Steam, the custom command line arguments will take effect.

Commands entered via this method will not take effect if Neos is launched any other way, such as via the Neos Launcher or by directly launching the Neos.exe.

For the Standalone build

You have two options:

Using the Neos Launcher

  1. Find the Neos Launcher for the standalone. You can do this by double clicking on the NeosLauncher.exe in the NeosVR install folder
  2. Check the "Use custom bootstrap class" option
  3. Enter your command line arguments in the box below this checkbox.


Launch arguments entered this way will only take effect if the Neos Launcher is used to start Neos.

Use a shortcut

It is possible to use launch commands via a custom shortcut targeting the Neos.exe file.

To create a shortcut:

  1. Find the Neos install folder and right-click on the Neos.exe.
  2. In the context menu click 'Create Shortcut'
  3. Move the 'Neos.exe - Shortcut' file to somewhere more convenient (such as the Desktop).
  4. Right-click on the shortcut file and click 'Properties' in the context menu.
  5. This opens a dialog window. Select the 'Shortcut' tab.
  6. In the 'Target' text box add a space after the Neos.exe filepath and then add your command line arguments.
  7. Click 'Apply' and 'OK'.

Now, if Neos is launched by double clicking on the shortcut it will launch using the custom options. These will not be applied if a different method is used to start Neos.

Setting custom launch options for a Shortcut

There is also a tutorial by ProbablePrime.

Running Neos

Once you've added one of the above commands following the above instructions. Run Neos once, when it is running look for All Synced at the top center of your Neos Dash. This will indicate that the sync issue has been resolved.

Cleaning Up

Once the issue is resolved, remove the command line argument that you added. It is only needed while you are actually fixing the conflict. Leaving these command line arguments in place permanently may result in data loss.

Other Issues

If you believe that the syncing issue is caused by something else please double check our other Sync Errors guides.