ResourceLoader

public static ResourceLoaderInstance Singleton { get; }

Заимствованный wrapper глобального ResourceLoader, не отдельный загрузчик на каждый вызов. Не Free()/Dispose() engine-owned Singleton. Для обычных операций используйте статические методы; ResourceFormatLoader регистрируется отдельно.

public static void AddResourceFormatLoader(ResourceFormatLoader formatLoader, bool atFront = false);

Добавляет собственный format loader в глобальный список; atFront=true даёт приоритет перед текущими обработчиками. Удерживайте экземпляр до явного удаления регистрации. Повтор того же instance создаёт дубликат, не обновляет существующий; это проверено. Неверный объект/лимит дают диагностику, отдельного Error нет. Не регистрируйте заново перед каждым Load.

public static bool Exists(string path, string typeHint = "");

Проверяет ресурс по кэшу или loader, а не обязательно наличие корректного файла на диске. Cached ресурс даёт true даже после удаления файла и до проверки typeHint. Некорректный файл с распознаваемым расширением тоже может дать true без parsing. Не используйте как гарантию успешного Load<T>() или совпадения C# типа; результат загрузки проверяйте отдельно.

public static Resource GetCachedRef(string path);

Получает Resource из cache либо null, не читая отсутствующий там файл. Может вернуть тот же C# wrapper, который уже использует другой код; это подтверждено ReferenceEquals. Ранний Dispose такой ссылки делает другие managed aliases недействительными. Согласуйте общий срок жизни вместо независимого освобождения каждого alias. Это не clone и не обновление с диска.

public static string[] GetDependencies(string path);

Собирает объявленные внешние зависимости через format loaders, не рекурсивное дерево загруженных объектов. Элемент может быть обычным путём или записью UID::тип::fallback; публичная обёртка не добавляет тип, поэтому среднее поле может быть пустым. Не передавайте такую составную строку целиком в файловый API. Пустой список не отличает отсутствие зависимостей от неподдержанного/ошибочного формата. Импорт, UID remap и custom loaders могут менять представление.

public static string[] GetRecognizedExtensionsForType(string type);

Запрашивает расширения у зарегистрированных loaders для имени engine-типа, не C# System.Type. Пустое имя может запросить общий набор. Имена без точки; возможны дубликаты и изменения после регистрации плагинов. Список не доказывает существование, импортированность или корректность отдельного файла.

public static string GetResourceType(string path);

Спрашивает loaders о типе ресурса по пути; это metadata query и может выполнять I/O. Не является C# приведением результата или гарантией полной загрузки. Для custom C# ресурса сообщаемый engine base type может отличаться от имени managed-класса. Пустая строка означает отсутствие распознанного типа, не отдельный подробный Error.

public static long GetResourceUid(string path);

В игровом runtime запрашивает reverse registry ResourceUid по нормализованному пути; не сканирует UID-заголовок любого файла. Для неизвестного пути возвращает InvalidId. Устаревшая reverse-запись после SetId/RemoveId может дать ID без актуального HasId(). Редактор использует другой путь через loaders; редакторное сканирование здесь не проверялось.

public static bool HasCached(string path);

Проверяет запись пути в resource cache после нормализации пути. Не загружает файл, не проверяет свежесть данных, наличие файла и фактический тип. Удерживаемый ресурс может оставаться в cache после удаления/изменения файла. Не обещает, что запись сохранится после освобождения всех владельцев.

public static string[] ListDirectory(string directoryPath);

Перечисляет непосредственные имена каталогов и распознаваемых ресурсов, не все физические файлы и не рекурсивное дерево. Каталоги оканчиваются /; sidecars .import/.remap/.uid сводятся к исходному имени, результат сортируется и устраняет повторы. Распознавание расширения не доказывает корректный parsing: в тесте присутствовал некорректный .rdata. Пустой массив также возможен при ошибке открытия/начала обхода. Export/import backend здесь не выполнялись.

public static Resource Load(string path, string typeHint = "", ResourceLoader.CacheMode cacheMode = ResourceLoader.CacheMode.Reuse);

