Skip to content

Class

PlacementAttemptTrace

Generated GDScript class reference for GridPlacement.PlacementAttemptTrace.

Status
Current
Version
v6.3.2
Source updated
2026-11-06
Generated on
2026-11-12

6.3. These pages document the 6.3 release, where placeable is now entry (what changed) and PlacementOwner is deprecated (migration). Still on 6.2? Your version's guides ship inside the plugin itself, under addons/grid_placement/guides/; the 6.2 URLs on this site now redirect to this series.

One correlated placement attempt: what the player's input aimed at, what the preview showed, and what the dispatch actually committed or removed. The plugin already records each of those in its own surface — the positioner keeps the live pick, the session keeps the preview, the lifecycle result carries the outcome. What was missing is the join: a failure block could only show the pick, and a successful run showed the outcome with no memory of the input that produced it. This class builds that one bounded record from those surfaces, keyed by the attempt id the host mints. Read it through GridPlacementHost.get_last_attempt_trace() or, on a failure, as the origin block of PlacementFailureEvidence. It never casts a second ray, dispatches anything or invents a value: a field the live surfaces do not carry is left out, and PlacementFailureEvidence names it missing.

Source: addons/grid_placement/telemetry/placement_attempt_trace.gd

Syntax

class PlacementAttemptTrace extends RefCounted

Members

NameKindSummary
MAX_CANDIDATESFieldCandidate rows kept per attempt. Enough to show near/far ordering, bounded so a crowded level cannot turn one click into a payload.
TOLERANCE_NOTEFieldWhat the numbers mean, not just that they exist: preview and commit are the same seat, so their projected images must coincide. The original pointer and the committed cell center are NOT the same point — a cell snap moves the piece off the exact cursor, by up to half a cell.
PARITY_TOLERANCE_PXFieldDistance that counts as "the same pixel" in the preview->commit comparison.
REGISTRY_SIZE_KEYFieldInternal keys consumed by complete() and erased before the record is read: the registry size before the action, and the camera that aimed it.
CAMERA_KEYField
origin_beforeMethod
originProperty
targetingProperty
targetProperty
viewportProperty
positioner_3dProperty
is_3dProperty
completeMethod
traceProperty
lifecycleProperty
cameraProperty
beforeProperty
afterProperty
instance_idProperty
transformProperty
pickProperty
hitProperty
ray_originProperty
ray_dirProperty
candidatesProperty
rowsProperty
gridProperty
seatProperty
mapProperty
acquiredProperty
hoveredProperty
recordProperty
registry_2dProperty
record_2dProperty
originProperty
previewProperty
deltaProperty
cameraProperty
preview_pxProperty
commit_pxProperty
parity_pxProperty
preview_2dProperty
origin_2dProperty
delta_2dProperty
viewport_2dProperty