SmoothPlacementService3D

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 RefCounted

Members

Name	Kind	Summary
SERVICE_NAME	Field	Tag on this service's player-facing issues; the messages themselves are shared on [PlacementCommitAttempt].
position	Property	Where a cursor position resolves to: grounded, or snapped to a socket.
yaw	Property
socket_id	Property	Socket the pose consumes; empty when it did not snap.
snapped	Property
ground_miss	Property	The ground ray found nothing under an unsnapped pose.
socket_required_miss	Property	The entry must attach to a socket and none was in range.
is_ok	Method
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.
MOVE_REFUSAL_HAS_DEPENDENTS	Field	Refusal text for a provider that cannot move because other pieces are mounted on it. One wording for the one rule, shared with the GRID service and the host move/rotate gate.
last_resolve	Property	Last pose resolved by a preview, validation, or commit; null before any.
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_decor_resolver	Method
set_decor_clearer	Method
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
yaw	Property
resolved	Property
pos	Property
use_yaw	Property
conflict	Property
try_place	Method
attempt	Property
configuration_issue	Property
yaw	Property
resolved	Property
node	Property
node3d	Property
authored_scale	Property
instance_id	Property
footprint	Property
consumed_id	Property
bounds	Property
decor_snapshot	Property
world_record	Property
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
sockets_ok	Property
update_placed_node	Method
old_record	Property
old_transform	Property
occupancy_snapshot	Property
socket_snapshot	Property
consumed_id	Property
instance_id	Property
entry	Property
updated	Property
get_last_move_refusal	Method
clear_preview	Method
apply_preview_validity	Method
get_preview	Method
has_preview	Method
ground_y	Property
result	Property