Синхронно получает Resource через выбранный формат и режим кэша; при неудаче возможны null и диагностика движка. Это не создание Entity: PackedEntity ещё нужно Instantiate()/AddChild(). Reuse может вернуть тот же native объект и тот же C# wrapper; не Dispose общий wrapper, пока другие ссылки его используют. На проверенном text backend Ignore создаёт независимый основной ресурс, но переиспользует внешние зависимости; IgnoreDeep читает их независимо. Replace может обновить удерживаемый объект совместимого типа, а ReplaceDeep также обновляет внешние зависимости. Изменения файла не обновляют Reuse автоматически. Поведение собственного loader должно учитывать cacheMode.

public static T Load<T>(string path, string typeHint = null, ResourceLoader.CacheMode cacheMode = ResourceLoader.CacheMode.Reuse) where T : class;

Синхронно получает Resource через выбранный формат и режим кэша; при неудаче возможны null и диагностика движка. Это не создание Entity: PackedEntity ещё нужно Instantiate()/AddChild(). Reuse может вернуть тот же native объект и тот же C# wrapper; не Dispose общий wrapper, пока другие ссылки его используют. На проверенном text backend Ignore создаёт независимый основной ресурс, но переиспользует внешние зависимости; IgnoreDeep читает их независимо. Replace может обновить удерживаемый объект совместимого типа, а ReplaceDeep также обновляет внешние зависимости. Изменения файла не обновляют Reuse автоматически. Поведение собственного loader должно учитывать cacheMode. Generic обёртка только приводит native результат к T. Она не выводит typeHint из T; несовпадение может дать InvalidCastException, не null.

public static Resource LoadThreadedGet(string path);

Собирает один результат ранее принятой пользовательской заявки. До завершения может ждать и блокировать вызывающий поток; в обычном flow сначала дождитесь Loaded. После Failed также завершите lifecycle заявки, ожидая null и диагностику loader. Один вызов уменьшает счётчик заявок; при двух одинаковых Request нужны два сбора. После полного сбора status становится InvalidResource. Без заявки/после её потребления возвращает null; полученный Resource может быть общим cached wrapper.

public static ResourceLoader.ThreadLoadStatus LoadThreadedGetStatus(string path, Reckfell.Collections.Array progress = null);

Возвращает статус заявки по исходной строке path, а не произвольному эквивалентному OS path. InvalidResource также означает, что заявки ещё не было либо все её результаты собраны; это не только несуществующий файл. Переданный progress Array перезаписывается одним числом 0…1, стирая прежние элементы; выделяйте собственный массив. Статус Loaded, не одна величина progress, разрешает обычный сбор. Не блокируйте главный поток циклом без кадров.

public static Error LoadThreadedRequest(string path, string typeHint = "", bool useSubThreads = false, ResourceLoader.CacheMode cacheMode = ResourceLoader.CacheMode.Reuse);

Запускает/получает пользовательскую заявку на фоновую загрузку Resource. Error.Ok не означает готовый результат: опрашивайте LoadThreadedGetStatus() между кадрами, затем соберите через LoadThreadedGet(). Используйте одну и ту же строку path во всех вызовах. Повтор той же строки может разделить token, увеличив число ожидаемых Get; один Get не очищает две заявки. Не рассчитывайте, что новые flags повторного Request перенастроят существующий token. Это не async C# Task, отмена или система стриминга мира.

public static void RemoveResourceFormatLoader(ResourceFormatLoader formatLoader);

Удаляет первую регистрацию указанного instance. Если Add вызван дважды, один Remove оставляет другую запись; проверено. Не удаляет файлы и не является очисткой всех cached ресурсов. Удалите все свои регистрации перед Dispose собственного loader; отсутствующий/null instance даёт диагностику.

public static void SetAbortOnMissingResources(bool abort);

Меняет глобальную политику отказа при отсутствующих зависимостях, не локальную настройку одного Load. Во встроенном text loader false может разрешить продолжение с отсутствующей зависимостью, но не обещает пригодный ресурс или исправление схемы. Abort относится к отказу загрузки, не обещанию аварийно завершить игру. Не отключает все ошибки parsing и не отменяет фоновые заявки. В этом проходе поведение проверено по исходникам, не на повреждённых зависимостях.