Enum AddressableErrorCode

Specifies structured error codes that categorize the type of failure encountered during an Addressables operation. Each code maps to a distinct failure mode so that calling code can implement targeted error handling (e.g., retry on NetworkError, alert the user on AssetNotFound, or abort silently on OperationCancelled).

Namespace: Scylla.Core.Util.Addressables

Assembly: ScyllaCore.dll

Syntax

public enum AddressableErrorCode

Remarks

Error codes are carried by AddressableException and surfaced through AddressableResult / AddressableResult<T> so that callers can inspect failure reasons without catching exceptions directly.

The numeric values are stable across framework versions. Do not rely on the integer values for serialization, but they are safe to compare as enum members.

Fields

Name	Description
AssetNotFound	The Addressables catalog contains no entry for the requested address, or the address key exists but the asset itself is missing from the bundle. Verify that the address string exactly matches the key assigned in the Addressables Groups window and that the relevant content has been built.
CatalogUpdateFailed	An attempt to check for or apply catalog updates from the remote content host failed. The local catalog remains unchanged. This may occur when the remote catalog URL is unreachable or returns an unexpected response.
DownloadFailed	The remote content download failed before the asset could be stored locally. Common causes include network unavailability, CDN errors, or content build mismatches between the catalog and the hosted bundles. Consider retrying with WithRetries.
InstantiateFailed	An attempt to instantiate a prefab loaded via Addressables failed. Possible causes include the asset not being a `GameObject` prefab, or Unity failing to construct the instance (e.g., due to missing components or script errors in `Awake`).
InvalidHandle	The `AsyncOperationHandle` used in the operation is not valid - it was never initialized, has already been released, or belongs to a completed and disposed operation. Always check handle validity before passing handles to utility methods or releasing them.
InvalidSettings	The AddressableSettings provided to an operation failed Validate() checks. Inspect the exception message for the specific property that is out of range (e.g., timeout or retry count).
InvalidType	The asset was loaded successfully but could not be cast to the requested generic type parameter `T`. Verify that the address points to an asset of the expected type.
LoadFailed	The asset loading operation started but failed before completion. The underlying Unity `AsyncOperationHandle` finished with a failed status. Inspect `AddressableException.InnerException` for the originating Unity error.
NetworkError	A network-level error occurred while communicating with a remote content host during asset downloads, catalog fetches, or bundle streaming. This is distinct from DownloadFailed, which indicates a completed-but-failed transfer; `NetworkError` indicates the connection itself could not be established or was interrupted.
NotInitialized	The Addressables system could not be used because the Unity Addressables package (`com.unity.addressables`) is not installed, or the `SCYLLA_HAS_ADDRESSABLES` scripting define symbol is not present in the project. Install the package and verify the define is set before calling any Addressables operations.
NullAddress	The provided address string is `null` or empty. This code is set when argument validation rejects an address before the Addressables system is even contacted. Ensure the address key is non-empty and matches an entry in the Addressables catalog.
OperationCancelled	The operation was cancelled via a `CancellationToken` before it could complete. Any handles acquired before cancellation are released automatically by `ScyllaAddressables`. Treat this as a normal control-flow outcome rather than an error when the caller initiated the cancellation.
ReleaseFailed	An attempt to release a loaded asset or operation handle failed. This typically occurs when releasing an already-released or otherwise invalid handle. Check that release is only called once per load operation.
SceneLoadFailed	The Addressables scene loading operation failed before the scene became active. Inspect `AddressableException.InnerException` for additional Unity error details. Ensure the scene asset is part of an Addressables group and that `LoadSceneMode` is compatible with the current scene state.
SceneUnloadFailed	An attempt to unload an Addressables-managed scene failed. This may occur if the scene was already unloaded, the handle was released prematurely, or only one scene remains loaded and Unity prevents the unload.
Timeout	The operation did not complete within the timeout period configured in TimeoutMilliseconds. Consider using LongTimeout or RemoteContent presets for slow network conditions, or increase the timeout on a custom AddressableSettings instance.
Unknown	An unknown or unspecified error occurred. This is the sentinel value used when no more specific code can be determined, and also appears on successful AddressableResult instances where the error code field is unused.