Skip to content

Placeable

Display name for in-game reading.

display_name: StringName

Display name for in-game reading.

icon: Texture2D

Texture icon for UI elements.

packed_scene: PackedScene

Scene to instance when placed.

tags: Array[CategoricalTag]

Category tags for grouping placeables.

placement_rules: Array[PlacementRule] = []

Placement rules specific to this placeable. If [member ignore_base_rules] is false, these rules are combined with base rules from [member GBSettings.placement_rules].

ignore_base_rules = false

When true, skips base placement rules from [member GBSettings.placement_rules] and uses ONLY the rules defined in [member placement_rules].

Use cases: - false (default): Inherit common rules + add object-specific rules - true: Completely custom validation (e.g., special objects with unique placement logic)

func _init( p_packed_scene: PackedScene, p_placement_rules: Array[PlacementRule] )
func get_load_data( p_include_uid: bool ) -> Dictionary

Gets a serialized reference to the placeable for both the FILE_PATH and the file path as a backup

static func load_resource( p_load_data: Dictionary ) -> Placeable

Function to help location the placeable using FILE_PATH or file path as backup and returning it

func get_packed_root_name( ) -> StringName

Gets the name of the root node in the packed_scene

func get_editor_issues( ) -> Array[String]

Returns an array of issues that were found in the placeable

func get_runtime_issues( ) -> Array[String]

Returns all found runtime issues including the editor issues as a baseline.

func _validate_property( property: Dictionary )

In editor validation

addons/grid_building/placement/placeable/placeable.gd


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