Structurize

Overview

Structurize is a building utility and decoration mod developed by the MineColonies team (LDTTeam). Its core feature is a schematic system that lets you scan any structure in your world, save it as a blueprint file, and paste it elsewhere. This makes it invaluable for duplicating builds, sharing designs, and working with the MineColonies mod.

Beyond schematics, Structurize adds a massive collection of decorative blocks. There are over 770 Timber Frame variants combining different wood types, centre fills, and frame patterns. You also get 154 Shingle roof blocks, 22 Shingle Slab variants, 16 Floating Carpets, Paper Walls, and a full set of Cactus Wood building blocks. The mod also includes a Multi Block that functions as a configurable block pusher, and a Caliper for measuring distances.

You can browse all items and recipes this mod adds using the tabs at the top of this page. The Recipes tab has the full list of over 500 crafting recipes with search and filtering.

Tools and Items

Build Tool (Scepter Gold)

The Build Tool is Structurize's primary tool for placing schematics. Right-clicking any block or the air opens the build window GUI where you can browse your saved schematics, rotate and mirror them, and confirm placement. The tool is not consumed on use and stays in your inventory. It is also used as a crafting ingredient for Timber Frames and Floating Carpets.

Scan Tool (Scepter Steel)

The Scan Tool captures regions of the world and saves them as .blueprint schematic files. Left-click a block to set the first corner position (you will see a confirmation message with coordinates), then right-click another block to set the second corner. Right-click in the air to finalize the scan and save the schematic. The maximum scan volume is 100,000 blocks. Schematics store block data, tile entities (Chests, Furnaces, Signs, etc.), and entities within the selected region.

Shape Tool

The Shape Tool opens a shape generation GUI that lets you create geometric forms like spheres, cylinders, and other shapes. Right-click a block or the air to open the shape window, then configure the parameters to generate your desired form. This is particularly useful for creating curved structures that would be tedious to build by hand.

Tag Tool

The Tag Tool is a specialized tool for marking blocks within schematics with custom tags. You first need to set an anchor position by sneaking and clicking on a Placeholder Block, then left-click blocks to add or remove tags. Tags are stored in relative coordinates to the anchor, making them useful for marking special positions in schematic templates (like where NPCs should spawn in MineColonies buildings).

Caliper

The Caliper measures distances between two points. Like the other position-selecting items, left-click sets the first point and right-click sets the second. Right-click in the air to calculate and display the distance in an "X by Y by Z" format. This is handy for planning builds and verifying dimensions before scanning.

Special Blocks

Substitution Block

The Substitution Block is a transparent placeholder used in schematics to indicate positions where the existing terrain should be preserved. When a schematic is pasted, Substitution Blocks are simply skipped, leaving whatever block is already in the world at that position. This is essential for creating schematics that blend naturally with terrain rather than carving out rectangular holes.

Solid Substitution Block

The Solid Substitution Block works similarly to the regular Substitution Block but is meant for positions where a solid block should exist. If the world position already has a solid block, it is kept. If it is air, the system can fill it with an appropriate block. This is useful for schematics that need a foundation or floor but should adapt to the surrounding terrain.

Placeholder Block

The Placeholder Block is a directional block that stores a reference to another block's item form and displays it visually. It is primarily used in schematic editing to mark special positions and store metadata. The Placeholder Block also supports the Tag Tool for adding positional tags, and tracks corner positions and schematic names, making it a key component for MineColonies integration.

Multi Block

The Multi Block is a Redstone-powered block pusher with configurable direction, output direction, range, and speed. When it receives a Redstone signal, it pushes blocks in its configured direction. When the signal turns off, it pushes blocks in the output direction instead. This creates a back-and-forth piston-like mechanism.

The range can be set from 1 to 10 blocks, controlling how far the block pushing extends. Speed ranges from 1 to 3, where speed 1 operates every 20 ticks (once per second), speed 2 every 10 ticks (twice per second), and speed 3 approximately every 6-7 ticks (three times per second). The default range is 3 blocks and the default speed is 2.

The Multi Block cannot push blocks that have tile entities (like Chests or Furnaces), blocks that are push-resistant (like Obsidian), or liquid blocks. It will skip Air and push entities out of the way, teleporting them to the target position. The direction and output can be set to any of the six cardinal directions (up, down, north, south, east, west).

Decorative Blocks

Timber Frames

Timber Frames are Structurize's largest block category with over 770 variants. Each Timber Frame is defined by three properties: the frame wood type (the outer border), the centre fill material, and the frame pattern. There are 7 frame wood types (Oak, Spruce, Birch, Jungle, Dark Oak, Acacia, and Cactus), 11 centre fill types (those same 7 woods plus Cobblestone, Stone, Paper, and Brick), and 10 frame patterns.

