Grid Placement

GridPositioner2D

AUTO-GENERATED FILE — DO NOT EDIT MANUALLY

Source: systems/grid_targeting/grid_positioner/grid_positioner_2d.gd

Version: 5.1

class_name: GridPositioner2D extends: Node2D

Summary

Godot-facing entry point for cursor/grid-position targeting.

Responsibilities:

  • Owns the Node lifecycle (_ready, _process) and engine signals.
  • Delegates all business logic to PositionerService2D via GridPositionerAdapter2D.
  • Acts as the DI boundary: dependencies are provided via resolve_gb_dependencies() / set_dependencies().

Non-responsibilities:

  • Does not contain placement/targeting rules. Those live in the pure services.
  • Does not manage global state. It consumes ModeState and service registry lookups.

Usage:

  • Add this Node to your scene.
  • Call resolve_gb_dependencies(container) (preferred) or set_dependencies(...) before first use.
  • Listen to cursor_moved / cursor_visibility_changed for UI/preview updates.

Signals

  • cursor_moved
  • cursor_visibility_changed

Exports

(none)

Methods

  • _ready()
  • _process()
  • _on_adapter_cursor_moved()
    • Forward adapter signals
  • _on_adapter_visibility_changed()
  • set_input_processing_enabled()
    • Public API - delegates to adapter
  • is_input_processing_enabled()
  • is_input_ready()
  • move_to_viewport_center_tile()
  • move_to_cursor_center_tile()
  • update_visibility()
  • should_be_visible()
  • get_last_manual_recenter_mode()
  • get_visual_node()
    • Visual helpers - engine-specific
  • is_visual_visible()
  • resolve_gb_dependencies()
    • Dependency injection
  • set_dependencies()
  • are_dependencies_ready()
  • to_diagnostic_string()
    • Diagnostic helpers
  • get_actions()
  • get_targeting_settings()