Revision as of 19:21, 25 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.

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
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	There is not enough storage in the Resonite Account to accommodate the size of the item or world to sync. 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: @@
+<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>
 = General Guidance = <!--T:2-->
-Here's some general guidance that works for any Sync Error:
+Here is some general guidance to follow when starting the diagnosis:
-# Ensure your main drive (Default C:), has enough free space. Resonite requires free drive space to sync, so ensure you have some free space.
+# 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.
-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]]
+# Avoid deleting the cache or data folder and utilizing command line arguments until the sync error type has been identified.
+</translate>
+<translate>
 = Specific Guides = <!--T:3-->
-We have multiple guides for Sync related matters, please ensure you are reading the correct one for your problem:
+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.
-* [[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>
-* [[Sync Conflict]] - For resolving an account Sync conflict.
-* [[Exception During Sync]] - More rare exceptions while syncing that may indicate an issue beyond your account.
+{| class="wikitable"
-[[Category:Troubleshooting]]<!--T:4-->
+|-
+! <translate>Type</translate> !! <translate>Description</translate> !! <translate>Example Log File Contents</translate>
+|-
+| [[Special:MyLanguage/Sync Conflict|<translate>Conflict</translate>]] || <translate>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>The word <code>Conflict</code> on a separate line.</translate>
+|-
+| [[Special:MyLanguage/Stuck Sync/Out Of Space|<translate>Out Of Space</translate>]] || <translate>There is not enough storage in the Resonite Account to accommodate the size of the item or world to sync. 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>Too Many Requests</translate>]] || <translate>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>Exception During Sync</translate>]] || <translate>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>Stuck Sync</translate>]] || <translate>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><code>Starting sync</code> followed by <code>Exception running asynchronous task:
+System.AggregateException: One or more errors occurred.</code></translate>
+|}