Purge region files for soft-deleted islands

build.gradle.kts

@@ -46,7 +46,7 @@ paperweight.reobfArtifactConfiguration = io.papermc.paperweight.userdev.ReobfArt
 group = "world.bentobox" // From <groupId>
 
 // Base properties from <properties>
-val buildVersion = "3.14.1"
+val buildVersion = "3.15.0"
 val buildNumberDefault = "-LOCAL" // Local build identifier
 val snapshotSuffix = "-SNAPSHOT"  // Indicates development/snapshot version
 

src/main/java/world/bentobox/bentobox/BentoBox.java

@@ -32,7 +32,9 @@
 import world.bentobox.bentobox.managers.FlagsManager;
 import world.bentobox.bentobox.managers.HooksManager;
 import world.bentobox.bentobox.managers.ChunkPregenManager;
+import world.bentobox.bentobox.managers.HousekeepingManager;
 import world.bentobox.bentobox.managers.IslandDeletionManager;
+import world.bentobox.bentobox.managers.PurgeRegionsService;
 import world.bentobox.bentobox.managers.IslandWorldManager;
 import world.bentobox.bentobox.managers.IslandsManager;
 import world.bentobox.bentobox.managers.LocalesManager;
@@ -72,6 +74,8 @@ public class BentoBox extends JavaPlugin implements Listener {
     private MapManager mapManager;
     private IslandDeletionManager islandDeletionManager;
     private ChunkPregenManager chunkPregenManager;
+    private PurgeRegionsService purgeRegionsService;
+    private HousekeepingManager housekeepingManager;
     private WebManager webManager;
 
     // Settings
@@ -143,6 +147,9 @@ public void onEnable(){
         }
         islandsManager = new IslandsManager(this);
 
+        // Shared purge-regions logic (command + housekeeping)
+        purgeRegionsService = new PurgeRegionsService(this);
+
         // Start head getter
         headGetter = new HeadGetter(this);
 
@@ -233,6 +240,10 @@ private void completeSetup(long loadTime) {
 
         webManager = new WebManager(this);
 
+        // Housekeeping: auto-purge of unused region files (default OFF)
+        housekeepingManager = new HousekeepingManager(this);
+        housekeepingManager.start();
+
         final long enableTime = System.currentTimeMillis() - enableStart;
 
         // Show banner
@@ -308,6 +319,15 @@ public void onDisable() {
         if (chunkPregenManager != null) {
             chunkPregenManager.shutdown();
         }
+        // Flush deferred island deletions from the deleted-sweep purge.
+        // Paper's internal chunk cache is cleared on shutdown, so the stale
+        // in-memory chunks are guaranteed gone at this point.
+        if (purgeRegionsService != null) {
+            purgeRegionsService.flushPendingDeletions();
+        }
+        if (housekeepingManager != null) {
+            housekeepingManager.stop();
+        }
 
     }
 
@@ -560,12 +580,29 @@ public IslandDeletionManager getIslandDeletionManager() {
 
     /**
      * @return the chunkPregenManager
-     * @since 3.14.0
+     * @since 3.15.0
      */
     public ChunkPregenManager getChunkPregenManager() {
         return chunkPregenManager;
     }
 
+    /**
+     * @return the shared {@link PurgeRegionsService} used by the purge
+     *         regions command and the housekeeping scheduler.
+     * @since 3.15.0
+     */
+    public PurgeRegionsService getPurgeRegionsService() {
+        return purgeRegionsService;
+    }
+
+    /**
+     * @return the {@link HousekeepingManager}, or {@code null} if not yet initialized.
+     * @since 3.15.0
+     */
+    public HousekeepingManager getHousekeepingManager() {
+        return housekeepingManager;
+    }
+
     /**
      * @return an optional of the Bstats instance
      * @since 1.1