Skip to content

Class

PlacementValidation3D

Generated GDScript class reference for GridPlacement.PlacementValidation3D.

Status
Current
Version
v6.0
Source updated
2026-09-04
Generated on
2026-09-06

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

NameKindSummary
reasonsPropertyTyped rejection reasons for one placement attempt. Structured result of one validation attempt. Bitmask of [enum Reason] flags.
issuesPropertyHuman-readable aggregate issue strings, layered on [member reasons].
evidencePropertyRead-only evidence for preview/commit/diagnostic consumers.
cell_issuesPropertyCELL-only projection: footprint cell -> blocking issue strings.
is_validMethod
has_reasonMethod
cell_issue_mapMethod
gridPropertyRead-only context for one validation attempt.
settingsProperty
world_3dPropertyPhysics world used only when surface support mode opts into physics.
occupiedPropertyOccupied cells: column key (Vector3i) -> bool/node.
familiesPropertyColumn key -> family name for adjacent-snap checks.
world_registryProperty
preview_yaw_stepsProperty
facesProperty
face_occupancyProperty
face_familiesProperty
edgesProperty
cornersProperty
validate_cellMethod
resultProperty
cellsProperty
profileProperty
occupy_columnsProperty
min_surfaceProperty
max_surfaceProperty
missing_grid_groundProperty
cell_keyProperty
occupied_issueProperty
surfaceProperty
support_modeProperty
use_grid_authorityProperty
world_issueProperty
samplesProperty
supportProperty
has_physics_supportProperty
ground_issueProperty
surfaceProperty
steep_issueProperty
conflict_cellsProperty
first_conflictProperty
conflictProperty
conflict_issueProperty
partner_dirsProperty
snap_issueProperty
validate_cell_mapMethod
validate_edgeMethod
resultProperty
edge_keyProperty
profileProperty
cell_keyProperty
familyProperty
validate_faceMethod
resultProperty
face_keyProperty
height_bandProperty
occupancy_keyProperty
profileProperty
familyProperty
validate_cornerMethod
resultProperty
keyProperty
profileProperty
settingsProperty
settingsProperty
topologyProperty
candidatesProperty
hostProperty
x_neighborProperty
z_neighborProperty
x_cellsProperty
z_cellsProperty
x_yawProperty
z_yawProperty
nodeProperty
componentsProperty
instanceProperty
mountProperty
has_compatible_neighborMethod
compatible_neighbor_dirsMethod
dirsProperty
neighborProperty
neighbor_keyProperty
issueProperty