Metadata-Version: 2.4
Name: mcmultiblocks
Version: 0.1.2
Summary: Multiblocks library
Author: ShelfHead, TheBlackSwitch
License-Expression: GPL-3.0-or-later
Project-URL: Homepage, https://github.com/KobeMotmans/Multiblocks
Project-URL: Issues, https://github.com/KobeMotmans/Multiblocks/issues
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.14
Description-Content-Type: text/markdown
Requires-Dist: nbtlib>=1.12
Requires-Dist: beet>=0.113.0

![The banner](https://github.com/KobeMotmans/Multiblocks/blob/dev/docs/images/logo_banner.png)

![GitHub License](https://img.shields.io/github/license/KobeMotmans/multiblocks?color=blue)
![GitHub Repo stars](https://img.shields.io/github/stars/KobeMotmans/multiblocks?style=flat&logo=github) ![](https://img.shields.io/badge/install-$pip%20install%20mcmultiblocks-65a34e) ![PyPI - Version](https://img.shields.io/pypi/v/mcmultiblocks) 

## Introduction

Multiblocks is a plugin for the [beet](https://mcbeet.dev/) toolchain. It provides a very user friendly and easy way to create multiblock blueprints with a focus on versatility and performance.

Take a look at [our documentation](https://github.com/KobeMotmans/Multiblocks/wiki)

## Features

### Create multiblock blueprints with ease
You only need a single json file and a structure .nbt file inorder to generate your full fledged multiblock blueprint

![A showcase of how the library is used](https://github.com/KobeMotmans/Multiblocks/blob/dev/docs/images/usage_showcase.png)

### Automatic placement detection
The library marks any blocks that are incorrectly placed. Red for a wrong block, Orange for a wrong blockstate and purple if the block should be air.

![Showcase: placement detection](https://github.com/KobeMotmans/Multiblocks/blob/dev/docs/images/placement%20detection.png)

### Outlines
You can easily show an outline for your multiblock so you can visualize the structure without much visual lag.

![](https://github.com/KobeMotmans/Multiblocks/blob/dev/docs/images/outline_showcase.png)

### Full rotation / mirroring
The library handles full rotation and mirroring of the multiblock. Even the blockstates will change appropriately.

### Extreme versatility
The library offers many different optimized ways to implement and interact with your multiblock structure.

The library provides an extensive function set that allows you to grab any data from your multiblock anytime and configure behaviour however you want.
![](https://github.com/KobeMotmans/Multiblocks/blob/dev/docs/images/function_list.png)

It's also equipped with an event based system through callbacks provided in the json file. This makes it a lot easier to run any functionality once the multiblock is completed.

### Additional conditions

In the json file you can also specify any additional conditions that need to be true inorder for the multiblock to complete. That way you can easily implement custom block detection.
