Skip to content

Class

TerrainPlacementService3D

Generated GDScript class reference for GridPlacement.TerrainPlacementService3D.

Status
Draft
Version
v6.0
Updated
Development docs generated from GDScript source

This is unreleased documentation in active development. APIs, class names, and behavior may change before the final release.

Source: addons/grid_placement/systems/building/terrain/terrain_placement_service_3d.gd

Syntax

class TerrainPlacementService3D extends TerrainServiceContract

Members

NameKindSummary
terrain_cell_changedSignalFires on every GridMap cell edit made through this service (paint, replace, or erase — erase reports [constant GridMap.INVALID_CELL_ITEM]). Games can connect to re-validate placed objects after terrain edits; the policy stays with the game, placement-time validation remains authoritative.
fail_on_identical_repaintPropertyWhen true, repainting identical terrain fails loudly (legacy behavior). Default false: identical repaints read as valid placements that changed nothing — silent, with PlacementReport.placed left null and a "No tiles placed" note for logs. Rule rejections and config errors always fail loudly regardless of this flag.
supported_dimensionsMethod
set_statesMethod
try_place_terrain_by_nameMethod
resolved_mapProperty
issuesProperty
blockedProperty
noopProperty
itemProperty
reportProperty
validate_terrain_cellMethod
resolved_mapProperty
itemProperty
previous_itemProperty
issuesProperty
resolved_mapProperty
itemProperty
entryProperty
ctxProperty
resultsProperty
paint_cellsMethod
resolved_mapProperty
itemProperty
entryProperty
paintedProperty
rejectedProperty
strict_reportProperty
noopProperty
empty_reportProperty
reportProperty
erase_cellsMethod
try_demolish_terrainMethod
resolved_mapProperty
terrain_nameProperty
dataProperty
entryProperty
erase_reportProperty
first_cellProperty
countProperty
start_terrain_drag_3dMethod
is_terrain_dragging_3dMethod
cancel_terrain_drag_3dMethod
preview_terrain_drag_3dMethod
complete_terrain_drag_3dMethod
cellsProperty
take_terrain_drag_cells_3dMethod
capProperty