PZDonny · PZDonny · Oct 1, 2026 · Sep 29, 2026 · Sep 29, 2026 · Sep 29, 2026
diff --git a/api/pom.xml b/api/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>net.donnypz.displayentityutils</groupId>
         <artifactId>deu</artifactId>
-        <version>3.7.1</version>
+        <version>3.8.0</version>
     </parent>
 
     <artifactId>api</artifactId>

diff --git a/api/src/main/java/net/donnypz/displayentityutils/database/DisplayStorage.java b/api/src/main/java/net/donnypz/displayentityutils/database/DisplayStorage.java
@@ -10,6 +10,8 @@
 
 public interface DisplayStorage {
 
+    boolean isEnabled();
+
     boolean saveDisplayEntityGroup(@NotNull DisplayEntityGroup group, @Nullable Player saver);
 
     void deleteDisplayEntityGroup(@NotNull String group, @Nullable Player deleter);
@@ -24,5 +26,9 @@ public interface DisplayStorage {
 
     @NotNull List<String> getGroupTags();
 
+    @NotNull List<String> getGroupTags(int page, int size);
+
     @NotNull List<String> getAnimationTags();
+
+    @NotNull List<String> getAnimationTags(int page, int size);
 }
diff --git a/api/src/main/java/net/donnypz/displayentityutils/managers/DisplayAnimationManager.java b/api/src/main/java/net/donnypz/displayentityutils/managers/DisplayAnimationManager.java
@@ -324,17 +324,6 @@ private static void attemptCacheAnimation(String tag, SpawnedDisplayAnimation an
         }
     }
 
