Add rental time-left placeholder

Author: AlexanderTrysMine

realty-api/src/main/java/io/github/md5sha256/realty/api/DurationFormatter.java

@@ -1,8 +1,10 @@
 package io.github.md5sha256.realty.api;
 
 import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
 
 import java.time.Duration;
+import java.time.LocalDateTime;
 
 public final class DurationFormatter {
 
@@ -57,4 +59,27 @@ private DurationFormatter() {}
         }
         return sb.toString();
     }
+
+    /**
+     * Formats the remaining time until the given end date.
+     *
+     * <p>Returns {@code "N/A"} when no end date exists and {@code "Expired"}
+     * when the end date has already passed.</p>
+     */
+    public static @NotNull String formatTimeLeft(@Nullable LocalDateTime endDate) {
+        return formatTimeLeft(endDate, LocalDateTime.now());
+    }
+
+    static @NotNull String formatTimeLeft(@Nullable LocalDateTime endDate, @NotNull LocalDateTime now) {
+        if (endDate == null) {
+            return "N/A";
+        }
+
+        Duration remaining = Duration.between(now, endDate);
+        if (remaining.isZero() || remaining.isNegative()) {
+            return "Expired";
+        }
+
+        return format(remaining);
+    }
 }

realty-common/src/main/java/io/github/md5sha256/realty/database/RealtyApiImpl.java

@@ -839,6 +839,7 @@ public int deleteRegion(@NotNull String worldGuardRegionId, @NotNull UUID worldI
             placeholders.put("duration", DurationFormatter.format(Duration.ofSeconds(lease.durationSeconds())));
             placeholders.put("start_date", lease.startDate() != null ? dateFormatter.apply(lease.startDate()) : "N/A");
             placeholders.put("end_date", lease.endDate() != null ? dateFormatter.apply(lease.endDate()) : "N/A");
+            placeholders.put("time_left", DurationFormatter.formatTimeLeft(lease.endDate()));
             if (lease.maxExtensions() != null) {
                 placeholders.put("extensions", lease.currentMaxExtensions() + "/" + lease.maxExtensions());
             } else {

realty-common/src/test/java/io/github/md5sha256/realty/api/DurationFormatterTest.java

@@ -0,0 +1,37 @@
+package io.github.md5sha256.realty.api;
+
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+import java.time.LocalDateTime;
+
+class DurationFormatterTest {
+
+    @Test
+    @DisplayName("formatTimeLeft returns N/A when no end date exists")
+    void noEndDate() {
+        String result = DurationFormatter.formatTimeLeft(null, LocalDateTime.of(2026, 3, 25, 1, 0, 0));
+        Assertions.assertEquals("N/A", result);
+    }
+
+    @Test
+    @DisplayName("formatTimeLeft returns Expired when end date has passed")
+    void expired() {
+        String result = DurationFormatter.formatTimeLeft(
+                LocalDateTime.of(2026, 3, 25, 1, 0, 0),
+                LocalDateTime.of(2026, 3, 25, 1, 0, 1)
+        );
+        Assertions.assertEquals("Expired", result);
+    }
+
+    @Test
+    @DisplayName("formatTimeLeft formats remaining time using the standard duration formatter")
+    void remainingTime() {
+        String result = DurationFormatter.formatTimeLeft(
+                LocalDateTime.of(2026, 3, 27, 4, 30, 15),
+                LocalDateTime.of(2026, 3, 25, 1, 0, 0)
+        );
+        Assertions.assertEquals("2d 3h 30m 15s", result);
+    }
+}

realty-paper/src/main/java/io/github/md5sha256/realty/command/InfoCommand.java

@@ -182,6 +182,7 @@ private void appendLeaseholdInfo(@NotNull TextComponent.Builder builder,
                         Placeholder.unparsed("end_date", leasehold.endDate() != null
                                 ? DateFormatter.format(settings.get(), leasehold.endDate())
                                 : "N/A"),
+                        Placeholder.unparsed("time_left", DurationFormatter.formatTimeLeft(leasehold.endDate())),
                         Placeholder.unparsed("extensions", extensions)));
     }
 

realty-paper/src/main/resources/messages.yml

@@ -118,6 +118,7 @@ info:
     - "Duration: <duration>"
     - "Start Date: <start_date>"
     - "End Date: <end_date>"
+    - "Time Left: <time_left>"
     - "Extensions: <extensions>"
   auction-active: "<#00aaff>►</#00aaff> Active Auction: <yellow><has_auction></yellow>"
   error: "Failed to retrieve region info: <error>"

realty-paper/src/main/resources/profiles.yml

@@ -62,7 +62,7 @@
 #         - "<dark_red><bold>[Leased]"
 #         - "<region>"
 #         - "<tenant>"
-#         - "<end_date>"
+#         - "<time_left>"
 #       left-click-commands:
 #         - "realty info <region>"
 # grouped: