How one 3D hover resolved: which record won, through which pick authority, over which volume, and where it sat in the near-to-far ranking. Built from the same registry queries the hover itself used — no second ray, no private field — so a demolition can name its victim and the geometry that claimed it. Diagnostic-only: to_dict() is the JSON-safe form the attempt trace and the failure block read.
Source: addons/grid_placement/services/placement_pick_decision.gd
Syntax
class PlacementPickDecision extends RefCountedMembers
| Name | Kind | Summary |
|---|---|---|
RAY_HIT | Field | The ray's narrow phase engaged the winner. |
COLUMN_FALLBACK | Field | The ray missed and the aimed column answered. |
NO_LIVE_RAY | Field | No pointer ray exists (keyboard or injected seat). |
NO_RECORD | Field | Nothing was hovered. |
BROAD_PHASE_NOTE | Field | Broad phase → narrow phase, in the registry's own order. |
decision | Property | Which authority resolved the hover. See the constants above. |
pick_margin | Property | Registry pick growth (PlacementWorldRegistry.PICK_MARGIN_3D). |
winner_record_id | Property | |
winner_kind | Property | Narrow-phase kind that decided the winner (PlacementWorldRegistry.classify_pick_3d()). |
winner_pick_volume | Property | The grown volume the winner was picked through, and the two bounds it was built from, so a mesh-derived box is never read as a mesh triangle. |
winner_evidence | Property | |
winner_mesh_bounds | Property | |
winner_rank | Property | Near-to-far position of the winner, or -1 when it was not ranked. |
winner_hit_distance | Property | |
winner_entry_distance | Property | |
behind | Property | Records the winner stands in front of, in ranking order. |
capture | Method | |
result | Property | |
record | Property | |
root | Property | |
candidate | Property | |
is_ray_hit | Method | |
to_dict | Method |
Tutorials built on Grid Placement
- Godot multiplayer grid placement: one host, four sessions
- Godot 2D grid building system: paint, place, save
- Godot 3D grid building system: the runtime loop
- Godot 4 grid-building plugins: build mode vs editor tools
- 3D room placement in Godot: build rooms and stack storeys
- 3D grid placement in Godot 4: full setup tutorial
- Snap to a TileMap in Godot: 2D grid placement
- How to make a farming system in Godot
- How to snap objects to a 3D grid in Godot