Using Animations

DisplayEntityUtils can animate Display Entity Models/Groups! You can easily create animations with BDEngine and convert them to a usable format for the plugin, converting both model and animation.

Placing the Animation ZIP File

• Navigate to the DisplayEntityUtils Plugin folder and place your zipped animation file in the "bdenginedatapacks" folder.

• While in-game, find an open area large enough to fit the animated model.

  • This will not have an effect on the conversion but it does allow you to see any errors that may occur during conversion.

Start Conversion

• Run the command /mdis bdengine convertanim <datapack-file> <desired-group-tag> <desired-animation-tag-prefix>

  • The group tag can be entered as "-" if you do not wish to save the group along with the converted animation(s)

• Allow the conversion process to complete, then your animation and model will be saved in their respective folders in the DisplayEntityUtils plugin folder.
  A message will be sent in chat, with the tags of all created animations and the tag of the group, if a group was created and saved.

Converting Legacy Datapacks (Before BDEngine v1.13)

• Animations Datapacks created before BDEngine v1.13 (Dec. 8th 2024) must use the command /mdis bdengine convertanimleg instead of /mdis bdengine convertanim.

• Those datapacks are considered legacy datapacks and the <desired-animation-tag-prefix> will not be a prefix for all animations within the legacy datapack, but will be the name of the single animation created.
  

• Command Format: /mdis bdengine convertanimleg <datapack-file> <desired-group-tag> <desired-animation-tag>

• The desired group tag can be entered as a "-" if you do not wish to save a group along with the animation. This is useful if you're saving multiple animations for the same / an existing model.
  

Using Animations

Below are a few common animation commands

View Animation Commands (By Page):

• /mdis anim help [page-number]

Select Group (Sometimes necessary depending on the command):

• /mdis group spawn <group-tag> local

Select Animation:

• /mdis anim select <animation-tag> local

Save Animation (Required to apply changes to animations):

• /mdis anim save <storage-location>

Animation Information:

• /mdis anim info

Play Animation (Optionally loop and optionally use packets):

• /mdis anim play [-loop] [-packet]

  Optionally play using packets in v3.3.4+

Stop Animation:

• /mdis anim stop

Toggle Scale Respect (Respect Group's Scale Multiplier):

• /mdis anim togglescalerespect

Toggle Texture Changes (Player Head Texture Change, Block/Item Display Type, Text Display Text)

• /mdis anim toggledatachanges