Skip to content

GBAssetResolver

Centralized asset resolver for loading Grid Building resources from folders.

Provides unified loading functionality for placeables, category tags, and other Grid Building assets. Supports both folder-based loading and individual asset arrays. Handles resource validation and provides consistent error handling across the plugin.

static func load_placeables

(

folder_path:

String

,

individual_placeables:

Array

[Placeable]

)

->

Array

[Placeable]

Loads placeables from a folder path, maintaining backward compatibility with PlaceableLoader

static func load_placeables_with_result

(

folder_path:

String

,

individual_placeables:

Array

[Placeable]

)

->LoadResult

Loads placeables and returns detailed LoadResult for advanced error handling

static func load_category_tags

(

folder_path:

String

,

individual_tags:

Array

[CategoricalTag]

)

->

Array

[CategoricalTag]

Loads category tags from a folder path
static func load_category_tags_with_result

(

folder_path:

String

,

individual_tags:

Array

[CategoricalTag]

)

->LoadResult

Loads category tags and returns detailed LoadResult for advanced error handling

static func load_placeable_sequences

(

folder_path:

String

,

individual_sequences:

Array

[PlaceableSequence]

)

->

Array

[PlaceableSequence]

Loads placeable sequences from a folder path
static func load_placeable_sequences_with_result

(

folder_path:

String

,

individual_sequences:

Array

[PlaceableSequence]

)

->LoadResult

Loads placeable sequences and returns detailed LoadResult for advanced error handling

static func load_assets_of_type

(

folder_path:

String

,

asset_type: GDScript

,

individual_assets:

Array

)

->LoadResult

Generic asset loading function that can load any resource type from a folder

static func _load_from_folder

(

folder_path:

String

,

asset_type: GDScript

)

->LoadResult
Internal helper to load assets from a folder
static func _load_single_asset

(

file_path:

String

,

expected_type: GDScript

,

tolerate_type_mismatch:

bool

)

-> SingleAssetResult

Internal helper to load a single asset file with tolerance for type mismatches

static func validate_folder_path

(

folder_path:

String

)

->

bool

Validates that a folder path exists and is accessible
static func get_folder_diagnostics

(

folder_path:

String

)

->

Dictionary

Gets diagnostic information about a folder’s contents

addons/grid_building/utils/gb_asset_resolver.gd


This API reference is automatically generated from the plugin source code. For implementation examples and usage guides, see the guides section.