DisplayEntityUtils

Release Highlights - Gizmo Changes - New Commands - New and Breaking API Changes - Bug Fixes

Gizmo Changes

- Snapped movements can be toggled by using SNEAK + OFFHAND - The snap value can be changed by SCROLLING (With selected axis) - A selected group / entity can be cloned by LEFT CLICKING the pivot / white cube at the center of the Gizmo - Translating in teleport mode snaps to world grid when snapping is enabled

Command Changes

<ins>New Commands</ins>

- Added /deu display roundtranslation - Remove the decimal portion of your selected display's translation. - (Ex: X translation of 12.25 would become 12.0). - Permission: deu.display.transform - Added /deu gizmo snapvalue - Set the snapping value for a selected Gizmo control - Permission: deu.gizmo.use - Added /deu gizmo toggglesnap - Toggle the snapping of gizmo control movements - Permission: deu.gizmo.use

API Changes

[!NOTE]

>New Version: 3.8.0

<ins>Additions/Changes</ins>

- Added DisplayStorage#isEnabled to see if a storage location is enabled - Add paginated #getGroupTags and #getAnimationTags to DisplayStorage - Added LoadMethod#getDisplayStorage

<ins>Breaking Changes</ins>

- Removed DisplayAnimationManager#getSavedDisplayAnimations in favor of DisplayStorage#getAnimationTags - Removed DisplayGroupManager#getSavedDisplayEntityGroups in favor of DisplayStorage#getGroupTags

Bug Fixes / QOL

- Fixed an issue where using a MongoDB database without passing a connectionString in the config generated an incorrect connection string - Added minor optimization to listing group and animation tags from a database - All plugin permissions are now correctly registered - Player movement is now stopped after selecting a Gizmo control - Fixed /deu parts clone requiring a tag to be added to a cloned part, rather than being optional

What's Changed

* 3.8.0 by @PZDonny in https://github.com/PZDonny/DisplayEntityUtils/pull/82 Full Changelog: https://github.com/PZDonny/DisplayEntityUtils/compare/3.7…

Release Highlights - Updated config - Database optimizations - Database security fixes

Config Changes

- Added additional config settings for mongodb, simplifying connections

API Changes

[!NOTE]

>New Version: 3.7.1

<ins>Breaking Changes</ins>

- Moved DisplayStorage into net.donnypz.displayentityutils.database package

Bug Fixes / QOL

- Improved queries for MongoDB storage - Implemented changes to prevent SQL injection

What's Changed

* 3.7.1 by @PZDonny in https://github.com/PZDonny/DisplayEntityUtils/pull/79 Full Changelog: https://github.com/PZDonny/DisplayEntityUtils/compare/3.7…

Release Highlights - New Rotation Commands - New Skript Syntax - New and Breaking API Changes

Command Changes

<ins>New Commands</ins>

- Added /deu group setrotation - Set a group's rotation on a given local axis - Permission: deu.group.transform - Added /deu display setrotation - Set a display's rotation on a given local axis - Permission: deu.display.transform

Skript

<ins>New Syntax</ins>

- Added Active Group/Part - Rotation - Get/Set an active group or active part's display transformation rotation

  set {_activepart}'s deu y rotation to 90 degrees
  set {_activegroup}'s deu rotation to {_vector}
  set {_quaternion} to {_activepart}'s deu rotation
  

[]…

API Changes

[!NOTE]

>New Version: 3.7.0

<ins>Additions/Changes</ins>

- Added ActiveGroup#setRotation, to change a group's transformation rotation, rather than entity pitch and yaws - Added getRotation, resetRotation, and rebaseRotation to ActiveGroup - Added Active#rotate using an Axis for rotation - Added ActivePart#setRotation to change a display part's transformation rotation

<ins>Breaking Changes</ins>

- Removed SpawnedDisplayEntityPart#getCreationTime - Changed #setRotation to #setEntityRotation in Active - Renamed PivotAxis class to Axis

QOL

- Added group rotation info to /deu group info

What's Changed

* 3.7.0 by @PZDonny in https://github.com/PZDonny/DisplayEntityUtils/pull/78 Full Changelog: https://github.com/PZDonny/DisplayEntityUtils/compare/3.6…