The 10 frame patterns are: Plain, Double Crossed (X pattern), Framed (border outline), Side Framed, Up Gated, Down Gated, One Crossed Left-Right, One Crossed Right-Left, Horizontal Plain, and Side Framed Horizontal. The Plain pattern is the base variant that you craft directly. All other patterns are obtained by placing a Timber Frame alone in a Crafting Table to cycle through the patterns. Each craft transforms the frame to the next pattern in the cycle.

To craft a Plain Timber Frame, place a frame wood type in the top slot, the centre fill material in the middle, and a Build Tool in the bottom. This yields 4 Timber Frames. The Build Tool is not consumed, so you only need to craft it once.

Shingles

Shingles are stair-shaped roof blocks available in 154 combinations. Each Shingle combines one of 22 face types with one of 7 wood types. The face types fall into three categories: Clay-based (plain Clay plus 15 dyed Clay colors), Slate-based (plain Slate plus Blue, Green, Purple, and Moss Slate), and Thatched.

Like vanilla Stairs, Shingles automatically connect to adjacent blocks with three shape variants: straight, concave (inner corners), and convex (outer corners). This makes them excellent for building roofs that look natural at intersections and corners.

Non-dyed Shingles (Clay, Slate, and Thatched) are crafted with a shaped recipe. Clay Shingles use Clay as the face material, Slate Shingles use Cobblestone, and Thatched Shingles use Wheat. All base recipes include the face material, Sticks, and a wood type Plank, producing 8 Shingles. Dyed variants are crafted by combining a dye with 8 existing Shingles of the same base type in a shapeless recipe, yielding 8 re-colored Shingles.

Shingle Slabs

Shingle Slabs are half-height roof blocks that complement the full Shingles. There are 22 variants matching the face types (Clay, dyed Clays, Slates, and Thatched). Unlike full Shingles, Shingle Slabs support 6 shape modes: Top, One-Way, Two-Way, Three-Way, Four-Way, and Curved. These shapes control how the slab connects to adjacent blocks, giving you fine control over roof ridge lines and valleys.

Base Shingle Slabs (Slate and Thatched) are crafted with a 3x2 pattern of their face material on top and Sticks on the bottom, producing 8 slabs. Dyed variants work the same as Shingles: combine a dye with 8 existing slabs.

Floating Carpets

Floating Carpets are thin decorative blocks (1 pixel tall) available in all 16 dye colors. Unlike vanilla Carpets, Floating Carpets have no collision and do not require a block beneath them. They hover in place wherever you put them, making them perfect for decorative canopies, awnings, and suspended decorations.

To craft a Floating Carpet, place a Build Tool on top, a matching color vanilla Carpet in the centre, and a String below. This yields 1 Floating Carpet. To re-dye existing Floating Carpets, surround a dye with 8 Floating Carpets (any color) to get 8 in the new color.

Paper Walls

Paper Walls are translucent panel blocks available in 4 wood types: Oak, Spruce, Birch, and Jungle. They are crafted with 6 Planks and 3 Paper in a 3x3 pattern, producing 8 Paper Walls. These blocks are ideal for creating Japanese-style interiors, room dividers, or decorative window panels.

Cactus Wood Set

Structurize adds a complete set of Cactus-based wood blocks: Cactus Planks, Cactus Door, Cactus Trapdoor, Cactus Stairs, Cactus Slab, Cactus Fence, and Cactus Fence Gate. These give desert-themed builds a unique wood type that matches Cactus aesthetics. Cactus wood also integrates into the Timber Frame and Shingle systems as both a frame type and centre fill material.

Decorative Barrels

The mod adds two decorative Barrel blocks: one in a standing orientation and one on its side. These are purely cosmetic and do not function as storage. They support rotation and are useful for adding detail to taverns, cellars, and dock areas.

Commands

Structurize adds two server commands, both requiring operator permissions.

/scan

The /scan command lets operators create schematics from the command line. The syntax is /scan <pos1> <pos2> [player] [filename] [anchor_pos]. This is useful for server administrators who need to capture structures without using the in-game tool, or for automating schematic creation.

/updateschematics

The /updateschematics command batch-converts old .nbt format schematics into the newer .blueprint format. It reads from an /updater/input folder and writes converted files to /updater/output. This is mainly useful when migrating from older versions of the mod or converting vanilla structure files.

Configuration

Structurize's configuration file is found in your config folder under structurize-common.toml. The settings control performance limits and schematic behavior.

The maxOperationsPerTick setting (default: 1,000, max: 100,000) limits how many block operations the mod performs each tick. Increasing this speeds up schematic placement but may cause lag on slower systems. The maxBlocksChecked setting (default: 1,000) controls how many blocks are validated per operation, serving a similar performance role.

The maxCachedChanges setting (default: 10, max: 100) determines how many undo/redo steps are stored. The maxCachedSchematics setting (default: 100) controls how many schematics are kept in memory. The allowPlayerSchematics setting (default: true) controls whether non-operator players can create and use schematics. Setting ignoreSchematicsFromJar to true prevents bundled schematics from loading.