Wayfinder Auto-Grid

A FoundryVTT module to automatically align scenes to grid using visual analysis tools. Works for both Square & Hex Grids.

System Agnosticv1.1.1Foundry V13+

Free

---

---

#### Works for both Square & Hex Grids

Visual Grid Alignment Tool aligning Foundry's grid to the map you provide. Draw a box over three grid squares, or drop a triangle over three adjacent hex cells, and Auto-Grid works out the cell size and the background offset, animates the result so you can watch it land, and commits.

When the map art itself uses a fractional cell size — the kind no whole-pixel grid can ever fit — Auto-Grid measures the drawn grid directly from the image and offers a one-click Auto-Rescale that makes every cell land on exact pixels.

Square grids and all four Foundry hex variants. The module won't work until a square or hex grid is selected in scene settings.

Requires: Wayfinder Core.

---

Installation

Classic manifest install:

1. In Foundry, open Add-on Modules → Install Module.
2. Paste this into the Manifest URL field:

https://wayfindermodules.com/releases/wayfinder-auto-grid/manifest

1. Click Install.

Install Wayfinder Core the same way first. Every module is listed at wayfindermodules.com.

---

Using it

Square grids

1. Open the tool from the Wayfinder scene controls, or from the Grid tab in Scene Configuration.
2. Click Draw 3×3 Box, then drag a rectangle over exactly three grid squares wide and three tall on your map image.
3. A live readout under the box shows the resulting cell size as you drag. If you know your map's grid size, aim for that exact number (256.0, say).
4. Release. The grid animates into place and commits.
5. If the map's own grid turns out to be fractional, an Auto-Rescale prompt appears once the animation lands — see below.

Hex grids

1. Open the tool. The button reads Place Tri-Hex when a hex scene is active.
2. Click it to summon a 3-hex triangle overlay at the centre of the scene.
3. Scroll to resize, drag to position it over any three adjacent cells, then click to confirm.
4. Right-click or Escape cancels without committing.

The triangle arranges itself for your grid's orientation.

Auto Mode (Square & Hex)

1. Open the tool. Click Auto
2. If the map's grid is prominent enough, the scale/offset/gridsize will be automatically adjusted.

---

How the alignment works

On a square grid, one gesture gives you both the size and the offset.

Hex grids cover all four Foundry layouts, pointy-top and flat-top, odd and even. The triangle measures across three cells at once.

Plain scroll resizes in 5px steps. Shift+scroll drops to 1px, which is how you land on an exact value like 150.

---

Auto-Rescale

Some maps can't be fit by any whole-pixel grid. The art was exported at, say, 19.63 pixels per cell, so every integer grid size drifts further off the longer the map runs. When your box lands on a map like that, Auto-Grid measures the drawn grid directly from the map image and opens an Auto-Rescale prompt with the numbers it found: accept, and the scene's dimensions stretch — a percent or two at most — so every cell becomes exactly whole, offset included. Decline, and the plain measurement commits instead.

• The prompt only appears when the measurement is confident. The map has to actually have a drawn grid, both axes have to agree on its size, and the correction has to be worth making. Gridless art never triggers it.
• Maps with decorative borders work; the measurement doesn't assume the grid runs edge to edge.
• Tokens, walls, and lights are repositioned by Foundry automatically when the scene stretches.
• Rescaled maps stay quiet afterwards: running the tool again just realigns the offset.

---

Preview and cancellation

No scene data is touched until you confirm. Cancel at any stage, by right-click, Escape, or closing the window mid-selection.

Sizes outside the 10–500px window are rejected.

---

Where is it located

A button in the Wayfinder scene controls group, GM-only, and a button in the Grid tab of Scene Configuration, placed directly after the Grid Size field. The Scene Config helper text and the window's action button both switch between square and hex wording based on the scene's actual grid type.

Launching from Scene Config while you're viewing a different scene warns you to view that scene first, rather than aligning the wrong map.

Scene Configuration minimizes when you launch the tool, and the tool minimizes while you draw.

The aligner window follows the active Wayfinder theme.

---

Status display

The tool window shows the scene's current grid size and current background offset, updated live.

---

Settings

None.

---

Support

Questions, bug reports, and feature requests are welcome on the Wayfinder Society Discord.

Changelog · License. Free to use, not open source.

---

Changelog · License