Structure Layout Optimizer
Structure Layout Optimizer speeds up how Jigsaw structures are placed in the world without changing how any of them look.
What it does
The mod targets the layout step of Jigsaw structure generation. Intersection checks between pieces normally compare every vertex of each shape, so the cost climbs as a recursive structure gains pieces. The mod swaps in a container that stores pieces in a spatial tree and checks only the pieces close to a candidate bounding box, which keeps the work from growing with the whole structure.
The mod also skips checks for child rigid pieces when a Jigsaw Block is fully enclosed, simplifies joint data handling so it no longer converts values to an enum on each match, and reorders some logic to run less often. Structures with very large numbers of Jigsaw Blocks gain the most, since every block is compared against the blocks of the other pieces.
It is server-side only, so players join without installing it. It is open source under the MIT License and needs Fabric API and Resourceful Config. Files are published for Fabric, Forge and NeoForge, covering game versions 1.16.1 – 26.3 with 20 release versions, and the latest builds target 26.3 and 1.20.1.
Key features
Spatial intersection checks
Piece collision checks look only at nearby pieces, so the search time no longer grows with the full piece count.
Early enclosure skipping
When a Jigsaw Block is blocked off completely, the child rigid pieces behind it are not checked.
Faster joint matching
Jigsaw target and facing matching avoids enum conversion and runs its checks in a cheaper order.
Faster large NBT loading
Large structure NBT files with no finalizing processor are filtered by bounds before processing, so they load faster.
Block list prioritization
Jigsaw block shuffling and priority ordering in single pool elements use a quicker sorting routine.
Compatibility
Latest build for each game version and loader.
26.x5 of 5 versions with builds
1.21.x10 of 10 versions with builds
1.20.x1 of 1 version with builds
1.19.x1 of 1 version with builds
1.18.x1 of 1 version with builds
1.16.x2 of 2 versions with builds
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 2
Required by 1 mod
Use cases
Recursive Jigsaw structures
Structures that chain many pieces together are where the spatial checks reduce lag spikes during generation.
Structures with many Jigsaw Blocks
Pieces with a large number of Jigsaw Blocks benefit from the faster matching and enclosure skipping.
Who it’s for: Server owners running world generation mods with large Jigsaw structures, and modpack builders who want faster structure placement without visual changes. Only the server needs the mod.
Questions
Does Structure Layout Optimizer change how structures look?
Does Structure Layout Optimizer need to be installed on clients?
Which dependencies does Structure Layout Optimizer require?
Are all structures optimized?
In the catalog
Structure Layout Optimizer is one of 3,545 Optimization mods on ModsFinder, and one of 2,575 Optimization mods for Fabric. 8,071 mods support Minecraft 26.3.
More from TelepathicGrunt
Similar mods
What the author says
Optimizes general Jigsaw structure generation as best I can. Essentially this mod aims to not change how structures look at all. It only works to try and make structures generate faster and more efficiently. That's it. Here are the more technical details of the optimizations done. Please report any conflicts or…
Official listing
- Modrinth page
- modrinth.com/mod/structure-layout-optimizer
- Owner
- TelepathicGrunt
- Published
- 2024-08-20
- Updated on Modrinth
- 2026-09-16
- Facts verified
- 2026-10-15
