Added ProtocolLib Support + updated readme

Author: BuddySirJava

README.md

@@ -12,6 +12,7 @@
 </div>
 
 Mint ships **29** lightweight, vanilla-friendly gameplay modules. Each one can be toggled per-player, integrates with common protection plugins, supports multiple storage backends, and requires no client mods.
+We are talking Diamond Doors, Vertical Slabs, Mixed slabs and Colored ItemFrames. Make sure you checkout [Building Modules](docs/building.md)!
 
 ## Features
 
@@ -32,10 +33,9 @@ Mint ships 29 lightweight modules grouped by category:
 2. Drop it into your `plugins/` folder and restart.
 3. Configure settings via `plugins/Mint/config.yml`.
 
-**Requirements:** Paper 1.21.4+ Java 21+. (Folia support is currently **Experimental**)
-
-**Optional integrations:** PlaceholderAPI, WorldGuard, GriefPrevention, Towny, and BentoBox (soft-dependencies).
+**Requirements:** Paper/Folia 1.21.4+ Java 21+.
 
+**Soft Dependencies** PlaceholderAPI, WorldGuard, GriefPrevention, Towny, ProtocolLib and BentoBox
 ## Commands & Permissions
 
 | Command | Description | Permission |
@@ -73,7 +73,7 @@ mvn clean package
 ```
 ## License & Credits
 
-Licensed under [AGPL-3.0](LICENSE). Inspired by the [Quark mod](https://quarkmod.net/) by Vazkii.
+Licensed under [AGPL-3.0](LICENSE). Inspired by the [Quark mod](https://quarkmod.net/) by Vazkii and [V-Tweaks](https://mods.oitsjustjose.com/V-Tweaks/) by oitsjustjose.
 
 ## Support & Contributions
 

pom.xml

@@ -116,6 +116,12 @@
             <version>2.11.5</version>
             <scope>provided</scope>
         </dependency>
+        <dependency>
+            <groupId>net.dmulloy2</groupId>
+            <artifactId>ProtocolLib</artifactId>
+            <version>5.4.0</version>
+            <scope>provided</scope>
+        </dependency>
         <dependency>
             <groupId>org.mariadb.jdbc</groupId>
             <artifactId>mariadb-java-client</artifactId>

src/main/java/ir/buddy/mint/MintPlugin.java

@@ -3,6 +3,7 @@
 import ir.buddy.mint.command.MintCommand;
 import ir.buddy.mint.config.PluginConfigValidator;
 import ir.buddy.mint.gui.ModuleToggleGui;
+import ir.buddy.mint.util.DisplayBackendManager;
 import ir.buddy.mint.util.DisplayEntityController;
 import ir.buddy.mint.util.MintJdbcLibraryLoader;
 import ir.buddy.mint.util.MintLang;
@@ -37,6 +38,7 @@ public final class MintPlugin extends JavaPlugin {
     private FileConfiguration langConfig;
     private MintLang mintLang;
     private DisplayEntityController displayEntityController;
+    private DisplayBackendManager displayBackendManager;
     private URLClassLoader runtimeLibrariesClassLoader;
     private final Object runtimeLibrariesLock = new Object();
     private volatile boolean bstatsHooked;
@@ -61,6 +63,8 @@ private void completeMintStartup() {
         this.protectionSupport = new ProtectionSupport();
         this.displayEntityController = new DisplayEntityController(this);
         this.displayEntityController.register();
+        this.displayBackendManager = new DisplayBackendManager(this);
+        this.displayBackendManager.initializeOrReload();
         this.moduleManager = new ModuleManager(this);
         this.moduleManager.registerModules();
         PluginConfigValidator.validateAndLog(this, moduleManager);
@@ -118,6 +122,7 @@ public void onDisable() {
             playerModulePreferences.close();
             playerModulePreferences = null;
         }
+        displayBackendManager = null;
         displayEntityController = null;
         resetRuntimeLibrariesClassLoader();
         getLogger().info("Mint disabled.");
@@ -146,6 +151,10 @@ public void reloadPlugin() {
             } else {
                 displayEntityController.reload();
             }
+            if (displayBackendManager == null) {
+                displayBackendManager = new DisplayBackendManager(this);
+            }
+            displayBackendManager.initializeOrReload();
             playerModulePreferences.preloadToggles(Bukkit.getOnlinePlayers(), moduleManager.getModules());
             PluginConfigValidator.validateAndLog(this, moduleManager);
             moduleManager.refreshActiveModules();
@@ -218,6 +227,10 @@ public DisplayEntityController getDisplayEntityController() {
         return displayEntityController;
     }
 
+    public DisplayBackendManager getDisplayBackendManager() {
+        return displayBackendManager;
+    }
+
 
 
 

src/main/java/ir/buddy/mint/module/impl/building/BlockDecorationModule.java

@@ -672,11 +672,8 @@ private void spawnPart(Block block, Material material, String locKey,
             float pad,
             @Nullable String decorationPart) {
         Location spawnLoc = block.getLocation();
-        if (!plugin.getDisplayEntityController().canSpawn(spawnLoc, getConfigPath())) {
-            return;
-        }
         Display.Brightness brightness = sampleBrightness(block);
-        block.getWorld().spawn(spawnLoc, BlockDisplay.class, display -> {
+        plugin.getDisplayBackendManager().backend().spawnBlockDisplay(spawnLoc, getConfigPath(), display -> {
             display.setBlock(material.createBlockData());
             display.setTransformation(new Transformation(
                     new Vector3f(tx - pad, ty - pad, tz - pad),
@@ -691,7 +688,6 @@ private void spawnPart(Block block, Material material, String locKey,
             if (decorationPart != null) {
                 pdc.set(decorationPartKey, PersistentDataType.STRING, decorationPart);
             }
-            plugin.getDisplayEntityController().markManaged(display, getConfigPath());
             display.setPersistent(true);
             display.setGravity(false);
         });

src/main/java/ir/buddy/mint/module/impl/building/CarpetGeometryModule.java

@@ -378,7 +378,7 @@ private void spawnPart(Block block, Material material, int variant, String locKe
         float transformedSz = sz * frame.xzScale();
         float transformedTy = frame.yTop() + (ty - DEFAULT_PATTERN_TOP);
 
-        block.getWorld().spawn(spawnLoc, BlockDisplay.class, display -> {
+        plugin.getDisplayBackendManager().backend().spawnBlockDisplay(spawnLoc, getConfigPath(), display -> {
             display.setBlock(material.createBlockData());
             display.setTransformation(new Transformation(
                     new Vector3f(transformedTx - HALF_PAD, transformedTy - HALF_PAD, transformedTz - HALF_PAD),
@@ -876,12 +876,11 @@ public void onBlockPlace(BlockPlaceEvent event) {
    public void onBlockBreak(BlockBreakEvent event) {
        if (!plugin.isEnabled()) return;
 
-       if (!ModuleAccess.isEnabledForPlayer(plugin, this, event.getPlayer())) {
-           return;
-       }
-
-       boolean shouldDrop = event.isDropItems() && event.getPlayer().getGameMode() != GameMode.CREATIVE;
-        if (handlePatternBreak(event.getBlock(), shouldDrop)) {
+       boolean moduleEnabledForPlayer = ModuleAccess.isEnabledForPlayer(plugin, this, event.getPlayer());
+       boolean shouldDropCustomItem = moduleEnabledForPlayer
+               && event.isDropItems()
+               && event.getPlayer().getGameMode() != GameMode.CREATIVE;
+        if (handlePatternBreak(event.getBlock(), shouldDropCustomItem) && shouldDropCustomItem) {
             event.setDropItems(false);
         }
     }

src/main/java/ir/buddy/mint/module/impl/building/DyeableItemFramesModule.java

@@ -213,11 +213,7 @@ private ItemDisplay spawnDisplay(ItemFrame frame) {
         Vector facing = frame.getFacing().getDirection();
         Location displayLocation = location.clone().add(facing.clone().multiply(DISPLAY_OFFSET));
         displayLocation.setDirection(facing);
-        if (!plugin.getDisplayEntityController().canSpawn(displayLocation, getConfigPath())) {
-            return null;
-        }
-
-        ItemDisplay display = frame.getWorld().spawn(displayLocation, ItemDisplay.class, d -> {
+        ItemDisplay display = plugin.getDisplayBackendManager().backend().spawnItemDisplay(displayLocation, getConfigPath(), d -> {
             d.setPersistent(false);
             d.setInvulnerable(true);
             d.setGravity(false);
@@ -232,8 +228,10 @@ private ItemDisplay spawnDisplay(ItemFrame frame) {
             PersistentDataContainer displayPdc = d.getPersistentDataContainer();
             displayPdc.set(displayMarkerKey, PersistentDataType.BYTE, (byte) 1);
             displayPdc.set(displayFrameUuidKey, PersistentDataType.STRING, frame.getUniqueId().toString());
-            plugin.getDisplayEntityController().markManaged(d, getConfigPath());
         });
+        if (display == null) {
+            return null;
+        }
 
         frame.getPersistentDataContainer().set(frameDisplayUuidKey, PersistentDataType.STRING, display.getUniqueId().toString());
         return display;

src/main/java/ir/buddy/mint/module/impl/building/MixedSlabModule.java

@@ -310,10 +310,16 @@ public void onPlayerQuit(PlayerQuitEvent event) {
     @EventHandler(priority = EventPriority.HIGHEST, ignoreCancelled = true)
     public void onBlockBreak(BlockBreakEvent event) {
         Player player = event.getPlayer();
-        if (!ModuleAccess.isEnabledForPlayer(plugin, this, player)) return;
+        boolean moduleEnabledForPlayer = ModuleAccess.isEnabledForPlayer(plugin, this, player);
         MiningContext ctx = activeMining.remove(player.getUniqueId());
 
         Block block = event.getBlock();
+        if (!moduleEnabledForPlayer) {
+            if (block.getType() == Material.BARRIER && isMixedSlabAt(block)) {
+                cleanupMixedSlab(block, false);
+            }
+            return;
+        }
         if (!ModuleAccess.canBuild(plugin, player, block.getLocation())) return;
 
 

src/main/java/ir/buddy/mint/module/impl/building/ReacharoundPlacementModule.java

@@ -551,11 +551,23 @@ private boolean isValid(World world) {
 
         private void remove() {
             for (BlockDisplay edge : edges) {
-                if (edge != null && !edge.isDead()) {
+                safeRemoveEdge(edge);
+            }
+            currentTarget = null;
+        }
+
+        private void safeRemoveEdge(BlockDisplay edge) {
+            if (edge == null || edge.isDead()) {
+                return;
+            }
+            try {
+                FoliaScheduler.runEntity(plugin, edge, edge::remove);
+            } catch (Throwable ignored) {
+                try {
                     edge.remove();
+                } catch (Throwable ignoredAgain) {
                 }
             }
-            currentTarget = null;
         }
 
         private void hide() {

src/main/java/ir/buddy/mint/module/impl/building/SignItemsModule.java

@@ -139,11 +139,7 @@ private boolean spawnDisplayOnSign(Block block, TileState tileState, PersistentD
         if (loc == null) {
             return false;
         }
-        if (!plugin.getDisplayEntityController().canSpawn(loc, getConfigPath())) {
-            return false;
-        }
-
-        ItemDisplay display = block.getWorld().spawn(loc, ItemDisplay.class, d -> {
+        ItemDisplay display = plugin.getDisplayBackendManager().backend().spawnItemDisplay(loc, getConfigPath(), d -> {
             d.setPersistent(true);
             d.setInvulnerable(true);
             d.setGravity(false);
@@ -158,8 +154,10 @@ private boolean spawnDisplayOnSign(Block block, TileState tileState, PersistentD
             ));
 
             d.getPersistentDataContainer().set(itemMarkerKey, PersistentDataType.BYTE, (byte) 1);
-            plugin.getDisplayEntityController().markManaged(d, getConfigPath());
         });
+        if (display == null) {
+            return false;
+        }
 
         pdc.set(displayUuidKey, PersistentDataType.STRING, display.getUniqueId().toString());
         tileState.update();

src/main/java/ir/buddy/mint/util/BukkitDisplayBackend.java

@@ -0,0 +1,49 @@
+package ir.buddy.mint.util;
+
+import ir.buddy.mint.MintPlugin;
+import org.bukkit.Location;
+import org.bukkit.entity.BlockDisplay;
+import org.bukkit.entity.ItemDisplay;
+
+import java.util.function.Consumer;
+
+public final class BukkitDisplayBackend implements DisplayBackend {
+
+    private final MintPlugin plugin;
+
+    public BukkitDisplayBackend(MintPlugin plugin) {
+        this.plugin = plugin;
+    }
+
+    @Override
+    public String name() {
+        return "bukkit";
+    }
+
+    @Override
+    public boolean isProtocolLibBacked() {
+        return false;
+    }
+
+    @Override
+    public BlockDisplay spawnBlockDisplay(Location location, String source, Consumer<BlockDisplay> initializer) {
+        if (!plugin.getDisplayEntityController().canSpawn(location, source)) {
+            return null;
+        }
+        return location.getWorld().spawn(location, BlockDisplay.class, display -> {
+            initializer.accept(display);
+            plugin.getDisplayEntityController().markManaged(display, source);
+        });
+    }
+
+    @Override
+    public ItemDisplay spawnItemDisplay(Location location, String source, Consumer<ItemDisplay> initializer) {
+        if (!plugin.getDisplayEntityController().canSpawn(location, source)) {
+            return null;
+        }
+        return location.getWorld().spawn(location, ItemDisplay.class, display -> {
+            initializer.accept(display);
+            plugin.getDisplayEntityController().markManaged(display, source);
+        });
+    }
+}