Sync Conflict

From Neos Wiki
Revision as of 10:01, 21 August 2022 by ProbablePrime (talk | contribs) (Created page with "Sync errors 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 regular log files to see...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Sync errors 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 regular 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.

Do not:

Delete your Neos data or cache files. Try to save and sync any more items/worlds. Send any objects or voice messages through the Contacts tab. Change any settings. Before figuring out what the problem or error is. These steps are likely unnecessary and could cause more problems later on if you haven't resolved the initial syncing error.

Once the log file is open, look for the phrase "unsynced record", "failed sync", "Record preprocessing failed" or similar. This will then show you what is not synced, and why. If you believe that your sync error is occurring due to a cloud or local item/world mismatch, you should make a choice based on how old/new/important the unsynced item is. Based on this choice you will need to use one of these two different command line arguments:

-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. -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 enter these command line arguments in the Steam build:

Right click on Neos VR in your library Select Properties and then Set Launch Options. Enter the command exactly as it appears above and Run Neos. Wait for everything to load as per normal, Look for a Green Sync status in your Neos Dash. Exit Neos. Remove the command line argument you previously added so it doesn’t apply on subsequent launches. To enter them in the standalone build, follow this tutorial by ProbablePrime.


If you believe that the syncing issue is caused by something else (for example, you see a "Too many requests" error in your log, or an "out of space" error), please ask the #❓questions-help channel in the Neos Discord for further assistance. Please include in your message what error you are getting, and the log file itself.

If you have any other questions or issues please ask in the #❓questions-help channel of the Neos Discord.