Blueprints

Blueprints

A finished blueprint can be saved as a file, shared with others and placed again somewhere else – in another site, another world or on another server.

Saving

/eb blueprint save <name> <project>

saves the blueprint of one of your projects. Names may contain letters, digits, - and _. The project ID is shown in the dashboard and in /eb projects; the first few characters are enough as long as they are unique.

Blueprints are stored in

config/expanded_building/blueprints/<name>.json

– deliberately outside the world folder, so a blueprint survives the world it was made in and can simply be passed on. Copy a .json file into that folder to use a blueprint someone sent you.

A blueprint file only contains relative positions and target block states. The original state of the ground is left out on purpose – it describes the old terrain and says nothing about the new one. It is captured fresh from the target world when the blueprint is placed. Block data such as chest contents or sign text is never stored.

Loading and positioning

You need to be in planning mode to load a blueprint – it is placed into your current planning session. So first mark a site with the wand, then:

/eb blueprint load <name> [carve]

/eb blueprint list lists all saved blueprints with a clickable [load] button.

load does not write anything into the world yet. Instead the blueprint appears as a preview about four blocks in front of you, centred on your view direction, and follows you as you walk and turn.

• Green – the blueprint fits inside the site.
• Red – it would stick out of the site.

Doors, windows, chests and other detailed blocks keep their own colour inside the green preview so you can still see them; when it does not fit, everything turns red. Clearing instructions (for example from a cellar) are shown as small markers instead of full cubes.

Controls while positioning

An overlay on the right side of the screen shows the current key bindings while a blueprint is being positioned.

Key	Action
Enter	Place
R / F	Rotate +90° / −90°
Page Up / Page Down	Raise / lower
X	Cancel

All keys can be rebound in Minecraft's Controls settings; the overlay always shows the key that is actually bound.

Alternatives:

• Right-click places, crouch + right-click cancels.
• /eb blueprint rotate [degrees] rotates (default 90), /eb blueprint shift <dy> moves it up or down.
• /eb blueprint confirm places, /eb blueprint cancel cancels.

Only placing writes the blueprint into your plan. Until then walking around costs nothing and can be corrected as often as you like.

Undo

/eb blueprint undo

removes the blueprint you placed last from the current plan again.

Cellars and slopes: carve

The optional last parameter carve (default on) additionally clears everything inside the blueprint's bounding box that the blueprint does not fill itself. Without it, the terrain of a hillside would poke through the floor of a house planned on flat ground, and a cellar would keep the dirt it was meant to replace. Clearing instructions from the original plan always travel with the blueprint.

Use /eb blueprint load <name> false to place without carving.

Limits

A blueprint may contain at most maxBlueprintBlocks positions (default 100,000). Larger blueprints are rejected before anything is positioned.

See also

• Litematica and WorldEdit – import and export .litematic and .schem files.