Add plan data extensions for tags

Author: md5sha256

realty-backend-api/src/main/java/io/github/md5sha256/realty/api/RealtyBackend.java

@@ -559,6 +559,16 @@ record ExpiredLeasehold(
 
     double averageLeaseholdPrice();
 
+    // --- Region Tags ---
+
+    @NotNull List<String> getAllTagIds();
+
+    @NotNull List<String> getTagIdsByRegion(@NotNull String worldGuardRegionId);
+
+    @NotNull List<String> getRegionIdsByTag(@NotNull String tagId);
+
+    int countRegionsByTag(@NotNull String tagId);
+
     // --- History Search ---
 
     record HistoryResult(@NotNull List<HistoryEntry> entries, int totalCount) {}

realty-backend/src/main/java/io/github/md5sha256/realty/database/RealtyBackendImpl.java

@@ -1658,4 +1658,32 @@ public double averageLeaseholdPrice() {
         }
     }
 
+    @Override
+    public @NotNull List<String> getAllTagIds() {
+        try (SqlSessionWrapper wrapper = database.openSession()) {
+            return wrapper.regionTagMapper().selectDistinctTagIds();
+        }
+    }
+
+    @Override
+    public @NotNull List<String> getTagIdsByRegion(@NotNull String worldGuardRegionId) {
+        try (SqlSessionWrapper wrapper = database.openSession()) {
+            return wrapper.regionTagMapper().selectTagIdsByRegionId(worldGuardRegionId);
+        }
+    }
+
+    @Override
+    public @NotNull List<String> getRegionIdsByTag(@NotNull String tagId) {
+        try (SqlSessionWrapper wrapper = database.openSession()) {
+            return wrapper.regionTagMapper().selectRegionIdsByTagId(tagId);
+        }
+    }
+
+    @Override
+    public int countRegionsByTag(@NotNull String tagId) {
+        try (SqlSessionWrapper wrapper = database.openSession()) {
+            return wrapper.regionTagMapper().countByTagId(tagId);
+        }
+    }
+
 }

realty-backend/src/main/java/io/github/md5sha256/realty/database/mapper/RegionTagMapper.java

@@ -21,4 +21,6 @@ public interface RegionTagMapper {
 
     int deleteAll();
 
+    int countByTagId(@NotNull String tagId);
+
 }

realty-backend/src/main/java/io/github/md5sha256/realty/database/maria/mapper/MariaRegionTagMapper.java

@@ -49,6 +49,7 @@ int deleteByTagAndRegion(@Param("tagId") @NotNull String tagId,
     @Select("""
             SELECT DISTINCT tagId
             FROM RegionTag
+            ORDER BY tagId ASC
             """)
     @NotNull List<String> selectDistinctTagIds();
 
@@ -70,4 +71,12 @@ int deleteByTagAndRegion(@Param("tagId") @NotNull String tagId,
             """)
     int deleteAll();
 
+    @Override
+    @Select("""
+            SELECT COUNT(*)
+            FROM RegionTag
+            WHERE tagId = #{tagId}
+            """)
+    int countByTagId(@Param("tagId") @NotNull String tagId);
+
 }

realty-paper-api/src/main/java/io/github/md5sha256/realty/api/RealtyPaperApi.java

@@ -373,4 +373,12 @@ record Error(@NotNull String message) implements RemoveSignResult {}
 
     @NotNull CompletableFuture<@NotNull Map<String, String>> getRegionPlaceholders(
             @NotNull String regionId, @NotNull UUID worldId);
+
+    // --- Region Tags ---
+
+    @NotNull CompletableFuture<@NotNull List<String>> getTagIdsByRegion(@NotNull String worldGuardRegionId);
+
+    @NotNull CompletableFuture<@NotNull List<String>> getRegionIdsByTag(@NotNull String tagId);
+
+    @NotNull CompletableFuture<Integer> countRegionsByTag(@NotNull String tagId);
 }

realty-paper-plan-extension/src/main/java/io/github/md5sha256/realty/plan/RealtyDataExtension.java

@@ -7,12 +7,16 @@
 import com.djrapitops.plan.extension.annotation.PercentageProvider;
 import com.djrapitops.plan.extension.annotation.PluginInfo;
 import com.djrapitops.plan.extension.annotation.StringProvider;
+import com.djrapitops.plan.extension.annotation.TableProvider;
 import com.djrapitops.plan.extension.FormatType;
 import com.djrapitops.plan.extension.icon.Color;
 import com.djrapitops.plan.extension.icon.Family;
+import com.djrapitops.plan.extension.icon.Icon;
+import com.djrapitops.plan.extension.table.Table;
 import io.github.md5sha256.realty.api.RealtyBackend;
 import org.jetbrains.annotations.NotNull;
 
+import java.util.List;
 import java.util.UUID;
 
 @PluginInfo(
@@ -245,4 +249,17 @@ public String playerTenantRegions(UUID playerUUID) {
     public String playerLandlordRegions(UUID playerUUID) {
         return String.join(", ", realtyApi.listRegionNamesByLandlord(playerUUID));
     }
+
+    @TableProvider(tableColor = Color.CYAN)
+    public Table serverTagRegionCounts() {
+        List<String> tagIds = realtyApi.getAllTagIds();
+        Table.Factory table = Table.builder()
+                .columnOne("Tag Name", Icon.called("tag").of(Family.SOLID).of(Color.CYAN).build())
+                .columnTwo("Num Tagged Regions", Icon.called("hashtag").of(Family.SOLID).of(Color.BLUE).build());
+        for (String tagId : tagIds) {
+            int count = realtyApi.countRegionsByTag(tagId);
+            table.addRow(tagId, count);
+        }
+        return table.build();
+    }
 }

realty-paper/src/main/java/io/github/md5sha256/realty/api/RealtyPaperApiImpl.java

@@ -1135,6 +1135,31 @@ public RealtyPaperApiImpl(@NotNull RealtyBackend realtyApi,
                 executorState.dbExec());
     }
 
+    // --- Region Tags ---
+
+    @Override
+    public @NotNull CompletableFuture<@NotNull List<String>> getTagIdsByRegion(
+            @NotNull String worldGuardRegionId) {
+        return CompletableFuture.supplyAsync(
+                () -> realtyApi.getTagIdsByRegion(worldGuardRegionId),
+                executorState.dbExec());
+    }
+
+    @Override
+    public @NotNull CompletableFuture<@NotNull List<String>> getRegionIdsByTag(
+            @NotNull String tagId) {
+        return CompletableFuture.supplyAsync(
+                () -> realtyApi.getRegionIdsByTag(tagId),
+                executorState.dbExec());
+    }
+
+    @Override
+    public @NotNull CompletableFuture<Integer> countRegionsByTag(@NotNull String tagId) {
+        return CompletableFuture.supplyAsync(
+                () -> realtyApi.countRegionsByTag(tagId),
+                executorState.dbExec());
+    }
+
     // ═══════════════════════════════════════
     // PRIVATE HELPERS
     // ═══════════════════════════════════════