ResourceSaver

public static ResourceSaverInstance Singleton { get; }

Заимствованный wrapper глобального сервиса движка. Повторное получение использует cached managed wrapper; не создаёт отдельный реестр. Не вызывайте Free()/Dispose() у этого engine-owned объекта. Для обычной работы используйте статические методы класса.

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

Добавляет собственный ResourceFormatSaver в глобальный список; atFront=true даёт приоритет перед текущими обработчиками. Реестр удерживает native-ссылку, но регистрацию и managed-срок жизни организуйте явно. Повторная регистрация того же экземпляра разрешена и создаёт дубликат; не добавляйте его перед каждым Save. Метод не возвращает Error; неверный объект/исчерпание лимита дают диагностику. Удалите регистрацию до Dispose собственного saver.

public static string[] GetRecognizedExtensions(Resource type);

Собирает расширения из зарегистрированных saver для переданного экземпляра Resource; параметр type не является C# typeof/именем класса. Имена без точки, возможны повторы, сортировка не обещается. Список не гарантирует успешный Save: конкретный handler ещё проверяет Recognize/RecognizePath и может отказать. Набор зависит от ресурса и текущей регистрации плагинов.

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

Делегирует запрос UID необязательному callback, обычно настроенному редактором. Это не ResourceUid.CreateIdForPath и не общая фабрика UID. Без callback возвращает InvalidId даже при generate=true; это подтверждено в игровом headless-процессе. Не проверяет автоматически весь файл/реестр и не гарантирует запись UID на диск.

public static void RemoveResourceFormatSaver(ResourceFormatSaver formatSaver);

Удаляет первую регистрацию указанного экземпляра. Если он добавлен дважды, один Remove оставляет вторую регистрацию; это проверено. Не уничтожает автоматически ваш managed-wrapper и не удаляет сохранённые файлы. Отсутствующий/null saver даёт диагностику; при обычном lifecycle учитывайте, был ли Add выполнен.

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

Сохраняет Resource через зарегистрированные format savers: сначала проверяется объект и путь, затем вызывается обработчик. Пустой path использует ResourcePath; если оба пусты, операция недопустима. После ошибки возможен переход к следующему обработчику, а Ok означает его ответ, не независимую проверку файла. Флаги реализуются конкретным saver. В 1.0.0 ChangePath меняет ResourcePath перед вызовом, но восстанавливает старое значение только при успехе: неудача может оставить новый путь, в том числе после успешного fallback. Это воспроизведено. Не является атомарным сохранением игры; живую Entity сначала нужно упаковать отдельно, Save принимает Resource.

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

Просит format saver изменить UID существующего ресурсного файла, не создаёт игровую Entity и не регистрирует путь в ResourceUid автоматически. Проверяйте Error. Текстовый backend 1.0.0 использует временный .uidren и remove/rename, не передавая наружу их ошибки; это source-only ограничение, не транзакционная гарантия. На Windows проверено изменение заголовка обычного .rdata; ошибки замены и редакторное сканирование не выполнялись.