Draft — Unreleased:This page is in active development. APIs, class names, and behavior may change before the release is finalized. Use it as a preview of what's coming — not as a stable integration target.
Placement entry for instancing scene objects into the game world. Carries a [member packed_scene] plus object-specific tool/rule overrides. The canonical replacement for [Placeable] (which is kept as a deprecated alias through 6.0 and removed in 6.1).
Source: addons/grid_placement/placement/placeable/scene_placement_entry.gd
Syntax
class ScenePlacementEntry extends PlacementEntryMembers
| Name | Kind | Summary |
|---|---|---|
display_name | Property | Display name for in-game reading. |
packed_scene | Property | Scene to instance when placed. |
profiles | Property | Placement profiles for grouping entries with shared behavior. Profiles carry their own [member PlacementProfile.placement_rules] and [member PlacementProfile.supported_object_tools] that layer into the three-tier rule/tool resolution. |
snap_profile_3d | Property | Optional 3D snap-category metadata (family + accept-list). Consulted by [ObjectPlacementService3D] when validating 3D placements; ignored in 2D. |
footprint_3d | Property | Footprint in GridMap cells (x, z) for 3D placement. The targeted cell is the footprint's minimum corner; validation checks occupancy, ground, and the elevation threshold across every covered column. Ignored in 2D. |
tool_override_mode | Property | How this entry's [member tool_overrides] interact with its profiles' [member PlacementProfile.supported_object_tools]. See [enum ToolOverrideMode]. |
tool_overrides | Property | Tools added or removed depending on [member tool_override_mode]. - [enum INHERIT]: ignored (profiles provide the full list) - [enum REPLACE]: this list IS the full tool set - [enum ADD]: these are unioned with profile tools - [enum REMOVE]: these are subtracted from profile tools |
get_build_costs | Method | |
costs | Property | |
get_display_name | Method | |
get_load_data | Method | |
dictionary | Property | |
load_resource | Method | |
entry | Property | |
uid_str | Property | |
uid_int | Property | |
file_path | Property | |
get_packed_root_name | Method | |
resolve_object_tools | Method | |
tools | Property | |
get_editor_issues | Method | |
issues | Property | |
valid_rule_count | Property | |
get_runtime_issues | Method | |
issues | Property | |
valid_rule_count | Property | |
UID | Field | |
FILE_PATH | Field |
Source
addons/grid_placement/placement/placeable/scene_placement_entry.gd
Plugin docs root:gdscript/plugins/grid_placement_dev/docs