Release Highlights - Transformation Gizmo - New & Changed Commands - Updated and New Skript Syntax - New and Breaking API Changes - Many Bug Fixes ## General - Added support for Minecraft 26.2 - Supports new Geyser particles for animations - Updated PacketEvents to 2.13.0 - Added a Transformation Gizmo to use on Individual Entities and Groups/Models <img width="250" height="250" alt="image" src="https://github.com/user-attachments/assets/4ca268f1-bc60-…" /> - Translate on axis and planes - Rotate along axis - Scale - Uses a Gizmo Wand for control - Appears after making an entity seleciton ## Command Changes ### <ins>New Commands</ins> - Added /deu group rotate - Rotate a group around an axis in local (pitch/yaw) or world space. Optionally only pivot displays - Permission: deu.group.transform - Added /deu gizmo commands - All Gizmo commands use deu.gizmo.use permission - movehere - move the Gizmo's pivot to your location - resetpivot - reset the Gizmo's pivot to your selection's origin location - scale - change the Gizmo's scale - toggle - toggle Gizmo visibility - wand - get the wand to control a Gizmo - Add /deu parts clone - Create a clone of your selected part(s). Optionally add a tag to the cloned part(s) - Permission: deu.parts.clone - Added /deu mannequin belownamedistance - Set the distance that text below a mannequin's name can be seen. The attribute only exists on server version 26.2+ - Permission: deu.mannequin.name - Added /deu display rotate - Rotate a display entity on a given axis - Permission deu.display.transform ### <ins>Changed Commands</ins> - /deu bdengine import and /deu bdengine convertdp now accept new flags - -despawn - despawn group after creation - -adapttags - automatically adapt scoreboard tags to part tags - Added -all flag to /deu parts adapttags to convert tags of all parts in a player's selection - Added -all flag to /deu mannequin pivot - Added -world flag to /deu interaction pivot and /deu mannequin pivot, optionally pivoting in world space - Added -pivot flag to /deu group pitch - Negative numbers can now be used in translate and move commands - Changed /deu group markpacketgroups to /deu group selectpacket - Changed Permission: deu.group.select - /deu parts resetfilter can now optionally reset by filter type (blocks, item, included_tags, excluded_tags, & entity types) - Changed /deu display resettranslation to /deu display reset <translation | rotation | scale | all> - Changed Permission: deu.display.transform - Changed Permission of /deu display translate to deu.display.transform ## Skript ### <ins>New Syntax</ins> - Added Active Part - Has Part Tag to see if a part has a provided part tag - Added Valid Tag to see if a tag is valid and can use on any taggable DisplayEntityUtils object ### <ins>Changed Syntax</ins> - Added glowing option to Active Group - Spawn and BDEngine Model - Spawn from File, optionally glowing the created group when spawned - Updated Direction (Pitch, Yaw, Pivot) to support pitch pivoting - Updated Rotate/Pivot to rotate/pivot around a location. Optionally include a group or filter's non-display entities in the rotation/pivot - Changed Spawned Group Is Visible By Default? to Active Group - Is Visible By Default, working on any group type - Changed Active Group - Scale syntax wording to make support for other non-displays obvious. Cleaned up documentation for clarity []… ## API Changes

[!NOTE]

