Schematics

Schematics are files containing block and entity information of a certain area a player scanned with the Scan Tool in-game. You can use the scan tool and scan ANY building or structure you like in singleplayer or multiplayer and then have your Builder build it for you (provided that you give them all the materials needed, of course).

Schematics

Scanning a New Structure

Once you have a structure or area you want to scan to have your Builder build, you need to determine the exact area that needs to be scanned.

TestBuilding

Take your Scan Tool and left-click the lowest left block of the area and then place a block (it can be a placeholder block in the top right corner and right-click on it.

ScanPoint1

ScanPoint2

Then click in the air to see the entire structure.

ScanFull

Once you have the full area set, you can press Escape and the white outline of the scan area will stay in place. Go around it to double-check that everything you want is in the scan area. When you are ready, you can right-click in the air again to get the GUI to display where you can enter your scan name. Then press the green checkmark to save the scan.

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.

Placing a Schematic.

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.

Schematic

FAQ

This is a FAQ section to answer most questions regarding schematics in MineColonies.

What and where is the scans folder?

The scans folder is where the schematics are saved after performing a scan using the scan tool in MineColonies. 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. This directory is shared between all your singleplayer games and multiplayer games.

Where is the schematic folder?

Custom schematics need to be copied inside the schematic folder: *\structurize\schematics\.

The location of this folder depends of the type of game:

For a singleplayer game, there are 2 possible locations:
- In the world folder: */minecraft/saves/(World Name)/structurize/schematics/
  - Note: Use this directory when you want to use custom schematics restricted to the world. When this directory exists (even empty), MineColonies will completely ignore the other directory.
- In the Minecraft folder: */minecraft/structurize/schematics/
  - Note: Use this folder when you want to have the same custom schematics across multiple worlds.
For a multiplayer game, the schematics are always loaded from the world’s directory under: */minecolonies/schematics/ directory.

I have a “*/minecolonies/01e6a291-8a01-4763-bcae-f3a8797b1d52/cache/” folder, what is that for?

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.

How to create custom huts?

To create new schematics for existing huts, there are some guidelines that you must follow: the scans MUST have the same footprint for the same style/hut’s type; the scans must contain the hut’s block, for example the Builder’s Hut block for the Builder’s Hut; the hut block need to be exactly at the same place and have the same rotation for each level; 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.

Once ready, move the myown folder into the schematics folder and start your game. You should be able to see it with the the build tool.

Note: Remember that you need the appropriate hut in your inventory to be able to see the schematics in the build tool.

Custom Hut Filenames

Here is a full list, up-to-date as of 9 February 2020, of the building names. Please note that capitalization matters.

Level 1	Level 2	Level 3	Level 4	Level 5
archery1	archery2	archery3	archery4	archery5
baker1	baker2	baker3	baker4	baker5
barracks1	barracks2	barracks3	barracks4	barracks5
barrackstower1	barrackstower2	barrackstower3	barrackstower4	barrackstower5
blacksmith1	blacksmith2	blacksmith3	blacksmith4	blacksmith5
builder1	builder2	builder3	builder4	builder5
chickenherder1	chickenherder2	chickenherder3	chickenherder4	chickenherder5
citizen1	citizen2	citizen3	citizen4	citizen5
combatacademy1	combatacademy2	combatacademy3	combatacademy4	combatacademy5
composter1	composter2	composter3	composter4	composter5
cook1	cook2	cook3	cook4	cook5
cowboy1	cowboy2	cowboy3	cowboy4	cowboy5
crusher1	crusher2	crusher3	crusher4	crusher5
deliveryman1	deliveryman2	deliveryman3	deliveryman4	deliveryman5
enchanter1	enchanter2	enchanter3	enchanter4	enchanter5
farmer1	farmer2	farmer3	farmer4	farmer5
fisherman1	fisherman2	fisherman3	fisherman4	fisherman5
florist1	florist2	florist3	florist4	florist5
guardtower1	guardtower2	guardtower3	guardtower4	guardtower5
library1	library2	library3	library4	library5
lumberjack1	lumberjack2	lumberjack3	lumberjack4	lumberjack5
miner1	miner2	miner3	miner4	miner5
sawmill1	sawmill2	sawmill3	sawmill4	sawmill5
shepherd1	shepherd2	shepherd3	shepherd4	shepherd5
sifter1	sifter2	sifter3	sifter4	sifter5
smeltery1	smeltery2	smeltery3	smeltery4	smeltery5
stonemason1	stonemason2	stonemason3	stonemason4	stonemason5
stonesmeltery1	stonesmeltery2	stonesmeltery3	stonesmeltery4	stonesmeltery5
swineherder1	swineherder2	swineherder3	swineherder4	swineherder5
townhall1	townhall2	townhall3	townhall4	townhall5
university1	university2	university3	university4	university5
warehouse1	warehouse2	warehouse3	warehouse4	warehouse5

Hut Requirements

Building	Requirements	Suggested
Archery	1 archery dummy per level (a hay bale with a button on it)
Bakery	1 furnace
Barracks	1 barracks tower per level (up to lvl 4)
Barracks Tower		1 bed per level
Builder’s Hut		1 rack per level
Citzen’s Hut	1 bed per level
Combat Academy	1 combat dummy per level (a pumpkin on top of a bale of hay)
Composter’s Hut	1 barrel per level
Restaurant	1 furnace per level
Dyer’s Hut	1 furnace
Flower Shop	4 compost blocks per level
Glassblower’s Hut	1 furnace per level
Guard Tower		1 bed per level
Hospital	1 bed per level
Library	Bookshelves
Mine	A mineshaft
School	2 carpets per level	4 carpets per level
Smeltery	1 furnace per level
Stone Smeltery	1 furnace per level
Plantation	4 per level: brick under sand, cobble under sand, sand next to water
Tavern	4 beds, horizontal barrels and/or vertical barrels, a dining room
University	Bookshelves
Warehouse	Racks (more each level)

Level Requirements

Level	Requirements
Level 1	Very Easy - Wooden
Level 2	Easy - Iron
Level 3	Medium - Nether
Level 4	Difficult - Ocean
Level 5	Very Difficult - End

Tips on Building

Do

Make all levels of a hut have the same footprint for x, y, and z
Place the hut block in the same location with the same rotation
Make sure all chests and [racks](../../source/items/rack) are in the same location through all levels
Use [solid placeholder blocks](../../source/items/placeholderblocks) at or below ground level
Use [light placeholder blocks](../../source/items/placeholderblocks) where you want to keep any existing block (including from level to level), like the [Barracks Towers](../../source/buildings/barrackstower) in the [Barracks](../../source/buildings/barracks) schematic
Use only vanilla blocks or Structurize blocks (officially)
Use Books and Quills instead of blank books
If building upgradable deco, add the deco controller with the name of your deco item, LunaDragonStar (the schematics admin) will fix the pathing that goes in it to match where she puts it in the files

Don’t

Use unobtainable items in builds (no command blocks, petrified wood, infested blocks, or mob heads (including player heads))
Change someone else's style (officially) unless specifically asked to do so

Additional Information

How to override some built-in schematics?

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.

How to use custom huts?

The custom huts need to be copied in the schematics folder. Once copied, you can start your singleplayer or multiplayer game as usual. You should see them in the build tool (if you have the hut block in your inventory).

How to allow my players to use their own huts’ schematics on my server?

You will have to copy them yourself in the schematics folder on the server and restart it.

How to allow my players to use their scanned decoration schematics on my server?

Edit the configuration file and set allowPlayerSchematics to true. This allows the player to use their own decorations. It is not possible for the player to use their own huts’ schematics. You can also limit the number of players’ schematics at any given time by editing maxCachedSchematics (default is 100). When the limit is reached, the server will start deleting unused schematics.

How to disable built-in schematics completely?

Edit the configuration file and set ignoreSchematicsFromJar to true. Be aware: things will break if some huts’ schematics are missing.