Grid Placement

Start here

New to the addon? Read these four guides in order, then stop until your game needs more:

1. Getting Started — install, wire one session, and place the first object. Includes the minimal scene tree, the resources to create, how to link them, and the settings to check first.
2. Placement Workflow — preview, validate, commit, then manipulate or demolish.
3. Choosing Terrain vs Objects — decide between 2D terrain cells and placeable scene objects.
4. Surface & Brush Reference — support matrix and 2D brush semantics.

Minimal scene setup

A working 2D scene needs five pieces. Names are yours; types and links are what matter:

• Nodes: a GridPlacementHost (registers the session, routes input), a level with the PlacementLevelContext script, a player with the PlacementOwner script, a GridPositioner2D for grid targeting, and the shipped selection UI on a CanvasLayer.
• Resources: one PlacementSession (bundle, settings, actions, catalog) plus one ScenePlacementEntry per placeable object pointing at its scene.
• Linking: call host.configure(session) with the same session assigned to the positioner; point the level context at your TileMapLayer (target_map) and a separate Node2D (objects_parent); point the owner at your player (owner_root).
• Settings: install the default input actions, keep collision layers and masks consistent across targeting, validation, and objects, and size the indicator to your tiles.

Learn from the demos

Five reference demos ship with the plugin (top-down, isometric, platformer, hex, and 3D) and follow exactly this wiring. Open the top-down demo first and read Getting Started alongside it.