BrushCoordinator | Grid Placement Docs

Scene-free brush lifecycle coordinator. Gives the brush coordination concern its own single-responsibility home. Owns the [BrushState] instance and coordinates the start/complete/anchor/commit/cancel/paint sequence for terrain brushes. Mirrors the pattern of [TerrainPlacementService2D] (instance + configure) and [PlacementInputHandler] (instance + configure) so the brush behavior is swappable per-game by subclassing. Signal emission is intentionally NOT done here — the coordinator returns a [PlacementReport] for every paint attempt, and the host's thin delegator emits the appropriate success/failed signal. This keeps the coordinator pure (no side effects beyond state mutation in [BrushState]). Usage: var coord := BrushCoordinator.new() coord.configure(states, terrain_service) coord.set_brush_shape(PlacementEnums.ObjectTool.LINE) coord.start_terrain_brush_drag() var report := coord.complete_terrain_brush()

Source: addons/grid_placement/systems/building/components/brush_coordinator.gd

Syntax

class BrushCoordinator extends BrushServiceContract

Members

Name	Kind	Summary
`brush_state`	Property	The brush state this coordinator owns. Exposed for [PlacementInputHandler], which needs to read [member BrushState.is_terrain_dragging] etc. to resolve InputIntents.
`max_brush_cells`	Property	Per-action cell cap forwarded to [BrushShapeGenerator]. Host syncs this from [member PlacementSettings.max_terrain_brush_cells].
`configure`	Method
`set_states`	Method
`set_brush_shape`	Method
`start_terrain_brush_drag`	Method
`complete_terrain_brush`	Method
`complete_terrain_brush_dry`	Method
`complete_terrain_brush_immediate`	Method
`complete_terrain_drag_only`	Method
`anchor_pending_terrain`	Method
`commit_pending`	Method
`cancel_pending`	Method
`start_object_line_drag`	Method
`complete_object_line_drag`	Method
`is_object_line_dragging`	Method
`cancel_all`	Method
`is_terrain_dragging`	Method
`is_pending`	Method
`get_brush_shape`	Method
`get_drag_start`	Method
`get_pending_cells`	Method
`get_object_line_drag_start`	Method
`get_brush_state`	Method
`paint_with_current_brush`	Method
`set_terrain_context`	Method
`supported_dimensions`	Method
`get_runtime_issues`	Method
`set_session_brush_state`	Method