ObjectPlacementService3D

Scene-free 3D object placement service. Owns preview/commit orchestration for 3D sessions. CELL validity is delegated to [PlacementValidation3D], including optional physics-backed surface support; EDGE/FACE/socket policy remains on the same shared validation seam.

Source: addons/grid_placement/systems/building/3d/object_placement_service_3d.gd

Syntax

class ObjectPlacementService3D extends RefCounted

Members

Name	Kind	Summary
object_placed	Signal
preview_validity_changed	Signal
active_entry_changed	Signal
MISS	Field
GHOST_ALPHA_SCALE	Field	Ghost tint alpha scale (applied to the ghost wash colors). Below 1.0 so transient overlaps with committed geometry blend softly instead of clipping into hard bands.
NO_GROUND	Field
GHOST_VALID_NEUTRAL	Field	Neutral wash for a valid pending placement. The ghost shows WHERE the object will land (guide: "Preview object vs mount indicator"); the verdict lives on the per-cell mount indicators, not in a full-volume green slab that hides the piece and washes against the ground. Blocked placements keep the invalid-color wash, so HIDDEN presentation (no quads) still reads valid (neutral ghost) vs blocked (red ghost).
set_preview_diagnostic_sink	Method
set_decision_diagnostic_sink	Method
configure	Method
configure_lifecycle	Method
get_settings	Method
is_configured	Method
set_active_entry	Method
get_active_entry	Method
update_preview_cell	Method
is_preview_valid	Method
get_preview_cell	Method
clear_preview	Method
rotate_preview	Method
get_preview_yaw_steps	Method
preview_yaw_degrees	Method
validate_cell_map	Method
validate_cell	Method
position	Property
authority	Property
basis	Property
normal	Property
profile	Property
dirs	Property
footprint	Property
try_place_report	Method
populate_surface_metadata	Method
authority	Property
cells	Property
max_surface	Property
surface_name	Property
surface	Property
try_place_at	Method
is_cell_occupied	Method
get_placed_node	Method
get_family_at	Method
get_placed_count	Method
is_edge_occupied	Method
is_corner_occupied	Method
is_face_registered	Method
is_face_occupied	Method
validate_edge	Method
update_preview_edge	Method
try_place_at_edge	Method
try_place_report_edge	Method
validate_face	Method
update_preview_face	Method
try_place_at_face	Method
try_place_report_face	Method
validate_corner	Method
update_preview_corner	Method
try_place_at_corner	Method
try_place_report_corner	Method
lifecycle	Property
instance_id	Property
projections	Property
provider_faces	Property
projections	Property
provider_faces	Property
profile	Property
occupy_columns	Property
key	Property
edge_key	Property
profile	Property
face_key	Property
key	Property
face_key	Property
occupancy_key	Property
world_aabb_for_mount	Method
unregister_placed_node	Method
unregister_placed_node_local	Method
local_snapshot	Property
world_record	Property
snapshot	Property
update_placed_node	Method
old_grid_cell	Property
new_grid_cell	Property
profile	Property
family	Property
cells	Property
height_band	Property
dispose	Method
clear_placement_registries	Method
snapshot_placement_state	Method
restore_placement_state	Method
rehydrate_cell_object	Method
yaw_steps	Property
profile	Property
family	Property
cells	Property
mount	Property
occupancy_evidence	Property
mount	Property
rehydrate_corner_object	Method
mount	Property
rehydrate_face_object	Method
mount	Property
height_band	Property
get_save_metadata	Method
get_placed_nodes	Method
cell_from_world_position	Method
cell_from_world_point	Method
sink	Property
entry_path	Property
definition_key	Property
context	Property