ResourceSaver

public static ResourceSaverInstance Singleton { get; }

Borrowed wrapper of the global engine service. Repeated access uses a cached managed wrapper, not a separate registry. Do not Free()/Dispose() this engine-owned object. Use the class static methods for ordinary work.

public static void AddResourceFormatSaver(ResourceFormatSaver formatSaver, bool atFront = false);

Adds an owned ResourceFormatSaver to the global list; atFront=true gives priority over current handlers. The registry retains a native reference, but manage registration and managed lifetime explicitly. Registering the same instance again creates a duplicate; do not add before each Save. Returns no Error; invalid objects/capacity exhaustion produce diagnostics. Unregister before disposing an owned saver.

public static string[] GetRecognizedExtensions(Resource type);

Collects registered-saver extensions for a Resource instance; the type parameter is not C# typeof/a class name. Names have no dot; duplicates are possible and sorting is unspecified. The list guarantees no successful Save: a handler still checks recognition/path and may reject the operation. Contents depend on the resource and current plugin registration.

public static long GetResourceIdForPath(string path, bool generate = false);

Delegates a UID request to an optional callback, typically configured by the editor. Not ResourceUid.CreateIdForPath or a general UID factory. Without the callback it returns InvalidId even with generate=true, confirmed in a headless game process. Does not automatically inspect the whole file/registry or guarantee UID persistence.

public static void RemoveResourceFormatSaver(ResourceFormatSaver formatSaver);

Removes the first registration of that instance. If added twice, one Remove leaves another registration; tested. Does not automatically dispose your managed wrapper or delete saved files. Missing/null savers produce diagnostics; track whether Add occurred during normal lifecycle.

public static Error Save(Resource resource, string path = "", ResourceSaver.SaverFlags flags = ResourceSaver.SaverFlags.None);

Saves a Resource through registered format savers: object and path are recognized before handler execution. Empty path uses ResourcePath; both empty is invalid. Failure can fall through to another handler; Ok is its report, not independent file verification. Concrete savers implement flags. In 1.0.0 ChangePath changes ResourcePath before calling and restores it only on success: failure can retain the new path, including after successful fallback. Reproduced. Not an atomic game save; a live Entity must be packed separately because Save takes a Resource.

public static Error SetUid(string resource, long uid);

Asks a format saver to change an existing resource file UID; creates no game Entity and does not automatically register the path in ResourceUid. Check Error. The 1.0.0 text backend uses a temporary .uidren and remove/rename without propagating those replacement errors; a source-only limitation, not a transaction guarantee. Windows testing covered ordinary .rdata header changes, not replacement failures or editor scanning.