ModsFinder

Structure Layout Optimizer

by TelepathicGrunt

Structure Layout Optimizer speeds up how Jigsaw structures are placed in the world without changing how any of them look.

FabricForgeNeoForgeServer-side onlyMIT LicenseOpen source1.16.1 – 26.3

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

  1. Spatial intersection checks

    Piece collision checks look only at nearby pieces, so the search time no longer grows with the full piece count.

  2. Early enclosure skipping

    When a Jigsaw Block is blocked off completely, the child rigid pieces behind it are not checked.

  3. Faster joint matching

    Jigsaw target and facing matching avoids enum conversion and runs its checks in a cheaper order.

  4. Faster large NBT loading

    Large structure NBT files with no finalizing processor are filtered by bounds before processing, so they load faster.

  5. 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
26.31.1.4+26.3-fabricNot available1.1.4+26.3-neoforge
26.21.1.4+26.1-fabricNot available1.1.4+26.1-neoforge
26.1.21.1.4+26.1-fabricNot available1.1.4+26.1-neoforge
26.1.11.1.4+26.1-fabricNot available1.1.4+26.1-neoforge
26.11.1.4+26.1-fabricNot available1.1.4+26.1-neoforge
1.21.x10 of 10 versions with builds
1.21.111.1.4+1.21.11-fabricNot available1.1.4+1.21.11-neoforge
1.21.101.1.4+1.21.9-fabricNot available1.1.5+1.21.9-neoforge
1.21.91.1.4+1.21.9-fabricNot available1.1.5+1.21.9-neoforge
1.21.81.1.4+1.21.6-fabricNot available1.1.4+1.21.6-neoforge
1.21.71.1.4+1.21.6-fabricNot available1.1.4+1.21.6-neoforge
1.21.61.1.4+1.21.6-fabricNot available1.1.4+1.21.6-neoforge
1.21.51.1.4+1.21.5-fabricNot available1.1.4+1.21.5-neoforge
1.21.41.1.4+1.21.4-fabricNot available1.1.4+1.21.4-neoforge
1.21.11.0.12+1.21.1-fabricNot available1.0.12+1.21.1-neoforge
1.21Not availableNot available1.0.1+1.21.1
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
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Requirements

Dependencies declared by the latest file for each loader.

Required 2

Fabric APILightweight and modular API providing common hooks and intercompatibility measures utilized by mods using the Fabric toolchain.
Required
Resourceful ConfigResourceful Config is a mod that allows for developers to make cross-platform configs
Required

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?

No. The mod is written to keep structure appearance unchanged and only affects how fast structures generate.

Does Structure Layout Optimizer need to be installed on clients?

No. Players join without it, since only the server has to run the mod.

Which dependencies does Structure Layout Optimizer require?

Fabric API and Resourceful Config are required. Final Adversaries also requires this mod.

Are all structures optimized?

Not every structure. Pieces using a processor that overrides finalizeProcessing skip this optimization, and in vanilla only Trail Ruins is excluded.

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

All projects

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…
TelepathicGrunt, on the Modrinth page

Official listing

Owner
TelepathicGrunt
Published
2024-08-20
Updated on Modrinth
2026-09-16
Facts verified
2026-10-15

Tags