ResourceFormatLoader

public ResourceFormatLoader();

Creates an unregistered handler. Implement a subclass with callbacks and add its instance to ResourceLoader before the first read.

public virtual bool _Exists(string path);

Checks resource existence. Without an override the native handler uses FileAccess. File presence does not establish valid contents or a successful later read.

public virtual string[] _GetClassesUsed(string path);

Reports class names used by file contents. Without an override the native handler adds the nonempty base resource-type result. Return names, not object instances.

public virtual string[] _GetDependencies(string path, bool addTypes);

Lists external file references. Each entry is a path or uid::type::fallback_path; the type section is empty when addTypes=false. Trailing empty sections are omitted. Listing neither loads dependencies nor rewrites the file.

public virtual string[] _GetRecognizedExtensions();

Lists file extensions the handler can read, such as rfnote without a dot. This informs loader selection rather than validating each file’s contents.

public virtual string _GetResourceScriptClass(string path);

Reports the resource’s named script class separately from its built-in base type. It neither registers the class nor creates an object.

public virtual string _GetResourceType(string path);

Determines the built-in resource type for a path. Resource is valid for a supported custom C# resource. A C# class name does not by itself become a native ClassDB type.

public virtual long _GetResourceUid(string path);

Reads a persistent UID from a custom format. Overriding enables custom UID support; do not add an always--1 stub when the standard .uid mechanism is intended. Without an override the native handler reads path + .uid; creating that file belongs to the editor workflow, not this read.

public virtual bool _HandlesType(StringName type);

Reports support for a base type. Default native path recognition uses this callback for a nonempty type hint. Without an override no type support is declared.

public virtual Variant _Load(string path, string originalPath, bool useSubThreads, int cacheMode);

Reads and validates the file after handler selection. Return a Resource in a Variant on success, or an integer Error on failure. Error.Ok in place of an object is not success: any integer is treated as an error code and produces no resource. Bound sizes before allocation.

public virtual bool _RecognizePath(string path, StringName type);

Determines whether the handler suits a path and type hint. Without an override the native implementation matches extension suffixes case-insensitively and uses _HandlesType, not _GetResourceType, for a nonempty type. An override replaces that check.

public virtual Error _RenameDependencies(string path, Reckfell.Collections.Dictionary renames);

Rewrites external references in the file using the mapping and persists the result. Mutating only the supplied Dictionary is insufficient. Without an override the native handler returns Ok without rewriting anything; that code alone does not prove references were updated.