README.md

Structura

English丨简体中文

This tool is inspired by Litematica. It is a tool that generates Resource packs from .mcstructure files. In this resource pack the armor stands were modified to render when off screen, and have all the blocks from your structure file as bones in their model. then "ghost blocks" are used to show the user where to place the real blocks.

Generating an .mcstructure file

First you must get a structure block, as this is typically done from a creative copy with cheats enabled, simply execute /give @s structure_block to get a structure block Next configure the structure using the GUI, selecte every block you wish to have in your armor stand. Note the largest size suported by a single structure block is 64x64x64 (without editing your worlds NBT data) Next click the export button at the bottom to produce a save prompt, this will allow you to save the structure to a file. Name it whatever you want and not the location, you will need it later.

Converting a structure into a .mcpack file

First you will need to download the current release of Structura. Extract the zip file, and launch executable. once it is launched you should see something like the image below. Next open your exported structure from earlier using browse button, or type the path in manually. Enter a name for you structura pack. ** if you mistakenly name two files the same it will show you the prompt below to rename it If everything worked you should now have an mcpack file

Using the pack

This pack is like any texture pack. To use it you must make sure it is active, enabling it in your global resources works well. The structure will appear around every armor stand in the worlds you load. It is how we are able to make it work on any world. So get out an armor stand and place it down to see your structure. You can go through a structure layer by layer if you like by shift right clicking on the stand. This will minimize all layers except the "active" ones. I cannot add poses without adding a behavior pack so for large structures there will be mutiple layers displayed at a time (12 blocks apart)

Linux

To start, you definitely need to install the python3-tk package.

Choose the method that suits you:

Debian/Ubuntu:

sudo apt-get install python3.7-tk

Fedora:

sudo dnf install python3-tkinter

Arch:

yay -S python37 # yay or any other AUR component

To run Structure, allow start.sh run and run:

chmod +x start.sh && sh start.sh

Updating blocks

As of structura 1.3 you can update the blocks manuall and contribut back to the project. Here is a write up on how this works

Contributing

👋 Welcome, new contributors!

Whether you're a seasoned developer or just getting started, your contributions are valuable to us. Don't hesitate to jump in, explore the project, and make an impact. To start contributing, please check out our Contribution Guidelines.