Schematics

Scans are saved in ../minecolonies/scan/new/....
Once the scans are saved, they need to be moved to the ../structurize/schematics/(folder)/file if they are a custom hut.

Scans are saved in */blueprints/<yourplayername>/scans.
Once the scans are saved, they need to be placed in a style pack, preferably in the correct folder. See the style packs chapter for more details.

Once you have scanned a structure, you can use the build tool to have your Builder build it for you. Once you right-click with the build tool, you will have to select “My Schematics” (in the left dropdown menu) and on the right dropdown menu you will see the scans that you have made. There is also a Rename button where you can change the name of the scan. You can also delete any of your saved scans.

The scanned structure can be found in the build tool under the style pack with your own name. Click “Switch Pack” -> “<yourplayername>” (icon looks like the scan tool) -> “scans”.

Style packs

Styles are now structured in so-called style packs. This is similar to a resource pack or data pack, in that it has a file with some metadata about the style (the name, a description, optionally a link to an image, etc.), and a folder structure with the actual files.

Stylepacks live in the blueprints folder, within your Minecraft folder. This folder already contains one style pack: One with your player’s name. This style pack will contain your scanned files, and can be used to test schematics. In order to make a new style, you need to make a new schematic pack.

The pack.json

This json file contains metadata describing the style:

The folder structure

There are several folders, separating the buildings and decorations in categories. Each of the folders at the highest level can have a couple of icons, named icon.png and icon_disabled.png. Those are shown in the button bar right above the hot bar.

You can download a template folder structure from github (template.zip), which contains the icons used for the official styles already. That github page also contains examples how different styles are structured. An overview with which buildings go into which folders can also be found here.

Decorations are less strict. You can make categories for them as you see fit. E.g. if you have two styles of roads, one for early game and one for later game, you could put them in infrastructure/roads/simple/ and infrastructure/roads/nice/.

Note: Each folder can only contain folders or files. If there are folders there, files won’t be visible in the build tool!

Those custom schematics go in */structurize/schematics. Unzip the zip you downloaded, and put all subfolders in the schematics folder. That folder should contain folders like <stylename>, decorations, walls, supplycamps etc. (depending on which style you installed)

The style pack goes in the “blueprints” folder. Unzip the zip, and find the folder containing the pack.json (either the unzipped folder, or a folder directly in it, depending on how the zip was made). This folder needs to be placed in */blueprints

This is a client-side-only directory which is located in Minecraft’s folder under: */structurize/scans/. Freshly scanned schematics can be found in */structurize/scans/new/ unless they have been renamed in-game. (If they aren’t there, look in */minecolonies/scans/new.) This directory is shared between all your singleplayer games and multiplayer games.

This is located in your own style pack in Minecraft’s folder under: */blueprints/<yourplayername>/scans/. This folder is shared between all your singleylayer and multiplayer games.

Custom schematics need to be copied inside the schematic folder. For both singleplayer and multiplayer games, the folder is under */structurize/schematics/.

Custom schematics need to be placed in a (custom) style pack. For more information about that, look there.

When playing on a server, the server needs to send the schematics to the players so that the build tool’s preview works. Those schematics are saved in Minecraft’s directory under */structurize/{ServerUUID}/cache/, where ServerUUID is the unique identifier of the server. Those directories can be safely removed as they are automatically created by the server when needed.

This was previously used to save schematics from a server and was automatically created as needed. However, this is no longer needed in 1.19.2 and later, so this folder can be removed safely.

The scans’ filenames need to follow the naming convention: {StyleName}/{HutName}{HutLevel}.blueprint. For example, for the Builder’s Huts with the MyOwn style, we would have:

myown/builder1.blueprint myown/builder2.blueprint myown/builder3.blueprint myown/builder4.blueprint myown/builder5.blueprint

• Note: In the build tool, the extension is hidden. HutName can be any of the listed huts below. The maximum level is 5 (except for the Tavern; its max level is 3).

Alternative designs can be placed under as style name like “myownalternative”.

The naming for the buildings is not strict anymore. The only things that are important are that they are named consistently, that their names end with the hut level, and that you do not use capital letters in the hut names. Alternate designs can just have a different name than the primary one. E.g. if you named the level 1 builder’s hut “builder1”, an alternative version could be called “altbuilder1” or “builderalt1” or even something completely different (“constructionworker1”).

Once ready, you need to make a style pack out of them. The schematics are visible in the build tool without the hut block, but you can’t view them in survival mode (their button is greyed out, with an error message that you need to have the hut block).

So, for example, the path would be structurize/schematics/wildwest/builder1 for the Builder’s Hut level 1 and structurize/schematics/supplycamp/wildwestsupplycamp for the supply camp.

So, for example, the path would be blueprints/wildwest/fundamentals/builder1 for the Builder’s Hut level 1 and blueprints/wildwest/decorations/supplies/supplycamp for the supply camp.

Simply create a schematic file with the same style/name. For instance, to override the Builder’s Hut wooden level 1, create a schematic file name called wooden/builder1.blueprint.

Unfortunately, this is not possible, unless you override the entire style (make a style pack with the same name as an existing style pack, in that case).

The custom huts need to be copied in the schematics folder.

The custom huts need to be copied in in a style pack.

Add the deco controller somewhere in the schematic with the name of the schematic, where you’ll put it in the file directory, and its level. Make sure to actually put the decoration in that file path, but only after scanning - don’t include the path in the scan name.

Put the deco controller somewhere in the schematic, and make sure the name of the schematic ends with a number while scanning. The decoration controller will automatically find the decoration in the same folder with the next number.