Home

Moogs Structure Lib

Moogs Structure Lib (MSL) is a library mod for building custom structures from datapacks or mods. It extends vanilla jigsaw generation with extra structure types, more placement control, and a set of structure processors that handle things vanilla cannot: filling spawners and vaults, equipping armor stands, sealing a build against lava, settling pieces onto uneven ground.

Supports Minecraft 1.20 through 26.2. Declare MSL as a dependency in your mod's metadata, or ship it alongside your datapack.

Start here

Getting Started walks through the four files a structure needs.

The four files

File	Location	What it does
Structure	data/<ns>/worldgen/structure/	What the structure is, and which biomes it may spawn in
Template pool	data/<ns>/worldgen/template_pool/	Which pieces it uses and how they connect
Structure set	data/<ns>/worldgen/structure_set/	How often it spawns and how far apart
NBT files	data/<ns>/structure/	The saved pieces themselves

Note that structure/ for NBT files is a different folder from worldgen/structure/ for the JSON.

Those paths are for 1.21 and later. On 1.20 the data folders are plural, so NBT files go in data/<ns>/structures/.

What MSL adds

• Structure Processors - ten processors covering spawners, vaults, armor stands, fluids, terrain settling and weathering
• Placement Systems - spread and exclusion control beyond vanilla
• Advanced Topics - version-aware pool elements and other options

Examples

Worked examples, taken from MoogsVoyagerStructures:

Simple · Jigsaw · Nether · Complex

Getting help

• Discord
• Issues on GitHub