Skip to content
Grid Building Docs

GBAssetResolver

Summary

Section titled “Summary”

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.

Methods

Section titled “Methods”
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

Source

Section titled “Source”

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.