Smooth/free 3D placement service for exact world-position placement. 3D counterpart of [SmoothPlacementService]. Provides preview, occupancy validation via [SmoothOccupancyRegistry3D], and commit at arbitrary [Vector3] world positions.
Source: addons/grid_placement/services/smooth_placement_service_3d.gd
Syntax
class SmoothPlacementService3D extends RefCountedMembers
| Name | Kind | Summary |
|---|---|---|
occupancy_registry | Property | The smooth occupancy registry. Must be configured before placement. |
world_registry | Property | Shared committed-placement authority for this level. A 3D smooth commit is rejected until this registry is configured. |
attachment_settings | Property | Shared 3D placement settings authority. Host-owned services bind the same resource used by GRID; null preserves standalone historical OPTIONAL behavior. |
occupied_mask | Property | Optional physics blocker mask. Physics is validation evidence only; blocked external objects never enter the placement-world registry. |
ground_collision_mask | Property | Optional Ground-collider ray. 0 keeps the supplied Y (free SMOOTH). |
ground_ray_origin_y | Property | |
ground_ray_end_y | Property | |
socket_registry | Property | World-space sockets. Parallel to GRID EDGE, never cell-keyed. |
last_resolve | Property | Last pose resolve from preview/commit (position, yaw, socket_id, snapped). |
objects_parent | Property | Parent node for committed placements. Must be set before [method try_place]. |
lifecycle_allocator | Property | Plugin-owned allocator for attempt/reservation IDs configured by the host. |
world_id | Property | World and session identifiers surfaced on the canonical lifecycle result. |
session_id | Property | |
set_preview_diagnostic_sink | Method | |
configure | Method | |
get_last_report | Method | |
create_preview_at | Method | |
move_preview_to | Method | |
rotate_preview | Method | |
validate_at | Method | |
try_place | Method | |
lifecycle | Property | |
world_aabb | Method | |
rehydrate_record | Method | |
footprint | Property | |
position | Property | |
yaw | Property | |
smooth_projection | Property | |
projection | Property | |
consumed_id | Property | |
registered | Property | |
unregister_placed_node | Method | |
instance_id | Property | |
consumed_id | Property | |
update_placed_node | Method | |
old_record | Property | |
old_transform | Property | |
occupancy_snapshot | Property | |
consumed_id | Property | |
instance_id | Property | |
entry | Property | |
updated | Property | |
old_proj | Property | |
prev | Property | |
clear_preview | Method | |
apply_preview_validity | Method | |
get_preview | Method | |
has_preview | Method | |
result | Property | |
grounded | Property | |
profile | Property | |
consume | Property | |
query | Property | |
hit | Property | |
posed | Property | |
profile | Property | |
consumed | Property |