Sync errors: Difference between revisions

Latest revision as of 00:43, 26 August 2025

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:

Ensure the drive that contains the cache and data has enough free space. Please review the data and cache directories page for more information.
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.`

@@ Line 1: / Line 1: @@
+<languages/>
+<translate>
+<!--T:19-->
+[[File:Sync error facet error.webp|thumb|right|alt=A facet reading "Sync Error. Check log file for details"|The sync status facet on the top bar of the [[dash menu]] will indicate whether a sync error occurs.]]
+</translate>
+<translate>
 <!--T:1-->
-Sync Errors are a variety of issues that prevent your copy of Resonite from synchronizing with the Resonite Cloud. There are a variety of issues which are common, but we're writing guides for each of the common variants which are listed below. There's also some general guidance that will work for any variety of Sync Error.
+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.
+</translate>
+<translate>
+<!--T:2-->
+== General Guidance ==
+Here is some general guidance to follow when starting the diagnosis:
+# Ensure the drive that contains the cache and data has enough free space. Please review the [[Special:MyLanguage/Data_and_cache_directories|data and cache directories]] page for more information.
+# Avoid deleting the cache or data folder and utilizing command line arguments until the sync error type has been identified.
+<!--T:20-->
+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.
+</translate>
-= General Guidance = <!--T:2-->
+<translate>
-Here's some general guidance that works for any Sync Error:
+<!--T:3-->
-# Ensure your main drive (Default C:), has enough free space. Resonite requires free drive space to sync, so ensure you have some free space.
+== Specific Guides ==
-If want to change directory, check [[Command_Line_Arguments#.E3.83.87.E3.83.BC.E3.82.BF.E3.83.99.E3.83.BC.E3.82.B9|Command Line Arguments]]
+The table below lists the possible sync error types that can be encountered. To locate the sync error in the log file, look for <code>Failed sync for</code> followed by the user id and the words <code>Local</code> and <code>Global</code>. After locating the line in the log file, review the example log file contents in the table to find the sync error type.
+</translate>
-= Specific Guides = <!--T:3-->
+{| class="wikitable"
-We have multiple guides for Sync related matters, please ensure you are reading the correct one for your problem:
+|-
-* [[Stuck Sync]] - A general guide for resolving your account syncing when it is '''"Stuck"''' and specifically not moving. Based on this guide, you may end up back here, but with better information!
+! <translate><!--T:4--> Type</translate> !! <translate><!--T:5--> Description</translate> !! <translate><!--T:6--> Example Log File Contents</translate>
-* [[Sync Conflict]] - For resolving an account Sync conflict.
+|-
-* [[Exception During Sync]] - More rare exceptions while syncing that may indicate an issue beyond your account.
+| [[Special:MyLanguage/Sync Conflict|<translate><!--T:7--> Sync Conflict</translate>]] || <translate><!--T:8--> The item or world that was recently saved does not align with the same item or world stored in the cloud. Please read the [[Special:MyLanguage/Sync Conflict|Sync Conflict]] page for assistance.</translate> || <translate><!--T:9--> The word <code>Conflict</code> on a separate line.</translate>
-[[Category:Troubleshooting]]<!--T:4-->
+|-
+| [[Special:MyLanguage/Stuck Sync/Out Of Space|<translate><!--T:10--> Out Of Space</translate>]] || <translate><!--T:11--> The storage size of the item or world to sync is over the user's or group's available cloud storage. Please read the [[Special:MyLanguage/Stuck Sync/Out Of Space|Out Of Space]] page for assistance.</translate> || <code>Fail Reason: Out of space</code>
+|-
+| [[Special:MyLanguage/Stuck Sync/Too Many Requests|<translate><!--T:12--> Too Many Requests</translate>]] || <translate><!--T:13--> Resonite's Cloud is currently receiving too many attempts from the sync task, preventing further processing. Please read the [[Special:MyLanguage/Stuck Sync/Too Many Requests|Too Many Requests]] page for assistance.</translate> || <code>UpsertResult State: TooManyRequests</code>
+|-
+| [[Special:MyLanguage/Exception During Sync|<translate><!--T:14--> Exception During Sync</translate>]] || <translate><!--T:15--> 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 [[Special:MyLanguage/Exception During Sync|Exception During Sync]] page for assistance.</translate> || <code>Exception during sync</code>
+|-
+| [[Special:MyLanguage/Stuck Sync|<translate><!--T:16--> Stuck Sync</translate>]] || <translate><!--T:17--> 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 [[Special:MyLanguage/Stuck Sync|Stuck Sync]] page for assistance.</translate> || <translate><!--T:18-->
+<code>Starting sync</code> followed by <code>Exception running asynchronous task:
+System.AggregateException: One or more errors occurred.</code></translate>
+|}