>New Version: 3.6.0 ### <ins>Additions/Changes</ins> - Similar methods in ActiveGroup and MultiPartSelection have been moved into a common ActivePartHolder superclass - Added #getLocation, #isValid, #setRotation to Active - Added #teleportSafe to ActiveGroup and ActivePart, automatically choosing to teleport sync or async - Added GroupSpawnSettings#addGlowing to set which parts should glow when spawning a group - Added PartType#isDisplay - Added #isSelectable and #setSelectable to ActiveGroup - Moved #getTeleportMoveLocations from SpawnedDisplayEntityGroup to ActiveGroup - Negative distances are now allowed in ActiveGroup#teleportMove - Add #send and #sendToUUIDs to DisplayAttributeMap - Added #rotate and #rotateAround to DisplayUtils, PacketUtils and Active - Added ActiveGroup#clone(Location, GroupSpawnSettings), to clone a group at a location with additional spawn settings - Added Active#pivotOrRotateAround, automatically deciding whether to pivot a non-display or rotate a display entity around a location - GroupScaleEvent is now called for PacketDisplayEntityGroups, being callable async - Added ActivePart#clone to create a clone of a part, automatically adding it to the original part's group if it has one. - Added #setMannequinBelowNameDistance and #getMannequinBelowNameDistance to ActivePart ### <ins>Breaking Changes</ins> - ActivePartSelection is now an interface - Renamed #pivotPitchAndYaw to #rotateVector in DisplayUtils - Removed redundant DisplayUtils#getGroupVehicle - #setPitch and #setYaw in Active now accept a boolean argument, determining if the rotational change should also pivot where applicable - Active#setRotation now accepts two booleans in its last arguments, enabling pitch and/or yaw pivot - Active#pivot now accepts a PivotAxis to decide the axis to apply the pivot, and a boolean choosing to pivot in world or local (pitch/yaw) space - Changed DisplayUtils#pivot to accept a PivotAxis and whether the pivot should apply in world or the entity's local (pitch/yaw) space - Removed internal ActiveGroup#addPlayerSelection - Removed ActivePart#rotate(Quaternion, boolean) - Changed #setAttributeAndSend to #setAndSend and #setAndSendToUUIDs in PacketAttributeContainer - Changed #setAttributesAndSend to #setAndSend and #setAndSendToUUIDs in PacketAttributeContainer - Changed #sendEntityUsingPlayers to #sendEntity in PacketAttributeContainer - Changed #sendEntityUsingUUIDs to sendEntityToUUIDs in PacketAttributeContainer - Removed #rotateDisplay from ActivePart and ActiveGroup in favor of #rotate and #rotateAround - Changed #getSelectedParts to #getParts in MultiPartSelection ## Bug Fixes / QOL - Reduced concurrency issues, primarily during animations - Prevent many NPEs - PacketDisplayEntityGroups now spawn with their correct glow color - PacketDisplayEntityGroup custom autoshow conditions now apply when initially enabling autoshow - Fixed command help pages throwing an error if there weren't enough commands to fill a help page - Fixed the last command in a command's help page always being missing - Packet-based entities now retain pitch/yaw rotation when sent to player that switches worlds - Reduce teleport jitter when frequently teleporting packet-based entities - Fix PacketUtils#setRotation pitch and yaw values being swapped - Fix packet-based groups not spawning using packet when attempting to spawn a group by searching through all storage locations - Fixed Is Fake / Packet Based syntax not correctly checking if a provided object is packet-based - Corrected #hasItemDisplayItemGlint in SpawnedDisplayEntityPart and PacketDisplayEntityPart, in turn fixing /deu item toggleglint - Fixed /deu listgroups and /deu listanims not working as expected - Item animation particles now work correctly regardless of game version - Fixed Interaction clicks not working as expected in newer game versions - Fixed Tinted Leaves animation particles not us

Release Highlights - A Bug Fix for list related commands ## Bug Fix - Fixed an issue where commands listing saved animations and groups didn't work as expected ## What's Changed * 3.5.6 by @PZDonny in https://github.com/PZDonny/DisplayEntityUtils/pull/76 Full Changelog: https://github.com/PZDonny/DisplayEntityUtils/compare/3.5…

Release Highlights - A Bug Fix for BDEngine's API ## Bug Fix - Fixed BDEngine API Project Imports not working as expected due to changes on BDEngine's end ## What's Changed * 3.5.5 by @PZDonny in https://github.com/PZDonny/DisplayEntityUtils/pull/74 * 3.5.5 by @PZDonny in https://github.com/PZDonny/DisplayEntityUtils/pull/75 Full Changelog: https://github.com/PZDonny/DisplayEntityUtils/compare/3.5…

Release Highlights - Command QOL Changes - Breaking API Changes - Bug Fixes ## Command Changes - Renamed /deu anim showpoint to /deu anim showpoints - Minimalized listings for all commands - Command pages are now less cluttered and info about it can be seen by hovering over it - Improved tab completion across all commands ## API Changes New Version: 3.5.3 ### Breaking Changes - Moved DisplayUtils#getPivotLocation into WorldUtils#getPivotLocation - Moved Interaction entity related methods from DisplayUtils into InteractionUtils ## Bug Fixes / QOL - Fixed instances where invalid tags could be added to groups, parts, animations, etc. - This primarily occurred when using Skript or the plugin's API ## What's Changed * 3.5.4 by @PZDonny in https://github.com/PZDonny/DisplayEntityUtils/pull/73 Full Changelog: https://github.com/PZDonny/DisplayEntityUtils/compare/3.5…

