This tutorial adapts the Getting Started setup to a side-view platformer: a square-cell grid you place floors, walls, and props against. If you have not completed Getting Started yet, do that first — this guide only covers what changes for a platformer.
What changes for a platformer
Nothing structural. The five runtime pieces, the scene tree, and the session wiring are identical to Getting Started. A platformer differs in exactly two places:
- The
TileSetstays square. Platformer levels use ordinary square cells (tile_shape= Square, the default), so the only setting that matters istile_sizematching your level art. - Targeting defaults favor horizontal aiming. The shipped platformer targeting template tunes aim/camera behavior for a side-view camera instead of a top-down one.
1. Configure the TileSet
On your level's TileSet resource:
| Property | Value |
|---|---|
tile_shape |
Square (default) |
tile_size |
Match your art's cell size, e.g. Vector2i(16, 16) |
The plugin snaps to whatever cells your TileMapLayer defines — there is no separate grid-size setting to keep in sync. If placement lands between cells, your tile_size and your art are disagreeing.
2. Use the platformer template bundle
The shipped template set includes a platformer bundle that carries settings, actions, and templates inline:
- Bundle:
res://templates/grid_placement_templates/resources/platformer/platformer_placement_bundle.tres - Targeting defaults:
res://templates/grid_placement_templates/resources/platformer/targeting_settings.tres
Assign the bundle to PlacementSession.grid_placement_bundle and to GridPlacementHost.grid_placement_bundle, exactly as Getting Started step 4 describes. You can leave settings empty on the session — the bundle's settings apply unless you override them.
Terrain is optional for this tutorial. Leave the bundle's terrain_palette empty unless you use terrain painting.
3. Wire the scene
Use the scene tree from Getting Started section 3 unchanged:
PlacementLevelContext.target_map→ your platformerTileMapLayer.PlacementLevelContext.objects_parent→ a dedicatedNode2Dfor placed objects, never the map itself.- Instance the positioner stack from
res://templates/grid_placement_templates/grid_positioner/grid_positioner_stack.tscn. - Keep a current
Camera2D— the 2D commit path resolves through the camera projection and fails closed without one.
4. Place your first platform piece
Create an entry exactly as Getting Started step 5 describes (packed_scene, display_name, and a profiles entry so the selection UI shows it). Platformer-specific authoring notes:
- The platformer template bundle includes collision checks, so give the object collision shapes or its placement is rejected.
- Align the scene root to the cell anchor so pieces tile edge-to-edge; a one-pixel offset shows up as visible seams in a row of platforms.
- For multi-cell pieces (a long bridge, a wide building), follow 2D Object Scene Setup for footprint and anchor rules.
Learn from the platformer demo
The repository ships a complete platformer reference demo at res://demos/2d/platformer/ — side-view levels, buildable-ground rules, and a working catalog. The demos live only in a repository checkout. A consumer project receives only res://addons/grid_placement/ and res://templates/grid_placement_templates/, so treat the demo as read-only reference material to compare against, not something your project imports from.
The portable equivalent of everything the demo wires up is the platformer template bundle from step 2 plus your own art.
Troubleshooting this genre
- Placement snaps to the wrong rows — your
TileSet.tile_sizedoes not match the level art's cell size. - Nothing places at all — check for the missing
Camera2D(2D commits fail closed without one) and re-run the diagnostic in Validation. - Aim feels wrong in side view — confirm the session is using the platformer targeting template rather than a top-down one.
Related guides
- Getting Started — the setup this tutorial adapts.
- Placement Workflow — preview → validate → commit → manipulate.
- Choosing Terrain vs Objects — when to paint terrain cells instead of placing objects.
- 2D Object Scene Setup — authoring entry scenes, anchors, and footprints.
Using this in a game?
Grid Placement v6.3.2 — full source, playable demos, commercial license
The guide above is the same setup the shipped demos use. Try the build in your browser before you buy it.
Tutorials built on Grid Placement
- Godot multiplayer grid placement: one host, four sessions
- Godot 2D grid building system: paint, place, save
- Godot 3D grid building system: the runtime loop
- Godot 4 grid-building plugins: build mode vs editor tools
- 3D room placement in Godot: build rooms and stack storeys
- 3D grid placement in Godot 4: full setup tutorial
- Snap to a TileMap in Godot: 2D grid placement
- How to make a farming system in Godot
- How to snap objects to a 3D grid in Godot