Anim Usage

Note

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 the 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 does not affect the conversion itself, but allows you to see any potential errors during the process.

---

Start Conversion

• Run:
  /deu bdengine convertanim <datapack-file> <desired-group-tag> <desired-animation-tag-prefix>

  Enter - for the group tag if you do not want the group saved with the converted animation(s).

• Allow the conversion to finish.
  Your animation(s) and model will be saved to their respective folders in the DisplayEntityUtils plugin directory.
  A chat message will list all created animation tags and the group tag (if a group was saved).

---

Converting Legacy Datapacks (Before BDEngine v1.13)

• Datapacks created before BDEngine v1.13 (Dec. 8th, 2024) must use:
  /deu bdengine convertanimleg
  instead of
  /deu bdengine convertanim.

• Legacy datapacks produce one animation, so <desired-animation-tag-prefix> becomes the exact tag of the single animation created.

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

• As with normal conversion, the group tag may be - if you do not wish to save a group along with the animation.
  This is useful when converting multiple animations for an already existing model.

---

Using Animations

Below are several common animation commands:

View Animation Commands (By Page):

• /deu anim help [page-number]

Select Group (Often required for animation commands):

• /deu group spawn <group-tag> local

Select Animation:

• /deu anim select <animation-tag> local

Save Animation (Required after making changes):

• /deu anim save <storage-location>

Animation Information:

• /deu anim info

Play Animation (Optionally loop & optionally use packets):

• /deu anim play [-loop] [-packet] [-camera]

  -packet available in v3.3.4+

  -camera available in 3.3.6+

• -camera allows the player to view the animation's camera, if one was created when making the BDEngine animation

Play Animation (Optionally loop & optionally use packets):

• /deu anim play [-loop] [-packet] [-camera]

  -packet available in v3.3.4+

  -camera available in 3.3.6+

• -camera allows the player to view the animation's camera, if one was created when making the BDEngine animation

Stop Animation:

• /deu anim stop

Toggle Scale Respect (Respect group's scale multiplier):

• /deu anim togglescalerespect

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

• /deu anim toggledatachanges