Blobsmith Autotile Wirer (Godot 4)

Turn a 47-blob autotile sheet into a fully wired Godot 4 TileSet in one click — terrain set created, peering bits set on all 47 tiles, optional collision shapes. No more clicking terrain bits by hand, tile by tile.

Works with Godot 4.x (verified against 4.7 stable by an automated headless test suite in this repo).

What it does

You give it a tilesheet PNG in the 47-blob layout (8 columns, ascending-mask order — the layout Blobsmith exports, spec below). It gives you a .tres TileSet where:

• terrain set 0 is configured (Match Corners and Sides, or Match Sides for 16-tile sheets)
• every tile has its terrain peering bits already set
• optionally every tile gets a full-square collision polygon (physics layer 0)

Add a TileMapLayer, set the TileSet, open the Terrains tab and paint. Done.

Install

1. Copy addons/blobsmith_wirer/ into your project's addons/ folder (or install from the Godot Asset Library).
2. Enable it: Project → Project Settings → Plugins → Blobsmith Autotile Wirer.

Use

1. Put your tilesheet PNG anywhere in the project.
2. Project → Tools → Blobsmith Autotile Wirer…
3. Pick the PNG — tile size and mode are auto-detected from the image dimensions.
4. Click Generate TileSet → a <name>_tileset.tres appears next to the PNG.

Sheet layout spec

• 47-blob: 8 columns × 6 rows. Tiles ordered by ascending canonical neighbor mask, where N=1, NE=2, E=4, SE=8, S=16, SW=32, W=64, NW=128 and a corner bit only counts when both adjacent side bits are present. Tile 0 (mask 0) is the "island" tile; the last tile (mask 255) is the full interior.
• 16-tile sides-only: 8 columns × 2 rows, ascending mask over N/E/S/W.

The included examples/grass_47blob_16px.png is a valid 47-blob sheet you can test with.

Don't have a 47-tile sheet?

That's the tedious part — drawing 47 tiles. Blobsmith generates the whole sheet from just 6 base tiles you draw (or import from an RPG Maker A2-style block), with a live autotile playground, and exports this exact layout — plus the wired .tres directly, and Tiled .tsx. There's a free in-browser version to try.

Verifying

The test suite runs the real engine headless:

godot --headless --path test-project --script verify_addon.gd

It asserts the mask tables, layout detection, TileSet structure, save/load round-trip, and that terrain painting on a TileMapLayer resolves interior/edge/island tiles correctly.

License

MIT — see LICENSE.