📐 Build Faster with Blueprints!

Tired of manually building the same structures over and over, like roads, street lamps, or houses? This mod is perfect for you! Scan your structure and create a blueprint so you can rebuild it instantly with just one click!

Video Full Showcase & Features

🏗️ Main Features

🔹 Scanner – Scan any structure to save it as a blueprint.

Right-click a block to set the first corner.
Right-click another block to set the second corner.
Once the area is selected, give it a name and save the structure.

🔹 Tablet – Easily manage your blueprints.

View your saved structures.
Delete blueprints you no longer need.
Obtain the blueprint item to place it in the world.
Share your blueprints with other players in the same world.
Export and import global blueprints to use them across different worlds.
Access server-provided blueprints.

🔹 Blueprint – Build your saved structures effortlessly!

Select the origin point by clicking on a block.
A holographic preview will show exactly how the structure will be placed.
Open the menu (Shift + Right-click in the air) to:
✅ Check the required materials.
🔄 Rotate or mirror the structure along the X, Y, and Z axes.
📦 Assign containers (Shift + Right-click the container, like: chests, shulker boxes, barrels, etc.) to store materials, allowing you to build large structures without inventory limitations!

⚙️ Customizable Limits with Gamerules

By default, the mod includes certain limits, such as the maximum number of blocks that can be selected with the scanner and the number of blueprints each player can store. However, these limits can be adjusted using gamerules:

📏 Set the maximum number of blocks in a scanned area:

From version 1.1.4 and below:

/gamerule maxStructureBlockCount <integer>

From version 1.2.0 and above:

/gamerule maxScannerBlockCount <integer>

📜 Set the maximum number of blueprints a player can have:

/gamerule maxBlueprintsForPlayer <integer>

🔧 Limit the number of containers a blueprint can use
Set the maximum number of containers (like chests or barrels) that a blueprint can interact with simultaneously during construction:

/gamerule maxBlueprintContainers <integer>

🔒 Control the use of global blueprints
Decide whether global blueprints (shared across multiple worlds) are allowed in your world:

/gamerule allowGlobalBlueprints <true/false>

📋 Enable or disable NBT data copying in blueprints (added in version 1.8.0)
Allows blueprint scans to copy the NBT data of blocks (such as block states or custom behavior).
By default, it's disabled to avoid duplication issues, especially in multiplayer servers:

/gamerule allowNBTDataCopy <true/false>

Note: This does not copy contents of blocks with inventories (like chests or backpacks).

⚠️ Note: The mod is not optimized for very large structures, so be mindful when increasing these values.

📦 Server Blueprint Management – Command System (Op only)

Manage server-wide blueprints with the /blueprintserver command.
These blueprints are shared across the entire server and can be set as either:

Free – accessible to all players without restrictions.
Permission – only players with explicit permission can use them.

🛠 How to Use:

To add or replace a server blueprint (while holding a blueprint item in hand)
```
/blueprintserver set <free/permission>
```

To remove a server blueprint:

/blueprintserver remove <server_blueprint_name>

To assign or revoke a player's permission to use a specific "permission" blueprint:
```
/blueprintserver permission <player_name> <server_blueprint_name> <true/false>
```

By default, players do not have permission unless explicitly granted.

📘 Worn Blueprint – Usage and Functionality

Worn Blueprints are blueprints with a limited number of uses, and can be used by any player without restrictions.

✅ How to add them to the world:

To register a Worn Blueprint in the world, hold a normal blueprint in your hand and use the command:

/blueprintworn add

To remove it later, use:

/blueprintworn remove <worn_blueprint_name>

🧱 Creating the Worn Blueprint Item

The Worn Blueprint item can be generated (via /give or through loot tables) using two required NBT tags:

remaining_uses: an integer that defines how many uses are left.
blueprint_name: a string linking the item to the registered worn blueprint in the world.
free_build: a boolean value (0b/1b) that allows you to build the blueprint without requiring the necessary materials.
allow_nbt (added in version 1.8.1):
- If set to 0b, it will always place without NBT data, ignoring the allowNBTDataCopy gamerule.
- If set to 1b, it will always place with NBT data, again ignoring the gamerule.
- If the flag is not present, the worn blueprint will follow the current value of the allowNBTDataCopy gamerule.

📌 Example:

minecraft version 1.20.1 and below

/give @s portable_blueprints:worn_blueprint{remaining_uses:1,blueprint_name:"worn_blueprint_name"} 1

minecraft version 1.21.1

/give @s portable_blueprints:worn_blueprint[minecraft:custom_data={remaining_uses:1,blueprint_name:"worn_blueprint_name"}] 1

(added in version 1.8.1)

Worn Blueprint World Injection System

Introduced a system to automatically inject worn blueprints into worlds.
This is especially useful for modpack creators who want to include premade worn blueprints (e.g. for a blueprint shop).
Just place your .bp files into the new folder:
<Minecraft directory>/portable_blueprints/world_injection_worn_blueprints

A settings file is also included inside this folder for optional configuration.

With this mod, building becomes faster, more efficient, and free from tedious repetition!

💬 GitHub Community & Bug Reporting

Join the community, report bugs, or suggest new features!

👉 Visit the mod’s GitHub page

Nimblonia

Nimblonia

Portable Blueprints