Skip to content

ASaull/Minecraft-Block-Display-Exporter

Repository files navigation

Minecraft Block Display Exporter Blender Add-on

About

This is a Blender add-on for generating vanilla Minecraft block display commands.

Test Dummy In Blender Test Dummy In Minecraft
mcbde_1 mcbde_2

Installation

Download this repository as a zip file and install it in Blender as an add-on

Usage

Once the add-on has been installed, you can find the MCBDE panel in the 3D view sidebar.

Since we cannot legally bundle the Minecraft textures and models, you must link the add-on to a Minecraft jar file in your Minecraft installation directory. By default in Windows, this is located at

C:\Users\<YOUR_USERNAME>\AppData\Roaming\.minecraft\versions\1.X.X\1.X.X.jar
howto_annotated_3 howto_annotated_4

Once this is done, the data can be loaded with the "Load Data" button, and the rest of the UI will appear.

howto_annotated_5

Now, with any mesh object(s) selected (it doesn't matter what mesh the object has, it will be overwritten!), you can select a Minecraft block from the "Type" dropdown. At this point, the mesh will change, but the texture will not show until you switch the viewport shading to "Material Preview".

howto_annotated_6 howto_annotated_7

Now, for blocks that have properties, these can be changed with the dropdown menus. As you manipulate blocks, you can scale, rotate, and transform them as you usually would in Blender, but do not enter Edit Mode to change the mesh manually as this will not be preserved when generating the Minecraft command.

howto_annotated_8 howto_annotated_9

Once you are happy with your model, you can generate the command by clicking on the "Generate Command" button, Note that the command block which will run the command is considered to have its north west corner at the Blender origin, and is positioned as indicated in the screenshot.

howto_annotated_10

Once you copy the command from the textbox in Blender, you can open Minecraft and place a command block and a button where you want the entity to be placed. Simply paste the command into the command block, press the button, and the entity will be generated. Delete the command block and you're finished!

howto_annotated_11 howto_annotated_12
howto_annotated_13 howto_annotated_14

Once the entity has been created, you can delete it with the command

/kill @e[type=minecraft:block_display, distance=..3]

which will delete all block display entities in a 3 block range. If you want more discretion, I highly recommend the Axiom mod.

Axiom: https://modrinth.com/mod/axiom

TODO

  • Support cross-shaped plants
  • Support removing model entirely, with empty type
  • Create user-visible error messages for file-loading errors
  • Allow the user to only input their .minecraft directory, and just choose the latest version of Minecraft automatically
  • Account for texture uv rotation (anvil, command block)
  • Give colour to grayscale blocks (leaves, stems)
  • Create a bed model since they are hardcoded into the game. (why??) So are conduits...
  • Support textures that determine UVs automatically (composter)
  • Create a dedicated release zip file

Future Goals

  • Support modded blocks/items
  • Support resource packs

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages