RavinMaddHatter / Structura

This is a project to make a sort of analog to litematica for bedrock
MIT License
251 stars 43 forks source link

Structura

[Github All Releases]()

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.

Intro to Structura video

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 alt text 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) alt text 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. alt text

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. alt text Next open your exported structure from earlier using browse button, or type the path in manually. alt text Enter a name for you structura pack. alt text ** if you mistakenly name two files the same it will show you the prompt below to rename it alt text If everything worked you should now have an mcpack file alt text

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. alt text 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. alt text 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) alt text

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

GitHub repo Good Issues for newbies GitHub Help Wanted issues GitHub Help Wanted PRs GitHub repo Issues

👋 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.