Utilities

DisplayEntityUtils has two primary utility classes, DisplayUtils and PacketUtils. This wiki page only includes some of this functions from these classes.

DisplayUtils

DisplayUtils is a utility class that allows for quickly manipulating display/interaction entities

Get translated location of a Display/Interaction Entity

//Get the location where the visible model of a display entity is, with rotation (transformation's left rot, entity pitch, and entity yaw) calculations
Location translatedDisplayLocation = DisplayUtils.getModelLocation(displayEntity)

//Get the location where the visible model of a display entity is, without rotation calculations
Location fixedTranslatedDisplayLocation = DisplayUtils.getFixedModelLocation(displayEntity);

//These do the same as above but for ActiveParts
Location translatedDisplayLocation = DisplayUtils.getModelLocation(activePart)
Location fixedTranslatedDisplayLocation = DisplayUtils.getFixedModelLocation(activePart);

//Get the translation vector of a non-display entity relative to its group
//This will return null if the entity is not in a group
Vector translationVector = DisplayUtils.getNonDisplayranslation(nonDisplayEntity);

Pivot an Non-Display Entity around a location

double angleInDegrees = 45;
DisplayUtils.pivot(entity, location, angleInDegrees);

//Get the location where an interaction entity would be pivoted, without apply the pivot
DisplayUtils.getPivotLocation(entity, location, anlgeInDegrees);

Check Entity Part/Group tags

//Check if this entity has the provided part tag stored
boolean hasPartTag = DisplayUtils.hasPartTag(entity, partTag);

//Check if this entity's group has the provided group tag
boolean isGroupTag = DisplayUtils.isGroupTag(entity, groupTag);

---

PacketUtils

PacketUtils is a utility class, allowing for manipulating display/interaction entity data through packets

Make an entity glow, only for the given player

Display display;
boolean glowing = true;
PacketUtils.setGlowing(player, display.getEntityId(), glowing);

int durationInTicks = 20;
PacketUtils.setGlowing(player, display.getEntityId(), glowing, durationInTicks);

Teleport a part only for the given player

PacketDisplayEntityPart part = yourMethodToGetAPart();
PacketUtils.teleport(player, part, location);

//Using the method below would teleport the part for all players who can see the part
part.teleport(location);

Scale an Interaction entity over time for a given player

//There are many variations of this method
float newHeight = 2.0;
float newWidth = 4.0;
int durationInTicks = 15;
int delayInTicks = 0;
PacketUtils.scaleInteraction(
                player, 
                interaction, 
                newHeight, 
                newWidth, 
                durationInTicks, 
                delayInTicks
);

Translate an Interaction entity over time for a given player

//There are many variations of this method
double distance = 12;
int durationInTicks = 15;
int delayInTicks = 0;
PacketUtils.translateInteraction(
                player, 
                interaction, 
                Direction.FORWARD, 
                distance, 
                durationInTicks, 
                delayInTicks
);