Address code review feedback: Add Javadoc tags, improve Folia detection, and add Mermaid diagram

Co-authored-by: TheMeinerLP <[email protected]>

Author: Copilot

SERVICE_ARCHITECTURE.md

@@ -6,6 +6,7 @@ This document explains the Service Layer Architecture implemented for the `Redst
 
 The architecture follows the Service Layer pattern with abstraction to allow multiple implementations:
 
+### Text-based Diagram
 ```
 ┌─────────────────────────────────────────────────────────┐
 │                   Client Code                           │
@@ -31,6 +32,31 @@ The architecture follows the Service Layer pattern with abstraction to allow mul
 └─────────────────────────────────────────────────────────┘
 ```
 
+### Mermaid Diagram
+```mermaid
+graph TD
+    A[Client Code<br/>Plugin, Listeners, Commands] --> B[Service Interface<br/>RedstoneClockService]
+    B --> C[Service Factory<br/>RedstoneClockServiceFactory]
+    C --> D[Platform Detection<br/>isFolia()]
+    D --> E[BukkitRedstoneClockService<br/>Standard Bukkit Implementation]
+    D --> F[FoliaRedstoneClockService<br/>Region-aware Implementation]
+    
+    style A fill:#e1f5fe
+    style B fill:#f3e5f5
+    style C fill:#fff3e0
+    style D fill:#fce4ec
+    style E fill:#e8f5e8
+    style F fill:#fff8e1
+    
+    classDef interfaceBox fill:#f3e5f5,stroke:#9c27b0,stroke-width:2px
+    classDef factoryBox fill:#fff3e0,stroke:#ff9800,stroke-width:2px
+    classDef implBox fill:#e8f5e8,stroke:#4caf50,stroke-width:2px
+    
+    class B interfaceBox
+    class C,D factoryBox
+    class E,F implBox
+```
+
 ## Components
 
 ### 1. Service Interface

src/main/java/net/onelitefeather/antiredstoneclockremastered/service/api/RedstoneClockService.java

@@ -12,6 +12,10 @@
 /**
  * Service interface for managing redstone clock detection and handling.
  * This abstraction allows for different implementations (e.g., Bukkit, Folia).
+ *
+ * @author OneLiteFeather
+ * @version 1.0.0
+ * @since 1.0.0
  */
 public interface RedstoneClockService {
 

src/main/java/net/onelitefeather/antiredstoneclockremastered/service/factory/RedstoneClockServiceFactory.java

@@ -4,11 +4,16 @@
 import net.onelitefeather.antiredstoneclockremastered.service.api.RedstoneClockService;
 import net.onelitefeather.antiredstoneclockremastered.service.impl.BukkitRedstoneClockService;
 // import net.onelitefeather.antiredstoneclockremastered.service.impl.FoliaRedstoneClockService;
+import io.papermc.paper.ServerBuildInfo;
 import org.jetbrains.annotations.NotNull;
 
 /**
  * Factory for creating RedstoneClockService implementations.
  * This factory determines the appropriate implementation based on the server platform.
+ *
+ * @author OneLiteFeather
+ * @version 1.0.0
+ * @since 1.0.0
  */
 public final class RedstoneClockServiceFactory {
 
@@ -37,14 +42,22 @@ public static RedstoneClockService createService(@NotNull AntiRedstoneClockRemas
 
     /**
      * Detects if the server is running on Folia.
-     * This method can be extended in the future to detect Folia and return a FoliaRedstoneClockService.
+     * Folia support is available starting from Paper version 1.20 and above.
      *
      * @return true if Folia is detected, false otherwise
      */
     private static boolean isFolia() {
         try {
-            Class.forName("io.papermc.paper.threadedregions.RegionizedServer");
-            return true;
+            ServerBuildInfo buildInfo = ServerBuildInfo.buildInfo();
+            String version = buildInfo.minecraftVersionId();
+            
+            // Check if running Paper 1.20+ which supports Folia
+            if (version.startsWith("1.20") || version.startsWith("1.21") || version.startsWith("1.22")) {
+                // Additional check for Folia-specific classes
+                Class.forName("io.papermc.paper.threadedregions.RegionizedServer");
+                return true;
+            }
+            return false;
         } catch (ClassNotFoundException e) {
             return false;
         }

src/main/java/net/onelitefeather/antiredstoneclockremastered/service/impl/BukkitRedstoneClockService.java

@@ -26,6 +26,10 @@
 /**
  * Bukkit/Paper implementation of the RedstoneClockService.
  * This implementation uses the standard Bukkit scheduler and APIs.
+ *
+ * @author OneLiteFeather
+ * @version 1.0.0
+ * @since 1.0.0
  */
 public final class BukkitRedstoneClockService implements RedstoneClockService {