PlacementValidation3D

Read-only 3D placement validity policy seam. Runtime placement and development proof tooling consume this evaluator through one shared policy implementation. Everything here is static and side-effect free: callers supply explicit read-only state and receive typed reasons, per-cell evidence, and the resolved support facts used by preview/commit.

Source: addons/grid_placement/systems/building/3d/placement_validation_3d.gd

Syntax

class PlacementValidation3D extends RefCounted

Members

Name	Kind	Summary
GRID_BOUND	Field	Typed rejection reasons for one placement attempt. GridMap components are only addressable inside +/-2^20; cells at or past the bound (including the INT_MAX MISS sentinel) fail closed here so no GridMap call ever sees them.
SPAN_OVERLAP_EPSILON	Field	Minimum span penetration (meters) that counts as an EDGE overlap. Touching end-to-end (zero-area contact) stays legal; true overlaps penetrate by decimeters, so a millimeter guard only absorbs float dust.
reasons	Property	Structured result of one validation attempt. Bitmask of [enum Reason] flags.
issues	Property	Human-readable aggregate issue strings, layered on [member reasons].
cell_issues	Property	CELL-only projection: footprint cell -> blocking issue strings.
footprint_cells	Property	Footprint cells the CELL policy checked.
has_grid_surface	Property	True once the column survey recorded [member grid_min_surface] and [member grid_max_surface] (0.0 when a bound had no ground).
grid_min_surface	Property
grid_max_surface	Property
support_mode	Property	[enum ObjectPlacementSettings3D.SurfaceSupportMode], or -1 before the support stage ran.
support_authority	Property	Which policy decided support: &"gridmap", &"gridmap_fallback", &"physics", &"physics_required_unavailable", or empty before the support stage ran.
support	Property	Physics support evaluation, or null when physics was not sampled.
conflict_id	Property	First conflicting world record id, empty without a world conflict.
conflict_cells	Property
snap_partner_dirs	Property	Neighbor directions holding a compatible snap partner.
unsupported_cells	Property	Footprint cells lacking the attachment/wall/roof support they need.
cleared_decor	Property	Live clearable-decor roots the commit removes before instantiating.
evidence	Property	Read-only Dictionary projection of the typed evidence for diagnostics and proof tooling. Keys appear only for evidence that was recorded.
has_physics_anchor	Method
is_valid	Method
has_reason	Method
reject	Method
reject_at	Method
add_cell_issue	Method
cell_issue_map	Method
grid	Property	Read-only context for one validation attempt.
settings	Property
world_3d	Property	Physics world used only when surface support mode opts into physics.
world_registry	Property
preview_yaw_steps	Property
mounts	Property	Committed GRID mounts the attempt is checked against.
validate_cell	Method
result	Property
cells	Property
profile	Property
occupy_columns	Property
survey	Property
min_surface	Property	GridMap surface range of one CELL footprint, read by the support stage.
max_surface	Property
missing_ground	Property
survey	Property
floating_columns	Property
key	Property
occupant	Property
existing	Property
surface	Property
top_row	Property
mount	Property
root	Property
support_mode	Property
use_grid_authority	Property
required	Property
samples	Property
support	Property
settings	Property
requires_ground	Property
surface	Property
conflict_cells	Property
first_conflict	Property
conflict	Property
snap_issue	Property
lacking	Property
partner_dirs	Property
lacking_support	Property
lacking_span	Property
validate_cell_map	Method
validate_edge	Method
result	Property
edge_key	Property
span_issue	Property
profile	Property
span_support_issue	Property
cell_key	Property
span	Property
unsupported	Property
labels	Property
cells	Property
grid	Property
world_y	Property
local_min	Property
local_max	Property
local	Property
local_span	Property
run_axis	Property
cell_size	Property
min_cell	Property
radius	Property
half	Property
cell	Property
local_center	Property
cell_rect	Property
out	Property
mount	Property
fam	Property
overlay_columns_for_family	Method
out	Property
is_same_type_edge_replace	Method
occupying_family	Property
profile	Property
occupant	Property
mount	Property
occupant_group	Property
candidate	Property
node	Property
mount	Property
other	Property
empty	Property
size	Property
measured	Property
center	Property
local	Property
yaw	Property
validate_face	Method
result	Property
face_key	Property
height_band	Property
occupancy_key	Property
profile	Property
family	Property
validate_top	Method
result	Property
top_key	Property
profile	Property
existing_family	Property
can_stack	Property
deck	Property
walls	Property
pair	Property
edge_key	Property
family	Property
validate_corner	Method
result	Property
key	Property
profile	Property
validate_move_drop	Method
profile	Property
edge_key	Property
edge_issues	Property
face_key	Property
cell_issues	Property
cells	Property
key	Property
east	Property
west	Property
east_west	Property
north	Property
south	Property
north_south	Property
empty	Property
east	Property
west	Property
east_west	Property
north	Property
south	Property
north_south	Property
empty	Property
settings	Property
settings	Property
topology	Property
candidates	Property
cell_size	Property
center	Property
point	Property
TOUCH_EPSILON	Field
node	Property
box	Property
host	Property
x_neighbor	Property
z_neighbor	Property
x_cells	Property
z_cells	Property
x_yaw	Property
z_yaw	Property
node	Property
components	Property
instance	Property
mount	Property
compatible_neighbor_dirs	Method
dirs	Property
WALL_SUPPORT_RADIUS	Field	Chebyshev radius (cells) of the wall-support zone for CELL pieces with [member PlacementSnapProfile3D.require_wall_support]. The house roof slopes span ~7.6 m from a 2x2 anchor, so the walls under the eaves sit up to 2 cells from the anchor cells; radius 2 keeps the canonical deck + wall ring green while a bare deck reads red.
footprint_cells_without_wall_support	Method
lacking	Property
ROOF_SPAN_RADIUS	Field	Chebyshev radius (cells) of the roof-span zone for CELL pieces with [member PlacementSnapProfile3D.require_roof_span]. Roof slope meshes span ~7.6 m from a 2x2 anchor, so a gable capping the span end sits up to 3 cells from the nearest roof column; radius 4 keeps the canonical house green while a gable in a roofless ring reads red.
footprint_cells_without_roof_span	Method
lacking	Property
zone	Property
unions	Property
anchor_key	Property
yaw	Property
mount	Property
seen	Property
zone	Property
key	Property
footprint_cells_without_support	Method
lacking	Property
offsets	Property
neighbor	Property
neighbor_key	Property
reason	Property
issue	Property
lifecycle_reason_for	Method