BDStudioLoader - Import 3D Display Models

This plugin allows you to import 3D Display models created using BDStudio, a 3D-modelling suite to manipulate Display Entities created by Eszes Bálint. It does not allow you to edit the models. This plugin is simply a more convenient alternative to the command export offered by BDStudio.

Features:
- Save .bdstudio files created using BDStudio into the plugin's model directory and import them in game
- Grid free placement, as well as grid bound placement with step size beginning at 1/16th of a block
- Pick up placed models
- Delete placed models
- Show model information

Placing a model
To place a model, you first need to have the model in the plugin's model directory (plugins/BDStudioLoader/models). The plugin ships with three models that you can use or modify at your hearts desire:

• Grandfather Clock
• Piano
• Computer

You can test out how the plugin works with these models. To load one of these models, use /bdload, optionally followed by the model name. Using the model name explicitly directly loads the model, omitting it opens a book GUI where you can click on the desired model. Make sure to look at a block to start placing the model!

Once you selected the model to load, you have to place it. It will be previewed (visible to everyone!) at the location your crosshair is looking at. You can rotate the model (one degree increments/decrements) by scrolling in your hotbar. When you're happy with the models location, left click to place the model.

If you want a grid to be more precise with the placement, sneak and scroll 'right' (in the hotbar) to activate and increment the grid size. The grid size is shown in a scoreboard on the right alongside the models name and location, just check the image below.
Moving a model
To move a model, you need a special item, the BDStudioWand. This item can be obtained by using the /bdwand command, followed by no arguments. If you have space in your inventory, a special echo shard will be given to you. To use it, place it in your hotbar and select it (currently, you need to scroll on it to work). This will enter the search mode. When looking at a model's anchor point, it will light up in blue ( everyone can see the glow). The anchor point depends on the model and the way it was created, for example the included clock has its anchor point at the bottom left corner:
To pick up the model once it is lit up, just right click with the BDStudioWand and place the model like described earlier.

Deleting a model
Similar to moving a model, to delete one, you also need the BDStudioWand obtained with /bdwand. With the item selected (again, if it doesn't work, scroll over it in your hotbar), press F (or "swap item with off hand") to toggle deletion mode. Similar to moving a model, you must look at its anchor point to delete it. When the model lights up in red, just right click to delete it, as shown below:

Shortcuts
To quickly select and load a model, sneak + right click with the BDStudioWand to open the selection menu.

Anchor Point
The anchor point of a model is the gray box at the origin in BDStudio, as seen in the center of the image below:

Permissions
bdstudioloader.command.bdload
Access to the /bdload command and all models placed in the plugins model directory.

bdstudioloader.command.bdwand
Access to the /bdwand command and its usage.


Notes
This plugin goes great with ArmorStandAdjustor! Bring your scenes to life by placing some fancy armorstands in some fancy poses!

Limitations (as of Nov. 11th 2023)
The plugin currently does not support TextDisplays placed in BDStudio as they are currently not working as intended.
Sometimes, some blocks (such as buttons) can appear in different places in BDStudio and show up different in game. There is nothing I can do about this. If you try the command export, the same thing will happen. I DID NOT CREATE BDSTUDIO, I just created this plugin.
Currently, there is no configuration file. None of the texts are (at this time) adjustable.