ObjectPlacementService

Scene-free object placement service. Owns the object build/place flow without requiring a scene node. Wraps [PlacementBuildOrchestrator.run_build] directly so host-path object placement is scene-free. Lifecycle: var service := ObjectPlacementService.new() service.configure(states, settings, indicator_context) service.create_preview(placeable) var report := service.try_build(placeable, PlacementEnums.PlacementType.SINGLE) service.clear_preview() Hosted by GridPlacementHost via PlacementServiceGroup.

Source: addons/grid_placement/services/object_placement_service.gd

Syntax

class ObjectPlacementService extends RefCounted

Members

Name	Kind	Summary
cells	Property	Result of simulate_ordered_cells(): the accepted cells in commit order and their world footprint rects (parallel arrays).
rects	Property
capped	Property	True when the placement cap or a work budget stopped the scan with input cells still unconsidered.
scanned	Property	Cells iterated.
validated	Property	Seats fully rule-validated.
tiles	Property	Seat-relative collision tiles plus the seat they were measured at.
seat	Property
placeable	Property	Verdict on one ordered-sim candidate seat. Per-run invariants and state of simulate_ordered_cells().
map	Property
preview	Property
manager	Property
anchor_mode	Property
footprint	Property
relative_tiles	Property
measure_seat	Property
tile_overlap	Property
committed_tiles	Property
can_validate	Property
entry_ignore	Property
profile_ignore	Property
live_rotation	Property
anchor_offset	Property
setup_done	Property
accepted_union	Property	Tiles taken by accepted seats (tile-overlap maps only).
SERVICE_NAME	Field	SSOT for this service's gameplay-facing issue messages. Both the service and its tests reference these constants so the player-facing text and the service tag never drift apart.
MSG_INDICATOR_MANAGER_MISSING	Field
SIM_MIN_VALIDATIONS	Field	Ordered-sim work budgets (see simulate_ordered_cells()). A run validates at most SIM_MAX_VALIDATIONS seats and iterates at most maxi(SIM_MIN_SCANNED, validations SIM_SCANNED_PER_VALIDATION) cells, where validations = mini(SIM_MAX_VALIDATIONS, maxi(SIM_MIN_VALIDATIONS, cap SIM_VALIDATIONS_PER_PLACEMENT)) and cap is the placement cap (or the default drag budget when uncapped). The floor covers dense legit gestures with margin (a 60x60 smithy drag needs ~276 validations for 7 accepts); the ceiling bounds hostile fields. Deterministic counts, so preview and commit truncate identically.
SIM_VALIDATIONS_PER_PLACEMENT	Field
SIM_MAX_VALIDATIONS	Field
SIM_MIN_SCANNED	Field
SIM_SCANNED_PER_VALIDATION	Field
set_preview_diagnostic_sink	Method
configure	Method
set_world_registry	Method
get_surface_registry	Method
set_surface_registry	Method
get_preview_surface_mount	Method
set_states	Method
dispose	Method
get_runtime_issues	Method
create_preview	Method
get_preview	Method
get_last_report	Method
clear_preview	Method
try_build	Method
manager	Property
missing_report	Property
active_preview	Property
missing	Property
seat_map	Property
has_pose	Property
pose_degrees	Property
rig	Property
rig_transform	Property
rig_logical_degrees	Property
preview_rotation	Property
built	Property
manager	Property
preview_local	Property
surface_resolved	Property
surface_issues	Property
surface_report	Property
surface_mount	Property
anchor_mode	Property
entry_ignore	Property
profile_ignore	Property
authority_report	Property
ctx	Property
simulate_ordered_cells	Method
sim	Property
run	Property
effective_cap	Property
validation_budget	Property
scan_budget	Property
saved_local	Property
saved_projection	Property
capped	Property
candidates	Property
retry_cells	Property
accepted_before	Property
cell	Property
append_batch_collision	Method
effective_drag_cap	Method
budget	Property
footprint	Property
tiles	Property
resolve_surface_placement	Method
update_surface_preview	Method
manager	Property
targeting_state	Property
category_rules	Property
lifecycle	Property
unregister_placed_node	Method
get_save_metadata	Method
update_placed_node	Method
snapshot	Property
node	Property
mount	Property
action_data	Property