Updated GitHub repository. Plugin is now compiled using Java 21. Added 1.20.6 support. Rewritten the plugin VersionCheckerUtils system. Minor change to PlayerPreConnectionEvent. Changed plugin version to 1.4.9.

Added Javadocs to ALL ClansLiteAPI events. Changed API version to `1.4.9`.

Author: Loving11ish

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>me.loving11ish</groupId>
     <artifactId>ClansLite-API</artifactId>
-    <version>1.4.8</version>
+    <version>1.4.9</version>
     <packaging>jar</packaging>
 
     <name>ClansLite-API</name>
@@ -15,7 +15,7 @@
     <url>https://www.spigotmc.org/resources/clanslite.97163/</url>
 
     <properties>
-        <java.version>11</java.version>
+        <java.version>21</java.version>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     </properties>
 

src/main/java/me/loving11ish/clans/api/ClansLiteAPI.java

@@ -15,8 +15,8 @@
 /**
  * This is the main API class for ClansLite.
  * This class contains all the methods that can be used to interact with the plugin.
- * This class must be initialized in order to use any of the methods.
  */
+@SuppressWarnings("unused")
 public interface ClansLiteAPI {
 
     /**

src/main/java/me/loving11ish/clans/api/events/AsyncChestBreakEvent.java

@@ -4,6 +4,7 @@
 import org.bukkit.block.Block;
 import org.bukkit.event.Event;
 import org.bukkit.event.HandlerList;
+import org.jetbrains.annotations.NotNull;
 
 public class AsyncChestBreakEvent extends Event {
 
@@ -13,6 +14,15 @@ public class AsyncChestBreakEvent extends Event {
     private final String owningClanOwnerUUID;
     private final String owningClanName;
 
+    /**
+     * Constructor for the AsyncChestBreakEvent
+     *
+     * @param isAsync is the event async (always true when triggered by ClansLite)
+     * @param chestLocation location of the chest
+     * @param block block of the chest
+     * @param owningClanOwnerUUID owner of the clan
+     * @param owningClanName name of the clan
+     */
     public AsyncChestBreakEvent(boolean isAsync, Location chestLocation, Block block, String owningClanOwnerUUID, String owningClanName) {
         super(isAsync);
         this.chestLocation = chestLocation;
@@ -21,23 +31,43 @@ public AsyncChestBreakEvent(boolean isAsync, Location chestLocation, Block block
         this.owningClanName = owningClanName;
     }
 
+    /**
+     * Get the handlers for the event
+     * @return the handlers
+     */
     @Override
-    public HandlerList getHandlers() {
+    public @NotNull HandlerList getHandlers() {
         return HANDLERS;
     }
 
+    /**
+     * Get the location of the chest
+     * @return the chest location
+     */
     public Location getChestLocation() {
         return chestLocation;
     }
 
+    /**
+     * Get the block of the chest
+     * @return the block
+     */
     public Block getBlock() {
         return block;
     }
 
+    /**
+     * Get the owner of the clan
+     * @return the owner of the clan(UUID as a string)
+     */
     public String getOwningClanOwnerUUID() {
         return owningClanOwnerUUID;
     }
 
+    /**
+     * Get the name of the clan
+     * @return the name of the clan
+     */
     public String getOwningClanName() {
         return owningClanName;
     }

src/main/java/me/loving11ish/clans/api/events/AsyncChestBuyEvent.java

@@ -4,6 +4,7 @@
 import org.bukkit.entity.Player;
 import org.bukkit.event.Event;
 import org.bukkit.event.HandlerList;
+import org.jetbrains.annotations.NotNull;
 
 public class AsyncChestBuyEvent extends Event {
 
@@ -13,6 +14,15 @@ public class AsyncChestBuyEvent extends Event {
     private final int oldClanMaxAllowedChests;
     private final int newChestCount;
 
+    /**
+     * Constructor for the AsyncChestBuyEvent
+     *
+     * @param isAsync if the event is async (always true when triggered by ClansLite)
+     * @param createdBy the player who created the event
+     * @param owningClan the clan that is buying the chest
+     * @param oldClanMaxAllowedChests the old max allowed chests for the clan
+     * @param newChestCount the new chest count for the clan
+     */
     public AsyncChestBuyEvent(boolean isAsync, Player createdBy, Clan owningClan, int oldClanMaxAllowedChests, int newChestCount) {
         super(isAsync);
         this.createdBy = createdBy;
@@ -21,23 +31,39 @@ public AsyncChestBuyEvent(boolean isAsync, Player createdBy, Clan owningClan, in
         this.newChestCount = newChestCount;
     }
 
+    /**
+     * Get the handlers for the event
+     * @return the handlers
+     */
     @Override
-    public HandlerList getHandlers() {
+    public @NotNull HandlerList getHandlers() {
         return HANDLERS;
     }
 
     public Player getCreatedBy() {
         return createdBy;
     }
 
+    /**
+     * Get the clan that is buying the chest
+     * @return the clan
+     */
     public Clan getOwningClan() {
         return owningClan;
     }
 
+    /**
+     * Get the old max allowed chests for the clan
+     * @return the old max allowed chests
+     */
     public int getOldClanMaxAllowedChests() {
         return oldClanMaxAllowedChests;
     }
 
+    /**
+     * Get the new chest count for the clan
+     * @return the new chest count
+     */
     public int getNewChestCount() {
         return newChestCount;
     }

src/main/java/me/loving11ish/clans/api/events/AsyncChestLockEvent.java

@@ -6,6 +6,7 @@
 import org.bukkit.entity.Player;
 import org.bukkit.event.Event;
 import org.bukkit.event.HandlerList;
+import org.jetbrains.annotations.NotNull;
 
 public class AsyncChestLockEvent extends Event {
 
@@ -15,6 +16,15 @@ public class AsyncChestLockEvent extends Event {
     private final ClanChest chest;
     private final Location chestLocation;
 
+    /**
+     * Constructor for the AsyncChestLockEvent
+     *
+     * @param isAsync is the event async (always true when triggered by ClansLite)
+     * @param createdBy player who created the event
+     * @param owningClan clan that owns the chest
+     * @param chest the chest
+     * @param chestLocation location of the chest
+     */
     public AsyncChestLockEvent(boolean isAsync, Player createdBy, Clan owningClan, ClanChest chest, Location chestLocation) {
         super(isAsync);
         this.createdBy = createdBy;
@@ -23,23 +33,43 @@ public AsyncChestLockEvent(boolean isAsync, Player createdBy, Clan owningClan, C
         this.chestLocation = chestLocation;
     }
 
+    /**
+     * Get the handlers for the event
+     * @return the handlers
+     */
     @Override
-    public HandlerList getHandlers() {
+    public @NotNull HandlerList getHandlers() {
         return HANDLERS;
     }
 
+    /**
+     * Get the player who created the event
+     * @return the player
+     */
     public Player getCreatedBy() {
         return createdBy;
     }
 
+    /**
+     * Get the clan that owns the chest
+     * @return the clan
+     */
     public Clan getOwningClan() {
         return owningClan;
     }
 
+    /**
+     * Get the chest object
+     * @return the chest
+     */
     public ClanChest getChest() {
         return chest;
     }
 
+    /**
+     * Get the location of the chest
+     * @return the chest location
+     */
     public Location getChestLocation() {
         return chestLocation;
     }

src/main/java/me/loving11ish/clans/api/events/AsyncChestUnlockEvent.java

@@ -4,28 +4,48 @@
 import org.bukkit.entity.Player;
 import org.bukkit.event.Event;
 import org.bukkit.event.HandlerList;
+import org.jetbrains.annotations.NotNull;
 
 public class AsyncChestUnlockEvent extends Event {
 
     private static final HandlerList HANDLERS = new HandlerList();
     private final Player createdBy;
     private final Location removedLockLocation;
 
+    /**
+     * Constructor for the AsyncChestUnlockEvent
+     *
+     * @param isAsync is the event async (always true when triggered by ClansLite)
+     * @param createdBy player who created the event
+     * @param removedLockLocation location of the chest
+     */
     public AsyncChestUnlockEvent(boolean isAsync, Player createdBy, Location removedLockLocation) {
         super(isAsync);
         this.createdBy = createdBy;
         this.removedLockLocation = removedLockLocation;
     }
 
+    /**
+     * Get the handlers for the event
+     * @return the handlers
+     */
     @Override
-    public HandlerList getHandlers() {
+    public @NotNull HandlerList getHandlers() {
         return HANDLERS;
     }
 
+    /**
+     * Get the player who created the event
+     * @return the player
+     */
     public Player getCreatedBy() {
         return createdBy;
     }
 
+    /**
+     * Get the location of the unlocked chest
+     * @return the chest location
+     */
     public Location getRemovedLockLocation() {
         return removedLockLocation;
     }

src/main/java/me/loving11ish/clans/api/events/AsyncClanAllyAddEvent.java

@@ -4,6 +4,7 @@
 import org.bukkit.entity.Player;
 import org.bukkit.event.Event;
 import org.bukkit.event.HandlerList;
+import org.jetbrains.annotations.NotNull;
 
 public class AsyncClanAllyAddEvent extends Event {
 
@@ -13,6 +14,15 @@ public class AsyncClanAllyAddEvent extends Event {
     private final Player allyClanCreatedBy;
     private final Clan allyClan;
 
+    /**
+     * Constructor for the AsyncClanAllyAddEvent
+     *
+     * @param isAsync is the event async (always true when triggered by ClansLite)
+     * @param createdBy player who created the event
+     * @param clan clan that is adding an ally
+     * @param allyClanCreatedBy player who created the ally clan
+     * @param allyClan clan that is being added as an ally
+     */
     public AsyncClanAllyAddEvent(boolean isAsync, Player createdBy, Clan clan, Player allyClanCreatedBy, Clan allyClan) {
         super(isAsync);
         this.createdBy = createdBy;
@@ -21,28 +31,44 @@ public AsyncClanAllyAddEvent(boolean isAsync, Player createdBy, Clan clan, Playe
         this.allyClan = allyClan;
     }
 
+    /**
+     * Get the handlers for the event
+     * @return the handlers
+     */
     @Override
-    public HandlerList getHandlers() {
+    public @NotNull HandlerList getHandlers() {
         return HANDLERS;
     }
 
+    /**
+     * Get the player who created the event
+     * @return the player
+     */
     public Player getCreatedBy() {
         return createdBy;
     }
 
+    /**
+     * Get the clan that is adding an ally
+     * @return the clan
+     */
     public Clan getClan() {
         return clan;
     }
 
+    /**
+     * Get the player who created the ally clan
+     * @return the player
+     */
     public Player getAllyClanCreatedBy() {
         return allyClanCreatedBy;
     }
 
+    /**
+     * Get the clan that is being added as an ally
+     * @return the clan
+     */
     public Clan getAllyClan() {
         return allyClan;
     }
-
-    public static HandlerList getHandlerList() {
-        return HANDLERS;
-    }
 }