EditorImportPlugin

public Error AppendImportExternalResource(string path, Reckfell.Collections.Dictionary customOptions = null, string customImporter = "", Variant generatorParameters = default);

Synchronously import an additional external resource during the current import process. Call from _Import(), for example for a generated image needing its own importer. Calls outside an import process are rejected; this is not a replacement for ordinary ReimportFiles().

public virtual bool _CanImportThreaded();

Allow the importer to run on parallel threads. The default is false. Return true only when the handler and its dependencies are thread-safe; do not access the editor tree from worker threads.

public virtual int _GetFormatVersion();

Return this importer's generated-data format version; the default is 0. Increment it for incompatible output changes. This is not the engine version or the plugin display name.

public virtual Reckfell.Collections.Array<Reckfell.Collections.Dictionary> _GetImportOptions(string path, int presetIndex);

Return preset settings as an array of dictionaries. Each requires name and default_value; property_hint, hint_string and usage are optional. The default_value type determines the property type; a range hint does not replace validation in _Import().

public virtual int _GetImportOrder();

Set importer execution order: smaller values run first. The default is 0. Use this for dependency ordering, not for choosing between importers for the same extension.

public virtual string _GetImporterName();

Return a unique stable importer identifier. It is stored in .import and used for reimport; _GetVisibleName() controls the display label.

public virtual bool _GetOptionVisibility(string path, StringName optionName, Reckfell.Collections.Dictionary options);

Determine whether an option is visible in the Import dock using current options. All options are visible by default. Hiding a field does not remove its value or replace validation in _Import().

public virtual int _GetPresetCount();

Return the number of initial option presets. The default is no presets (0); _GetImportOptions() must still return a valid array.

public virtual string _GetPresetName(int presetIndex);

Return a readable preset name for an index declared by _GetPresetCount().

public virtual float _GetPriority();

Set preference when automatically selecting an importer for a source extension. Higher values are preferred; the default is 1.0. The import system also uses an identifier already stored in .import and explicit per-file selection.

public virtual string[] _GetRecognizedExtensions();

Return source extensions without dots. Matching is case-insensitive. Prefer a custom extension to avoid capturing ordinary project files.

public virtual string _GetResourceType();

Return the class name of the imported resource, such as StandardMaterial3D. This is the output class, not the source extension.

public virtual string _GetSaveExtension();

Return the generated primary resource extension without a dot. For ordinary import, _Import() must save the resource at savePath + "." + this extension.

public virtual string _GetVisibleName();

Return a readable label for importer selection in the Import dock. Changing the label does not require changing the stable identifier.

public virtual Error _Import(string sourceFile, string savePath, Reckfell.Collections.Dictionary options, Reckfell.Collections.Array<string> platformVariants, Reckfell.Collections.Array<string> genFiles);

Convert the source file and save the primary resource at savePath + "." + _GetSaveExtension(). Validate input and return any read, conversion or save error. Populate platformVariants and genFiles only for variants and additional files actually created.