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.
Configuration for [ObjectPlacementService3D]: preview tint colors and the v1 ground/validation knobs.
Source: addons/grid_placement/systems/building/3d/object_placement_settings_3d.gd
Syntax
class ObjectPlacementSettings3D extends ResourceMembers
| Name | Kind | Summary |
|---|---|---|
valid_color | Property | Tint applied to the preview ghost when the pending placement is valid. |
invalid_color | Property | Tint applied to the preview ghost when the pending placement is invalid. |
surface_offset | Property | Extra vertical fudge added on top of the resolved surface (the mesh AABB top of the highest occupied cell in the column). Usually 0 — the AABB scan already accounts for slab vs full-block item heights. |
require_ground_cell | Property | When true, every footprint column must resolve ground within the scan range (i.e. you can only place on built floor/terrain). |
max_elevation_delta | Property | Maximum allowed surface-height difference (world units) across a footprint. Beyond this the placement is rejected as "too steep". |
surface_scan_max_y | Property | Highest GridMap y layer probed when resolving a column's surface. |
surface_scan_min_y | Property | Lowest GridMap y layer probed when resolving a column's surface. |
Source
addons/grid_placement/systems/building/3d/object_placement_settings_3d.gd
Plugin docs root:gdscript/plugins/grid_placement_dev/docs