-
-    /**
-     * Get the animation tags of all saved {@link DisplayAnimation}s in a storage location.
-     * @param loadMethod of the search location
-     * @return a list of all animations by their group tag
-     */
-    public static @NotNull List<String> getSavedDisplayAnimations(@NotNull LoadMethod loadMethod){
-        if (!loadMethod.isEnabled()) return Collections.emptyList();
-        return DisplayAPI.getStorage(loadMethod).getAnimationTags();
-    }
-
     /**
      * Get a {@link DisplayAnimation} from a JSON string
      * @param json JSON of a saved {@link DisplayAnimation}

diff --git a/api/src/main/java/net/donnypz/displayentityutils/managers/DisplayGroupManager.java b/api/src/main/java/net/donnypz/displayentityutils/managers/DisplayGroupManager.java
@@ -738,19 +738,6 @@ private static DisplayEntityGroup getGroupFromJson(JsonObject jsonObject){
                 .fromJson(jsonObject, DisplayEntityGroup.class);
     }
 
-
-
-    /**
-     * Get the group tags of all saved {@link DisplayEntityGroup}s in a storage location.
-     * @param loadMethod of the search location
-     * @return a list of all groups by their group tag
-     */
-    @ApiStatus.Internal
-    public static @NotNull List<String> getSavedDisplayEntityGroups(@NotNull LoadMethod loadMethod) {
-        if (!loadMethod.isEnabled()) return Collections.emptyList();
-        return DisplayAPI.getStorage(loadMethod).getGroupTags();
-    }
-
     @ApiStatus.Internal
     public static void addPersistentPacketGroup(@NotNull PacketDisplayEntityGroup group, @NotNull Location location){
         if (group.isPersistent()) return;

diff --git a/api/src/main/java/net/donnypz/displayentityutils/managers/LoadMethod.java b/api/src/main/java/net/donnypz/displayentityutils/managers/LoadMethod.java
@@ -1,8 +1,11 @@
 package net.donnypz.displayentityutils.managers;
 
+import net.donnypz.displayentityutils.DisplayAPI;
 import net.donnypz.displayentityutils.DisplayConfig;
+import net.donnypz.displayentityutils.database.DisplayStorage;
 import net.donnypz.displayentityutils.utils.DisplayEntities.DisplayAnimation;
 import net.donnypz.displayentityutils.utils.DisplayEntities.DisplayEntityGroup;
+import org.jetbrains.annotations.NotNull;
 
 /**
  * Storage locations for saving, deleting, and retrieving a saved {@link DisplayEntityGroup} or {@link DisplayAnimation}
@@ -44,6 +47,10 @@ public boolean isEnabled(){
         }
     }
 
+    public @NotNull DisplayStorage getDisplayStorage(){
+        return DisplayAPI.getStorage(this);
+    }
+
     public String getDisplayName() {
         return displayName;
     }

diff --git a/api/src/main/java/net/donnypz/displayentityutils/utils/DisplayEntities/DisplayAnimation.java b/api/src/main/java/net/donnypz/displayentityutils/utils/DisplayEntities/DisplayAnimation.java
@@ -20,7 +20,7 @@ public final class DisplayAnimation implements Serializable {
 
     @Serial
     private static final long serialVersionUID = 99L;
-    public static final String fileExtension = ".deanim";
+    public static final String FILE_EXTENSION = ".deanim";
 
 
     DisplayAnimation(){

diff --git a/...rc/main/java/net/donnypz/displayentityutils/utils/DisplayEntities/DisplayEntityGroup.java b/...rc/main/java/net/donnypz/displayentityutils/utils/DisplayEntities/DisplayEntityGroup.java
@@ -26,7 +26,7 @@ public final class DisplayEntityGroup implements Serializable{
 
     @Serial
     private static final long serialVersionUID = 99L;
-    public static final String fileExtension = ".deg";
+    public static final String FILE_EXTENSION = ".deg";
 
     DisplayEntityGroup(SpawnedDisplayEntityGroup spawnedGroup){
         this.tag = spawnedGroup.getTag();

diff --git a/api/src/main/java/net/donnypz/displayentityutils/utils/DisplayUtils.java b/api/src/main/java/net/donnypz/displayentityutils/utils/DisplayUtils.java
@@ -371,6 +371,7 @@ public static boolean isInLoadedChunk(@NotNull Entity entity){
     /**
      * Get the {@link SpawnedDisplayEntityGroup} passengers, with a specific group tag, riding an entity
      * @param vehicleEntity the entity
+     * @param groupTag the group tag
      * @return a list
      */
     public static List<SpawnedDisplayEntityGroup> getGroupPassengers(@NotNull Entity vehicleEntity, @NotNull String groupTag){
@@ -839,14 +840,16 @@ public static boolean isValidTag(@NotNull String tag){
 
     /**
      * Remove a part tag from an entity
-     * @param tag the tag to remove from this part
+     * @param entity the entity to remove the tag from
+     * @param tag the tag to remove
      */
     public static void removeTag(@NotNull Entity entity, @NotNull String tag){
         removeFromPDCList(entity, tag, DisplayKeys.Part.PART_TAGS);
     }
 
     /**
      * Remove part tags from an entity
+     * @param entity the entity to remove the tag from
      * @param tags the tags to remove from this part
      */
     public static void removeTags(@NotNull Entity entity, @NotNull List<String> tags){
@@ -885,6 +888,7 @@ static void removeManyFromPDCList(@NotNull Entity entity, List<String> elements,
 
     /**
      * Gets the part tags belonging to an entity
+     * @param entity the entity
      * @return The part's part tags.
      */
     public static @NotNull List<String> getTags(@NotNull Entity entity){
@@ -902,6 +906,7 @@ static void removeManyFromPDCList(@NotNull Entity entity, List<String> elements,
 
     /**
      * Determine whether a part entity has a part tag
+     * @param entity the entity
      * @param tag the tag to check for
      * @return true if this part has the tag
      */

diff --git a/api/src/main/java/net/donnypz/displayentityutils/utils/gizmo/GizmoSession.java b/api/src/main/java/net/donnypz/displayentityutils/utils/gizmo/GizmoSession.java
@@ -36,6 +36,8 @@ public interface GizmoSession {
 
     void teleport(Vector direction);
 
+    void teleport(Location location);
+
     void deselectHide();
 
     void selectShow(Location spawnLocation);

diff --git a/docs/release-notes/3.8.0.md b/docs/release-notes/3.8.0.md
@@ -0,0 +1,47 @@
+**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
diff --git a/plugin/pom.xml b/plugin/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>net.donnypz.displayentityutils</groupId>
         <artifactId>deu</artifactId>
-        <version>3.7.1</version>
+        <version>3.8.0</version>
     </parent>
 
     <artifactId>plugin</artifactId>

diff --git a/plugin/src/main/java/net/donnypz/displayentityutils/DisplayEntityPlugin.java b/plugin/src/main/java/net/donnypz/displayentityutils/DisplayEntityPlugin.java
@@ -5,6 +5,7 @@
 import com.github.retrooper.packetevents.PacketEvents;
 import com.github.retrooper.packetevents.event.PacketListenerPriority;
 import net.donnypz.displayentityutils.command.DisplayEntityPluginCommand;
+import net.donnypz.displayentityutils.command.Permission;
 import net.donnypz.displayentityutils.database.*;
 import net.donnypz.displayentityutils.listeners.autogroup.DEULoadingListeners;
 import net.donnypz.displayentityutils.listeners.bdengine.BDEngineConversionListener;
@@ -91,6 +92,8 @@ public void onEnable() {
         else{
             getComponentLogger().warn(Component.text("bStats disabled on server using dev version."));
         }
+
+        Permission.registerPermissions();
         getServer().getConsoleSender().sendMessage(DisplayAPI.pluginPrefix.append(Component.text("Plugin Enabled!", NamedTextColor.GREEN)));
     }
 

diff --git a/plugin/src/main/java/net/donnypz/displayentityutils/command/ListCMD.java b/plugin/src/main/java/net/donnypz/displayentityutils/command/ListCMD.java
@@ -1,8 +1,7 @@
 package net.donnypz.displayentityutils.command;
 
 import net.donnypz.displayentityutils.DisplayAPI;
-import net.donnypz.displayentityutils.managers.DisplayAnimationManager;
-import net.donnypz.displayentityutils.managers.DisplayGroupManager;
+import net.donnypz.displayentityutils.database.DisplayStorage;
 import net.donnypz.displayentityutils.managers.LoadMethod;
 import net.kyori.adventure.text.Component;
 import net.kyori.adventure.text.event.ClickEvent;
@@ -19,6 +18,7 @@ public class ListCMD extends ConsoleUsableSubCommand {
     int minLength;
     private final int STORAGE_INDEX;
     private final int PAGE_NUMBER_INDEX;
+    private final int PAGE_SIZE = 6;
     boolean listsGroups;
 
     public ListCMD(Component incorrectUsageMessage, int minLength, boolean listsGroups) {
@@ -54,38 +54,37 @@ public void list(CommandSender sender, String[] args) {
                 return;
             }
 
-            List<String> tags = listsGroups ?
-                    DisplayGroupManager.getSavedDisplayEntityGroups(loadMethod)
-                    :
-                    DisplayAnimationManager.getSavedDisplayAnimations(loadMethod);
+            int pageNumber = 1;
+            if (args.length > minLength) {
+                try {
+                    pageNumber = Math.max(1, Integer.parseInt(args[PAGE_NUMBER_INDEX]));
+                } catch (NumberFormatException ignored) {
+                }
+            }
+
+            DisplayStorage storage = DisplayAPI.getStorage(loadMethod);
+
+            if (!storage.isEnabled()){
+                sender.sendMessage(DisplayAPI.pluginPrefix
+                        .append(Component.text("Storage location is not enabled!", NamedTextColor.RED)));
+                return;
+            }
+            List<String> tags = listsGroups
+                    ? storage.getGroupTags(pageNumber, PAGE_SIZE)
+                    : storage.getAnimationTags(pageNumber, PAGE_SIZE);
 
             sender.sendMessage(DisplayAPI.pluginPrefixLong);
             sender.sendMessage(MiniMessage.miniMessage().deserialize("Storage Location: <yellow>" + loadMethod.getDisplayName()));
             if (tags.isEmpty()) {
-                sender.sendMessage(Component.text("That storage location is empty!", NamedTextColor.RED));
+                sender.sendMessage(Component.text("| Nothing to list on this page.", NamedTextColor.GRAY));
                 return;
             }
 
             if (sender instanceof Player) {
                 sender.sendMessage(Component.text("Click to a listed item to " + (listsGroups ? "spawn" : "select") + " it", NamedTextColor.GRAY));
             }
 
-            int pageNumber = 1;
-            if (args.length > minLength) {
-                try {
-                    pageNumber = Math.max(1, Integer.parseInt(args[PAGE_NUMBER_INDEX]));
-                } catch (NumberFormatException ignored) {
-                }
-            }
-
-            int end = pageNumber * 6;
-            int start = end - 6;
-
-            for (int i = start; i < end; i++) {
-                if (i >= tags.size()) {
-                    break;
-                }
-                String tag = tags.get(i);
+            for (String tag : tags) {
                 sender.sendMessage(getMessage(tag, loadMethod));
             }
             sender.sendMessage(Component.text("----------" + "Page " + pageNumber + "----------", NamedTextColor.GRAY));

diff --git a/plugin/src/main/java/net/donnypz/displayentityutils/command/Permission.java b/plugin/src/main/java/net/donnypz/displayentityutils/command/Permission.java
@@ -1,5 +1,8 @@
 package net.donnypz.displayentityutils.command;
 
+import net.donnypz.displayentityutils.DisplayAPI;
+import org.bukkit.plugin.PluginManager;
+
 public enum Permission {
     HELP("deu.help"),
     RELOAD("deu.reload"),
@@ -137,6 +140,21 @@ public enum Permission {
     BDENGINE_IMPORT("deu.bdengine.import");
 
 
+    public static void registerPermissions(){
+        for (Permission permission : Permission.values()){
+            registerPermission(permission);
+        }
+    }
+
+    private static void registerPermission(Permission permission){
+        PluginManager pm = DisplayAPI.getPlugin().getServer().getPluginManager();
+        if (pm.getPermission(permission.getPermission()) == null){
+            pm.addPermission(new org.bukkit.permissions.Permission(permission.getPermission()));
+        }
+    }
+
+
+
     private final String permission;
     Permission(String permission){
         this.permission = permission;

diff --git a/plugin/src/main/java/net/donnypz/displayentityutils/command/display/DisplayCMD.java b/plugin/src/main/java/net/donnypz/displayentityutils/command/display/DisplayCMD.java
@@ -12,6 +12,7 @@ public DisplayCMD(){
         new DisplayViewRangeCMD(this);
         new DisplayBillboardCMD(this);
         new DisplayTranslateCMD(this);
+        new DisplayRoundTranslationCMD(this);
         new DisplayResetCMD(this);
         new DisplayRotateCMD(this);
         new DisplaySetRotationCMD(this);