**Release Highlights** - Breaking API Changes 🔨 - Bug Fixes 🐛 ## API Changes > [!NOTE] >**New Version:** `3.8.1` ### <ins>Breaking Changes</ins> - Removed `IS_DEV_VERSION` field from `VersionUtils` - Changed `DisplayStorage` and `DBDisplayStorage` to abstract classes to accept Logger in constructor - May require recompilation of plugins depending on `DisplayEntityUtils` ## Bug Fixes / QOL - Corrected logic for `VersionUtils#cleanVersionString` - Fixed an `NPE` that occurred when trying to message a player after deleting groups/animations - Fixed deleting groups/animations not working as intended when using `MySQL` storage - Fixed saving/deleting animations not working as intended when using `MongoDB` storage ## What's Changed * 3.8.1 by @PZDonny in https://github.com/PZDonny/DisplayEntityUtils/pull/83 **Full Changelog**: https://github.com/PZDonny/DisplayEntityUtils/compare/3.8.0...3.8.1

**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.1...3.8.0

**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.0...3.7.1

**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 ```yml set {_activepart}'s deu y rotation to 90 degrees set {_activegroup}'s deu rotation to {_vector} set {_quaternion} to {_activepart}'s deu rotation ``` [](http://skripthub.net/docs/?addon=DisplayEntityUtils) ## 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.0...3.7.0

**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-418c-9b36-48a8c5546fb1" /> - `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** [](http://skripthub.net/docs/?addon=DisplayEntityUtils) ## 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 using their particle color - Fix `/deu group despawnat` not detecting the `-include` flag - Fixed `Text Display Part - Has Shadows` and `Text Display Part - Visible Through Blocks` syntax not working as expect when negated - Fixed an issue where animations using a camera could not be converted ## What's Changed * 3.6.0 by @PZDonny in https://github.com/PZDonny/DisplayEntityUtils/pull/77 **Full Changelog**: https://github.com/PZDonny/DisplayEntityUtils/compare/3.5.6...3.6.0

**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.5...3.5.6

**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.4...3.5.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.3...3.5.4

**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.2...3.5.3

**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` [](http://skripthub.net/docs/?addon=DisplayEntityUtils) ## 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.1...3.5.2