How to Make a Structure in Minecraft (Mod Maker guide)

Learn how to create custom buildings and natural ruins that spawn in your world. This easy guide shows you how to make a Structure element right in your web browser.

  1. Open the Studio and Workspace

    Open 9Minecraft Mod Maker in your web browser. Since it runs directly online, you do not need to install anything.

    Open an existing workspace or create a new one. The Structure element supports NeoForge 26.1.2, NeoForge 1.21.1, Data pack 26.1, and Data pack 1.21.1.

  2. Add a Structure Element

    Click the green plus button in your workspace to add a new mod element. Look under the World generation group and select Structure.

    A Structure is a smaller set of blocks that generates in the world based on conditions you define. Give your new element a name to open the editor.

  3. Select Your Structure File and Blocks

    In the Structure field, choose the .NBT structure file you want to spawn. Remember that the vanilla limit for a single structure is 48x48x48 blocks for performance reasons.

    Use the Blocks to not place field to choose which blocks to ignore during generation. Selecting air here tells the game not to place the air blocks of your build, helping it blend better with the environment. However, for cave based structures, you will likely want to place the air too.

  4. Choose Biomes and Chunk Distribution

    Fill in the Biomes to generate structure in field to decide where your build can appear. This list cannot be empty because structures must explicitly define their biomes.

    Next, set the Generation step to determine at what stage of world generation the structure should be added.

    Adjust the Structure chunk distribution using separation and spacing. Structures generate in a grid where spacing is roughly the average distance in chunks between two structures, and separation is the minimum distance in chunks. Separation always needs to be smaller than spacing.

  5. Set Ground Detection and Height

    Use the Ground detection parameter to control how the ground is found. For example, in a water-based biome, choosing first motion-blocking block will generate the build below the water because entities can move through water. Choosing first block will generate the structure above the water.

    Alternatively, you can enable Structure start height to make the structure spawn within a specific height range. When this parameter is turned on, ground detection is disabled and you can select different height range distributions.

  6. Adjust Terrain Adaptation and Projection

    Set the Projection to the terrain field to control how your build sits on the land. Choose Rigid to place the structure completely flat as it is, or use terrain_matching if you want it to shift height and match the land like village paths do.

    In Terrain adaptation type, pick how the ground adjusts around your build. You can choose none for no effect, beard_thin (used by villages to add terrain below and remove it inside), beard_box (a stronger version used by ancient cities), bury (used by strongholds to add terrain completely around it), or encapsulate to add density all around every piece.

  7. Configure Jigsaw Settings (Optional)

    If you are making a multi-part jigsaw build, use the Jigsaw pools list to group parts intended for similar positions. Give each pool a Jigsaw pool name and optionally set a Jigsaw fallback pool to act as a terminator part if there is not enough space or the depth limit is reached.

    Set the Jigsaw generation depth to define how many parts can connect to each other and the main structure. Then set the Maximum distance from main structure to limit how far away parts can generate. Note that this maximum value is further restricted unless terrain adaptation is set to none.

  8. Test and Export Your Mod

    Save your Structure element when you are happy with your settings. Click the Build & run button in the studio to test your world generation in the game.

    Explore the biomes you selected to find your new structure. When everything works well, export your finished mod or data pack to share with friends.

Tips

Try it in the Studio All structure fields explained →