Building Blueprint

# Building Blueprint

Building Blueprint lets players save buildings as blueprint items, preview them in the world, rotate the preview, and place the saved structure later.

## Features

- Save a selected building area as a blueprint
- Choose a preset blueprint style: House, Bridge, Tower, or Farm
- Set a custom level number for the blueprint
- Optionally save entities inside the selected area
- Preserve block entity data, such as chest contents
- Preview the saved building before placement
- Rotate the previewed building
- Place the building by sneaking and right-clicking
- Manage saved blueprint entries from an in-game library screen

## Creative Tab

The mod adds a new creative tab named `Building Blueprints`.

It contains:

- Blueprint Tool
- Empty blueprint sample
- Saved building blueprints

An empty sample blueprint does not contain a saved building. It is mainly intended for creative use, testing, or modpack integration.

## Saving A Building

1. Hold the `Blueprint Tool`.
2. Right-click the first corner of the building area.
3. Right-click the second corner of the building area.
4. Sneak and right-click any block to open the save screen.
5. Choose a blueprint style.
6. Enter a level number.
7. Choose whether entities should be saved.
8. Click `Save`.

After saving, the player receives a usable building blueprint item.

If a blueprint with the same style and level already exists, saving again will overwrite the previous saved blueprint data.

## Using A Blueprint

1. Hold a blueprint that contains saved building data.
2. Right-click a block to show the building preview.
3. Right-click again to rotate the previewed building.
4. Right-clicking air also rotates the preview while it is active.
5. Sneak and right-click to place the building.

Blueprints are consumable. A blueprint disappears after successfully placing its building.

Switching to another item cancels the current preview.

## Blueprint Library

Default key: `B`

Press `B` to open the blueprint library screen.

The library shows saved blueprint entries and allows players to delete entries they no longer need.

Deleting an entry removes the saved building data file. It does not remove blueprint items that are already in player inventories.

## Styles And Levels

Built-in styles:

- House
- Bridge
- Tower
- Farm

The level number is chosen when saving a blueprint. It is rendered on the item icon.

Only one saved entry is kept for each style and level combination, so the creative tab will not fill up with duplicate level 1 blueprints.

## Modpack Integration

The mod does not include built-in survival recipes.

Modpack authors are expected to add acquisition methods with tools such as:

- KubeJS
- CraftTweaker
- Data packs
- Quest rewards
- Shops
- Loot tables

Recommended integration ideas:

- Add a recipe for the Blueprint Tool
- Add recipes or quest rewards for empty blueprint samples
- Use shops, NPCs, or loot containers to distribute specific blueprint styles and levels

This keeps the mod flexible for different modpack economies and progression systems.

## Saved Data Location

Saved building data is stored in:

`config/building_blueprint/blueprints/`

Each saved blueprint entry corresponds to one `.nbt` file.

Deleting an entry from the blueprint library deletes the matching `.nbt` file.

## Notes

- Make sure the target area is clear before placing a large building.
- Entity data is only saved when the save-entities option is enabled.
- If the saved `.nbt` file is missing, the blueprint item cannot place its building.
- Manual editing of blueprint `.nbt` files is not recommended unless you know exactly what you are changing.