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.