-
Notifications
You must be signed in to change notification settings - Fork 2
Home
finnsetchell edited this page Dec 12, 2025
·
3 revisions
Welcome to the Moogs Structure Lib documentation! This wiki will guide you through creating custom structures for Minecraft 1.21+ using Moogs Structure Lib.
Moogs Structure Lib is a library mod that provides flexible, data-driven structure generation systems for Minecraft. It extends vanilla structure generation with advanced features like:
- Enhanced placement systems with exclusion zones
- Advanced terrain adaptation and height controls
- Nether-specific structure generation
- Version-aware structure templates
- And much more!
- Minecraft 1.21 or higher
- Moogs Structure Lib installed (as a mod dependency or in your modpack)
- Basic understanding of JSON files
- Familiarity with Minecraft's datapack structure (helpful but not required)
- Getting Started - Start here! Learn the basics and create your first structure.
- Structure Files - Complete reference for structure JSON files
- Template Pools - Understanding how template pools work
- Structure Sets - Grouping structures with placement rules
- Placement Systems - Advanced placement configuration
- NBT Files - Where and how to place your structure files
- Advanced Topics - Advanced features and placement modifiers
- Simple Structure Example - Cart structure walkthrough
- Jigsaw Structure Example - Barn structure with jigsaw connections
- Nether Structure Example - Nether Devil structure
- Complex Structure Example - Large structures like Cathedral
To generate a structure in Minecraft, you need four main components:
-
Structure JSON (
data/<namespace>/worldgen/structure/) - Defines the structure type and properties -
Template Pool JSON (
data/<namespace>/worldgen/template_pool/) - Defines which structure pieces to use -
Structure Set JSON (
data/<namespace>/worldgen/structure_set/) - Defines where and how often structures spawn -
NBT Structure Files (
data/<namespace>/structure/) - The actual structure data files
Throughout this wiki, we use examples from MoogsVoyagerStructures (MVS).
- Join the Discord server for support
- Check the GitHub repository for issues and updates
- Review the examples in this wiki for common patterns
Ready to start? Head over to Getting Started to create your first structure!