Sync errors

The sync status facet on the top bar of the dash menu will indicate whether a sync error occurs.

A sync error is a type of error that is produced when a sync task fails to synchronize a saved item or world to Resonite's cloud. There are various types of sync errors that can be encountered when a recently saved item or world fails to sync.

General Guidance

Here is some general guidance to follow when starting the diagnosis:

1. Ensure the drive that contains the cache and data has enough free space. Please review the data and cache directories page for more information.
2. Avoid deleting the cache or data folder and utilizing command line arguments until the sync error type has been identified.

Another fact to consider is that records (i.e., items, worlds, and voice messages) saved after a reported sync error will still sync regardless. However, the error should be corrected as soon as possible, especially, when the sync error occurred while building a world or item.

Specific Guides

The table below lists the possible sync error types that can be encountered. To locate the sync error in the log file, look for Failed sync for followed by the user id and the words Local and Global. After locating the line in the log file, review the example log file contents in the table to find the sync error type.

Type	Description	Example Log File Contents
Sync Conflict	The item or world that was recently saved does not align with the same item or world stored in the cloud. Please read the Sync Conflict page for assistance.	The word Conflict on a separate line.
Out Of Space	The storage size of the item or world to sync is over the user's or group's available cloud storage. Please read the Out Of Space page for assistance.	Fail Reason: Out of space
Too Many Requests	Resonite's Cloud is currently receiving too many attempts from the sync task, preventing further processing. Please read the Too Many Requests page for assistance.	UpsertResult State: TooManyRequests
Exception During Sync	A rare sync error that occurs when an exception is thrown while syncing an item or world. This is usually an issue beyond the Resonite Account. Please read the Exception During Sync page for assistance.	Exception during sync
Stuck Sync	A very rare error that stops the entire sync processing queue and prevents other sync tasks from running. The sync status indicator will not indicate a sync error due to the stopped process. Please read the Stuck Sync page for assistance.	Starting sync followed by Exception running asynchronous task: System.AggregateException: One or more errors occurred.