Grid Placement is a GDScript addon; it does not require a .NET/Mono export path. Most web-only failures come from project/export configuration rather than a separate web placement API.
What must be exported
Your web build needs every resource referenced by the placement setup, including:
res://addons/grid_placement/;- the active
GridPlacementBundleand settings; - entry scenes and
ScenePlacementEntryresources; - placement profiles and custom rules;
- 2D terrain palettes/entries if terrain painting is used;
- 3D snap/support settings and provider scenes/resources if 3D is used;
- preview/indicator scenes and project-specific placement UI/assets.
If you use restrictive export filters, verify those folders/files are included. Prefer external .tres resources for important reusable configuration because dependencies are easier to inspect and diagnose than deeply nested embedded resources.
Pre-export checks
- Plugin enabled.
- Required Input Map actions exist.
- Placement bundle/settings load without runtime issues.
- Placement entries reference valid
.tscnscenes. - Rules/profiles/resources used by the active catalog are included.
- Collision layers/masks and area/body flags match the target scenes.
- Non-interactive HUD controls do not consume placement input.
These are the same placement rules as desktop. Do not add web-specific placement logic unless you have a reproduced browser-only problem.
Terrain resources
If your game uses terrain painting, export the relevant TileSet/MeshLibrary, terrain palette/entries, and preview resources. 3D GridMap terrain paints export like other GridMap state — verify the mesh library and palette entries ship with the build.
3D object checks
If your game uses 3D placement, also verify the exported build contains and can load:
- the target
GridMap/mesh/collision resources; - GRID/SMOOTH entry footprints and snap profiles;
- CELL/EDGE/FACE/CORNER/TOP mount and SMOOTH socket resources used by your entries/providers;
- physics/support collision layers used by slope/support validation.
Exercise the same representative 3D workflow you ship. Browser export does not change the supported GRID/SMOOTH/mount/slope contract.
Diagnose a web-only failure
| Symptom | Check first |
|---|---|
| Works in editor, missing content on web | Export filters and missing .tres / .tscn dependencies. |
| Placement rules appear absent | Rule/profile resources and the active bundle/catalog. |
| Object targeting fails | Collision layers/masks and body/area flags. |
| Terrain preview is missing | TileMapLayer, terrain resources, and preview wiring. |
| 3D target/support differs | Exported mesh/collision/provider resources and support masks. |
| Clicks do nothing | Input Map and UI mouse filtering. |
| Browser reports missing resources | Exported file list/path casing and referenced dependencies. |
Use the browser console/network panel when the failure looks like a missing file. Use Grid Placement runtime issues/logging when the resources exist but configuration is invalid.
Test the exported build
Before publishing a web build, exercise the workflows your game actually ships:
- load the exported build in a browser;
- place at least one object;
- verify invalid placement feedback;
- test manipulation if enabled;
- test 2D terrain painting if enabled;
- test representative 3D GRID/SMOOTH/mount/slope behavior if enabled;
- test save/restore if your web game persists placement state;
- check the browser console for missing-resource errors.
Related guides
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