Release Highlights - Many New Commands - BDEngine API Project Import - API Changes - Bug Fixes Changes and help for content regarding this release can be found on the [Wiki](https://jay-12.gitbook.io/displayentityutils) ## General - Tags can no longer contain spaces in animations, groups, parts, etc. - Dropped support for legacy BDEngine datapack conversion - _This applies to datapacks created before Dec. 8th 2024_ - Added importing and conversion of BDEngine Projects directly from the website to your game - ALL Animation Frames now have a default Frame Point, located at a group's origin ## Command Changes - New Command: /deu bdengine import - Import and convert a BDEngine project's model and animations - Permission: deu.bdengine.import - New Command: /deu anim adddefaultparticle - Add particles to an animation at a frame's default point (group origin) - Permission: deu.anim.addparticle - New Command: /deu anim adddefaultsound - Add sounds to an animation at a frame's default point (group origin) - Permission: deu.anim.addsound - New Command: /deu anim showpoints - Show the Frame Points of an animation frame - Permission: deu.anim.info - New Command: /deu group spawnat - Spawn a group at a specified location - Permission deu.group.spawn - New Command: /deu group despawnat - Despawn groups within a given range of a location - Permission: deu.group.despawn - Changed /deu group clone - Added -here argument to spawn clone the group at the player's location - Added an -all argument to all commands that accept frame-ids/frame-tag - Removed Commands: - /deu bdengine convertdpleg - /deu group clonehere - /deu anim editallframes ## API Changes New Version: 3.5.3 ### Additions/Changes - Added DEUSound#fromCommand - Get a DEUSound from a playsound command - Updated #equals, #hashCode, and #clone for SpawnedDisplayAnimationFrame, DisplayTransformation and AnimationCamera - Added BDEngineUtils#convertDatapack - Converts a BDEngine datapack into group and animation formats for DEU - Uses the new BDEDatapackConvertEvent to get converted resources - Added BDEngineUtils#importProject - Imports and converts a BDEngine Project by its export ID - Uses the new BDEAPIConvertEvent to get converted resources - Added SpawnedDisplayAnimationFrame#getDefaultFramePoint - Gets the default FramePoint of an animation frame, located at the group's origin - The default point's location and tag are immutable - Added PacketDisplayEntityGroup#getNearbyGroups - Get nearby PacketDisplayEntityGroups in a given range of a location - Added #removeParticle and #removeAllParticles to FramePoint ### Breaking Changes - Removed BDEngineUtils#requestModel ## Bug Fixes / QOL - Updated version checking logic - Improved logic for BDEngine datapack conversion - Fixed issues where adding particles to an animation could fail - Fixed an issue where loading an animation's particles could fail - Changed the range and step of the delta and extra in Animation Particle creation dialogs, for more fine control - Improved tab completion of optional command arguments - Fixed a NullPointerException occuring when attempting to remove an invalid PartSelection - Sounds and Particles can now be removed from Frame Points ## What's Changed * 3.5.3 by @PZDonny in https://github.com/PZDonny/DisplayEntityUtils/pull/72 Full Changelog: https://github.com/PZDonny/DisplayEntityUtils/compare/3.5…

Release Highlights - New, Removed, & Changed Commands - Updated Skript Syntax - DisplayController Changes - API Changes - Many Bug Fixes ## General - Added support for Minecraft 26.1.2 - Added support for Skript 2.15.2 ## Command Changes - New Command: /deu group ridedespawn - Make a group ride an entity, but despawn the group if the entity dies/despawns/disconnects - Permission: deu.group.ride - New Command: /deu mannequin spawn - Spawn a mannequin entity at your location, and optionally add it to your selected group - Permission: deu.mannequin.spawn - New Command /deu interaction spawn - Spawn an interaction entity at your location, and optionally add it to your selected group - Permission: deu.interaction.spawn - Added -nodata option to /deu anim play to optionally disable texture changes for block/item displays and text display text changes - Removed /deu anim toggletexturechanges - Removed /deu interaction addtogroup - Removed /deu interaction spawnhere ## Display Controller - Added group.allowAnimationDataChanges to determine an animation played on a group should be able to change non-transformation data - Added animationDataChangesOverride boolean (true/false) to animation states, optionally overriding the group.allowAnimationDataChanges value. (Example: states.death.animationDataChanges: true) - Updated MythicMobs Skill Mechanic: - - deuanimate{id=controller-id;anim=animation-tag;t=animation-type;s=storage-location,datachanges=true} ## Skript - Display & Interaction entities can now be used in Skript syntax that previously only allowed parts. - _For getting/setting properties of the entity_ - Removed Toggle Animation Texture Changes syntax - Updated Create Display Animator - set {_animator} to a linear animator using {_animation} without data changes []… ## Bug Fixes / QOL - Fixed an issue causing DisplayController animation states to not work correctly - Fixed an issue causing rideOffset for DisplayControllers to not work correctly - Included a group's Ride Offset in auto culling calculations - Packet-based group passengers are correctly unregistered when the group should despawn after the vehicle becomes invalid - Fixed vehicle / group passenger(s) desync when changing worlds - Fixed an issue causing players to be unable to teleport when they have a group passenger - Internally changed how group parts are registered, reducing inconsistencies in some cases - Fixed an issue where non-packet based parts were not being registered correctly - Duplicate items no longer appear across pages in /deu listgroups, /deu listanims, /deu group list, or /deu anim list commands - Invulnerable mannequins in groups no longer take damage from players in creative mode - Fixed BDEngine Datapack conversion sometimes not working in the_end or the_nether ## API Changes - Added #setBlockReplacement and #setItemReplacement to GroupSpawnSettings to replace blocks/items of a given type when spawning a group - Added new constructors to DisplayAnimator with a Boolean parameter allowDataChanges to determine if a block/item textures and text display text should changed based on animation frame data. - Removed SpawnedDisplayAnimation#allowTextureChanges methods ## What's Changed * 3.5.2 by @PZDonny in https://github.com/PZDonny/DisplayEntityUtils/pull/71 Full Changelog: https://github.com/PZDonny/DisplayEntityUtils/compare/3.5…

#### Previous pre-releases on Discord Release Highlights - Command Changes - Updated Skript Syntax - API Changes - Bug Fixes ## General - Added support for Minecraft 26.1.2 - Added support for Skript 2.15.2 ## Command Changes - New Command: /deu group ridedespawn - Make a group ride an entity, but despawn the group if the entity dies/despawns/disconnects - Permission: deu.group.ride - Added -nodata option to /deu anim play to optionally disable texture changes for block/item displays and text display text changes - Removed /deu anim toggletexturechanges ## Display Controller - Added group.allowAnimationDataChanges to determine an animation played on a group should be able to change non-transformation data - Added animationDataChangesOverride boolean (true/false) to animation states, optionally overriding the group.allowAnimationDataChanges value. (Example: states.death.animationDataChanges: true) - Updated MythicMobs Skill Mechanic: - - deuanimate{id=controller-id;anim=animation-tag;t=animation-type;s=storage-location,datachanges=true} ## Skript - Display & Interaction entities can now be used in Skript syntax that previously only allowed parts. - _For getting/setting properties of the entity_ - Removed Toggle Animation Texture Changes syntax - Updated Create Display Animator - set {_animator} to a linear animator using {_animation} without data changes ## Bug Fixes - Fixed an issue causing DisplayController animation states to not work correctly - Fixed an issue causing rideOffset for DisplayControllers to not work correctly - Included a group's Ride Offset in auto culling calculations - Packet-based group passengers are correctly unregistered when the group should despawn after vehicle invalidity - Fixed vehicle/passenger desync when changing worlds - Fixed an issue causing players to be unable to teleport when they have a group passenger - Internally changed how group parts are registered, reducing inconsistencies in some cases - Fixed an issue where non-packet based parts were not being registered correctly ## API Changes - Added #setBlockReplacement and #setItemReplacement to GroupSpawnSettings to replace blocks/items of a given type when spawning a group - Added new constructors to DisplayAnimator with a Boolean parameter allowDataChanges to determine if a block/item textures and text display text should changed based on animation frame data. - Removed SpawnedDisplayAnimation#allowTextureChanges methods ## What's Changed * 3.5.1 by @PZDonny in https://github.com/PZDonny/DisplayEntityUtils/pull/69 * 3.5.1 | bump version number by @PZDonny in https://github.com/PZDonny/DisplayEntityUtils/pull/70 Full Changelog: https://github.com/PZDonny/DisplayEntityUtils/compare/3.5…

Release Highlights - New Wiki - New Command - Reworked & Recoded Skript Syntax - API Changes A new [Wiki](https://jay-12.gitbook.io/displayentityutils) has been released improving clarity in many areas and a better visual look ## Commands ### New Command - Added /deu parts deselect - Deselect your currently selected part - Permission: deu.parts.select ## Skript Changes - Updated to Skript v2.14.3 - Reworked many of the syntaxes, avoiding conflicts, reducing redundancy, and overall improving syntax []… ## API Changes New Version: `3.5.0` ### Breaking Changes - Removed playSpawnAnimation parameter from DisplayEntityGroup#createPacketGroup methods - DisplayGroupManager#getOrCreateNearbySpawnedGroups now returns a set of SpawnedDisplayEntityGroups instead of GroupResults ### Additions / Changes - Added ActivePart#getItemDisplayTransform - Added ActivePart#getInterpolationDelay and ActivePart#getInterpolationDuration - Added methods to ActivePart - #getItemDisplayTransform - #getInterpolationDuration - #getInterpolationDelay - #getBillboard - Added GroupSpawnSettings#playSpawnAnimation - DisplayUtils#getFixedModelLocation now accepts an ActivePart rather than just a PacketDisplayEntityPart ## QOL - Fixed incorrect messages when using commands or clicking clickable points ## What's Changed * 3.5.0 by @PZDonny in https://github.com/PZDonny/DisplayEntityUtils/pull/68 Full Changelog: https://github.com/PZDonny/DisplayEntityUtils/compare/3.4…