Shulker's Super Simple Structure System

Create your own structure mods with minimal effort – this system is much simpler than trying to say the project name five times fast!

About the System

All structure parameters – name, depth underground, generation rarity, and suitable biomes – are configured through JSON files. Currently, the mod supports only single-piece structures (one NBT file), but functionality expansion is planned.

Tutorial materials will be available soon; basic getting started information is provided below.

Important Warning for Version 1.16.1

Minecraft 1.16 introduced a bug affecting all mods that add new structures. If a structure was removed or renamed (which can happen accidentally when editing JSON files), this may corrupt saved worlds upon loading. Always create backup copies of worlds before opening them with any structure-adding mods in versions 1.16.1–1.16.3. Using the mod version for 1.16.1 in long-standing worlds is not recommended, but if you decide to do so – perform regular backups.

Starting from Forge version 35.1.0 (for Minecraft 1.16.4+), the system includes a fix for this bug, so mod versions for 1.16.4 and newer are not affected. Previously corrupted worlds may be restored by visiting and saving the affected chunks while using Forge 35.1.0 or higher.

Getting Started

1. Creating a New Minecraft Instance

This is not strictly necessary but highly recommended. Without this, you risk accidentally opening the wrong world and being forced to preserve current structures or risk world corruption.

2. Setting Up Structure Folders

In the files section of this page, under the mod download, there should be an additional files section with a ZIP archive of examples. Download the archive, extract it, and place it in the root directory of the profile you're using.

The folder structure should look like this:

• Minecraft Game Directory
  • shulkerssupersimplestructuresystem
    • structurejsons
    • structureNBTs

All JSON files describing structures go in the structurejsons folder, and NBT files with block data for structures go in the structureNBTs folder.

![] (https://i.imgur.com/1dlcx8m.png)

3. Creating Your Own Structures

The downloaded example archive contains several structure JSON files with detailed comments explaining how to describe your structures. Also included are sets of NBT files for practicing creating your own JSON files and testing generation in the world.

For creating your own structures, we recommend watching tutorial videos on YouTube – they're much more visual than text guides.

If you want to add loot tables for chests in your structure, you can add them the same way you override default loot tables. Then use commands to set your custom loot tables for chests when placing them during structure design.

![] (https://media.discordapp.net/attachments/651608067837919262/723135556099244072/unknown.png?width=1300&height=677)

![] (https://i.imgur.com/NAEbo59.png)

![] (https://i.imgur.com/2bfTyNe.png)

4. Share Your Creations with Friends!

To share structures, simply archive the shulkerssupersimplestructuressystem folder from your Minecraft game directory and send the archive to friends. They'll need to extract the folder to their directory and install this mod.

Useful Tips

• JSON files describing structures are loaded when Minecraft starts, while NBT files are only opened when the world loads. If you're making changes to NBT files, you don't need to completely close Minecraft – just return to the main screen
• Shulker boxes can also have loot tables!

Example JSON File

{
    "comment": "You can remove any lines starting with the word comment. JSON doesn't support comments so this is how we have to do them",
    "comment2": "Note the format of the file name. Minecraft will throw errors if you have capital letters, spaces, or most special characters in the file name",
    "comment3": "The valid characters for file names include lowercase a-z, 0-9, the underscore character (_), and the minus character (-)",
    "comment4": "Make sure to close this file in any editors before launching minecraft. Some editors won't let go of the file and cause it to fail to parse",

    "comment_name": "You can name your structure whatever you want – this is what will show up using /locate, but after setting it, it's best not to change it",
    "comment_name2": "In version 1.16.1 there's a serious bug: removing or renaming structures can corrupt worlds",
    "comment_name3": "Also note that this name can only contain lowercase letters without special characters or numbers",
    "structureName": "dirthutexample",

    "comment_seed": "It's very important to set a large unique number for each structure. Otherwise your structures will generate on top of each other",
    "comment_seed2": "This number must be less than int_max, which is 2147483647",
    "seed": 1235437262,

    "comment_biomes": "The biomes it can spawn in. These use the registry keys for biomes. If the F3 biome name doesn't work, check the wiki – it may be different",
    "biomes": ["ocean", "plains", "desert", "extreme_hills", "forest", "taiga", "swampland", "river", "hell", "sky", "frozen_ocean", "frozen_river", "ice_flats", "ice_mountains", "mushroom_island", "mushroom_island_shore", "beaches", "desert_hills", "forest_hills", "taiga_hills", "smaller_extreme_hills", "jungle", "jungle_hills", "jungle_edge", "deep_ocean", "stone_beach", "cold_beach", "birch_forest", "birch_forest_hills", "roofed_forest", "taiga_cold", "taiga_cold_hills", "redwood_taiga", "redwood_taiga_hills", "extreme_hills_with_trees", "savanna", "savanna_rock", "mesa", "mesa_rock", "mesa_clear_rock", "mutated_plains", "mutated_desert", "mutated_extreme_hills", "mutated_forest", "mutated_taiga", "mutated_swampland", "mutated_ice_flats", "mutated_jungle", "mutated_jungle_edge", "mutated_birch_forest", "mutated_birch_forest_hills", "mutated_roofed_forest", "mutated_taiga_cold", "mutated_redwood_taiga", "mutated_redwood_taiga_hills", "mutated_extreme_hills_with_trees", "mutated_savanna", "mutated_savanna_rock", "mutated_mesa", "mutated_mesa_rock", "mutated_mesa_clear_rock"],

    "comment_spawnRate": "Distance in chunks at which your structure will try to generate. Structures with fewer suitable biomes will appear less frequently even with the same spawnRate setting",
    "spawnRate": 12,

    "comment_yOffset": "How many Y levels to shift the structure from having the bottom at ground level. A negative number will move the structure upward",
    "blockLevelsBelowGround": 2,

    "comment_filename": "The name of the NBT file with your structure. If you don't include the file extension in the name, the game will crash",
    "fileName": "dangerous_dirt_hut.nbt"
}