DisplayEntityUtils

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

  • Translate on axis and planes
  • Rotate along axis
  • Scale
  • Uses a Gizmo Wand for control
  • Appears after making an entity seleciton

Command Changes

New Commands

• 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

Changed Commands

• /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

New Syntax

• 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

Changed Syntax

• 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

Additions/Changes

• 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

Breaking Changes

• 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